@openclaw/matrix 2026.5.26 → 2026.5.27-beta.1

package/dist/api.js

@@ -2,10 +2,10 @@ import { d as setMatrixThreadBindingIdleTimeoutBySessionKey, n as getMatrixThrea
 import { a as resolveMatrixDefaultOrOnlyAccountId, i as resolveMatrixChannelConfig, n as requiresExplicitMatrixDefaultAccount, r as resolveConfiguredMatrixAccountIds, t as findMatrixAccountEntry } from "./account-selection-C3arLOhC.js";
 import { n as listMatrixEnvAccountIds, r as resolveMatrixEnvAccountToken, t as getMatrixScopedEnvVarNames } from "./env-vars-KzaYveuy.js";
 import { a as resolveMatrixCredentialsPath, c as resolveMatrixLegacyFlatStoreRoot, i as resolveMatrixCredentialsFilename, l as sanitizeMatrixPathSegment, n as resolveMatrixAccountStorageRoot, o as resolveMatrixHomeserverKey, r as resolveMatrixCredentialsDir, s as resolveMatrixLegacyFlatStoragePaths, t as hashMatrixAccessToken } from "./storage-paths-BV2Z7bns.js";
-import { n as matrixSetupAdapter, t as createMatrixSetupWizardProxy } from "./setup-core-DiRWksVZ.js";
-import { t as matrixPlugin } from "./channel-Q-9mXTAf.js";
-import { n as matrixOnboardingAdapter } from "./setup-surface-DD5dKWcB.js";
-import { t as createMatrixThreadBindingManager } from "./thread-bindings-DpAW-FD_.js";
+import { n as matrixSetupAdapter, t as createMatrixSetupWizardProxy } from "./setup-core-s8s_Qudu.js";
+import { t as matrixPlugin } from "./channel-BLuA_9If.js";
+import { n as matrixOnboardingAdapter } from "./setup-surface-BOt10HNf.js";
+import { t as createMatrixThreadBindingManager } from "./thread-bindings-CLjJrThw.js";
 //#region extensions/matrix/api.ts
 const matrixSessionBindingAdapterChannels = ["matrix"];
 //#endregion

package/dist/{approval-handler.runtime-R9NDTUte.js → approval-handler.runtime-D2nZfRw6.js}

@@ -1,11 +1,11 @@
 import { a as resolveMatrixTargetIdentity } from "./target-ids-B-5aQxwn.js";
-import { g as resolveMatrixAccount } from "./setup-core-DiRWksVZ.js";
-import { _ as shouldHandleMatrixApprovalRequest, g as isMatrixAnyApprovalClientEnabled } from "./channel-Q-9mXTAf.js";
-import { a as sendMessageMatrix, i as reactMatrixMessage, p as repairMatrixDirectRooms, s as sendSingleTextMessageMatrix } from "./send-DiYHONuz.js";
+import { g as resolveMatrixAccount } from "./setup-core-s8s_Qudu.js";
+import { _ as shouldHandleMatrixApprovalRequest, g as isMatrixAnyApprovalClientEnabled } from "./channel-BLuA_9If.js";
+import { a as sendMessageMatrix, i as reactMatrixMessage, p as repairMatrixDirectRooms, s as sendSingleTextMessageMatrix } from "./send-DivaFHb1.js";
 import { a as unregisterMatrixApprovalReactionTarget, n as listMatrixApprovalReactionBindings, r as registerMatrixApprovalReactionTarget, t as buildMatrixApprovalReactionHint } from "./approval-reactions-BRGQgOu2.js";
-import { n as editMatrixMessage, t as deleteMatrixMessage } from "./messages-D_zHS_2K.js";
+import { n as editMatrixMessage, t as deleteMatrixMessage } from "./messages-D-VxmWkC.js";
 import { normalizeUniqueStringEntries } from "openclaw/plugin-sdk/string-coerce-runtime";
-import { listMessageReceiptPlatformIds, resolveMessageReceiptPrimaryId } from "openclaw/plugin-sdk/channel-message";
+import { listMessageReceiptPlatformIds, resolveMessageReceiptPrimaryId } from "openclaw/plugin-sdk/channel-outbound";
 import { buildChannelApprovalNativeTargetKey } from "openclaw/plugin-sdk/approval-native-runtime";
 import { setTimeout } from "node:timers/promises";
 import { createChannelApprovalNativeRuntimeAdapter } from "openclaw/plugin-sdk/approval-handler-runtime";
@@ -96,7 +96,8 @@ function buildMatrixApprovalMetadata(params) {
 		metadata: params.view.metadata,
 		allowedDecisions: Array.from(params.allowedDecisions),
 		actions: params.view.actions.map((action) => ({
-			decision: action.decision,
+			kind: action.kind,
+			...action.kind === "decision" ? { decision: action.decision } : {},
 			label: action.label,
 			style: action.style,
 			command: action.command
@@ -125,8 +126,36 @@ function buildMatrixApprovalMetadata(params) {
 		...params.view.sessionKey != null ? { sessionKey: params.view.sessionKey } : {}
 	};
 }
+function listDecisionActions(view) {
+	return view.actions.flatMap((action) => action.kind === "decision" ? [action.decision] : []);
+}
+function listPluginApprovalActionDescriptors(view) {
+	if (view.approvalKind !== "plugin") return;
+	const actions = [];
+	for (const action of view.actions) {
+		if (action.kind !== "command" && action.kind !== "decision" || !action.command.trim() || !action.label.trim()) continue;
+		if (action.kind === "command") {
+			actions.push({
+				kind: "command",
+				label: action.label,
+				style: action.style,
+				command: action.command
+			});
+			continue;
+		}
+		actions.push({
+			kind: "decision",
+			label: action.label,
+			style: action.style,
+			command: action.command,
+			decision: action.decision
+		});
+	}
+	return actions.length > 0 ? actions : void 0;
+}
 function buildPendingApprovalContent(params) {
-	const allowedDecisions = params.view.actions.map((action) => action.decision);
+	const allowedDecisions = listDecisionActions(params.view);
+	const pluginActions = listPluginApprovalActionDescriptors(params.view);
 	const payload = params.view.approvalKind === "plugin" ? buildPluginApprovalPendingReplyPayload({
 		request: {
 			id: params.view.approvalId,
@@ -136,7 +165,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,
+				actions: pluginActions
 			},
 			createdAtMs: 0,
 			expiresAtMs: params.view.expiresAtMs

package/dist/{approval-ids-CDBO9rb7.js → approval-ids-DzBw_AG3.js}

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

package/dist/{approval-reaction-auth-B1S7D_cq.js → approval-reaction-auth-BvK3dXMH.js}

@@ -1,5 +1,5 @@
-import { g as resolveMatrixAccount } from "./setup-core-DiRWksVZ.js";
-import { t as normalizeMatrixApproverId } from "./approval-ids-CDBO9rb7.js";
+import { g as resolveMatrixAccount } from "./setup-core-s8s_Qudu.js";
+import { t as normalizeMatrixApproverId } from "./approval-ids-DzBw_AG3.js";
 import { resolveApprovalApprovers } from "openclaw/plugin-sdk/approval-auth-runtime";
 //#region extensions/matrix/src/approval-reaction-auth.ts
 function normalizeMatrixExecApproverId(value) {

package/dist/{channel-Q-9mXTAf.js → channel-BLuA_9If.js}

@@ -2,9 +2,9 @@ import { a as resolveMatrixTargetIdentity, i as resolveMatrixDirectUserId, n as
 import { d as setMatrixThreadBindingIdleTimeoutBySessionKey, p as setMatrixThreadBindingMaxAgeBySessionKey } from "./thread-bindings-shared-CKnY4LSd.js";
 import { n as requiresExplicitMatrixDefaultAccount } from "./account-selection-C3arLOhC.js";
 import { c as resolveMatrixAccountConfig } from "./config-paths-ZBCMwSos.js";
-import { d as resolveSingleAccountPromotionTarget, f as singleAccountKeysToMove, g as resolveMatrixAccount, h as resolveDefaultMatrixAccountId, n as matrixSetupAdapter, p as listMatrixAccountIds, t as createMatrixSetupWizardProxy, u as namedAccountPromotionKeys } from "./setup-core-DiRWksVZ.js";
-import { a as normalizeMatrixUserId, n as DEFAULT_ACCOUNT_ID$2, r as matrixConfigAdapter, t as MatrixChannelConfigSchema } from "./config-schema-qPgAoSU2.js";
-import { t as normalizeMatrixApproverId } from "./approval-ids-CDBO9rb7.js";
+import { d as resolveSingleAccountPromotionTarget, f as singleAccountKeysToMove, g as resolveMatrixAccount, h as resolveDefaultMatrixAccountId, n as matrixSetupAdapter, p as listMatrixAccountIds, t as createMatrixSetupWizardProxy, u as namedAccountPromotionKeys } from "./setup-core-s8s_Qudu.js";
+import { a as normalizeMatrixUserId, n as DEFAULT_ACCOUNT_ID$2, r as matrixConfigAdapter, t as MatrixChannelConfigSchema } from "./config-schema-DuSRVdwT.js";
+import { t as normalizeMatrixApproverId } from "./approval-ids-DzBw_AG3.js";
 import { t as formatMatrixErrorMessage } from "./errors-C47hvAF8.js";
 import { n as normalizeCompatibilityConfig, t as legacyConfigRules } from "./doctor-contract-D9oKDvsJ.js";
 import { n as collectRuntimeConfigAssignments, r as secretTargetRegistryEntries } from "./secret-contract-DTgQyQxc.js";
@@ -17,11 +17,10 @@ import { normalizeLowercaseStringOrEmpty, normalizeOptionalString, normalizeOpti
 import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 import { adaptScopedAccountAccessor, createScopedDmSecurityResolver } from "openclaw/plugin-sdk/channel-config-helpers";
 import { buildChannelOutboundSessionRoute, buildThreadAwareOutboundSessionRoute, createChatChannelPlugin } from "openclaw/plugin-sdk/channel-core";
-import { createChannelMessageAdapterFromOutbound } from "openclaw/plugin-sdk/channel-message";
+import { createChannelMessageAdapterFromOutbound, createReplyPrefixOptions, createRuntimeOutboundDelegates, createTypingCallbacks, logTypingFailure } from "openclaw/plugin-sdk/channel-outbound";
 import { createAllowlistProviderOpenWarningCollector, projectAccountConfigWarningCollector } from "openclaw/plugin-sdk/channel-policy";
 import { createChannelDirectoryAdapter, createResolvedDirectoryEntriesLister, createRuntimeDirectoryLiveAdapter } from "openclaw/plugin-sdk/directory-runtime";
 import { createLazyRuntimeNamedExport } from "openclaw/plugin-sdk/lazy-runtime";
-import { createRuntimeOutboundDelegates } from "openclaw/plugin-sdk/outbound-runtime";
 import { buildProbeChannelStatusSummary, collectStatusIssuesFromLastError, createComputedAccountStatusAdapter, createDefaultChannelRuntimeState } from "openclaw/plugin-sdk/status-helpers";
 import { chunkTextForOutbound } from "openclaw/plugin-sdk/text-chunking";
 import { ToolAuthorizationError, createActionGate, readNumberParam, readStringParam } from "openclaw/plugin-sdk/channel-actions";
@@ -36,10 +35,8 @@ import { createChannelExecApprovalProfile, getExecApprovalReplyMetadata, isChann
 import { normalizeAccountId as normalizeAccountId$1, parseThreadSessionSuffix } from "openclaw/plugin-sdk/routing";
 import { createPairingPrefixStripper } from "openclaw/plugin-sdk/channel-pairing";
 import { PAIRING_APPROVED_MESSAGE } from "openclaw/plugin-sdk/channel-status";
-import { createReplyPrefixOptions, createTypingCallbacks } from "openclaw/plugin-sdk/channel-reply-options-runtime";
-import { formatLocationText, toLocationContext } from "openclaw/plugin-sdk/channel-location";
+import { formatLocationText, logInboundDrop, toLocationContext } from "openclaw/plugin-sdk/channel-inbound";
 import { getAgentScopedMediaLocalRoots } from "openclaw/plugin-sdk/agent-media-payload";
-import { logInboundDrop, logTypingFailure } from "openclaw/plugin-sdk/channel-logging";
 import { buildChannelKeyCandidates, resolveChannelEntryMatch } from "openclaw/plugin-sdk/channel-targets";
 import { loadSessionStore, resolveSessionStoreEntry, resolveStorePath } from "openclaw/plugin-sdk/session-store-runtime";
 //#region extensions/matrix/src/actions.ts
@@ -132,7 +129,7 @@ const matrixMessageActions = {
 		return extractToolSend(args, "sendMessage");
 	},
 	handleAction: async (ctx) => {
-		const { handleMatrixAction } = await import("./tool-actions.runtime-B0cTgnsO.js");
+		const { handleMatrixAction } = await import("./tool-actions.runtime-Vky1krcK.js");
 		const { action, params, cfg, accountId, mediaLocalRoots } = ctx;
 		const dispatch = async (actionParams) => await handleMatrixAction({
 			...actionParams,
@@ -596,7 +593,7 @@ const matrixNativeApprovalCapability = createApproverRestrictedNativeApprovalCap
 			accountId,
 			request
 		}),
-		load: async () => (await import("./approval-handler.runtime-R9NDTUte.js")).matrixApprovalNativeRuntime
+		load: async () => (await import("./approval-handler.runtime-D2nZfRw6.js")).matrixApprovalNativeRuntime
 	})
 });
 const splitMatrixApprovalCapability = splitChannelApprovalCapability(matrixNativeApprovalCapability);
@@ -947,8 +944,8 @@ async function runMatrixStartupMaintenance(params) {
 //#endregion
 //#region extensions/matrix/src/channel.ts
 let matrixStartupLock = Promise.resolve();
-const loadMatrixSetupWizard = createLazyRuntimeNamedExport(() => import("./setup-surface-DD5dKWcB.js").then((n) => n.t), "matrixSetupWizard");
-const loadMatrixChannelRuntime = createLazyRuntimeNamedExport(() => import("./channel.runtime-Dfg5ICEI.js"), "matrixChannelRuntime");
+const loadMatrixSetupWizard = createLazyRuntimeNamedExport(() => import("./setup-surface-BOt10HNf.js").then((n) => n.t), "matrixSetupWizard");
+const loadMatrixChannelRuntime = createLazyRuntimeNamedExport(() => import("./channel.runtime-CCAsyp75.js"), "matrixChannelRuntime");
 const meta = {
 	id: "matrix",
 	label: "Matrix",
@@ -957,6 +954,7 @@ const meta = {
 	docsLabel: "matrix",
 	blurb: "open protocol; configure a homeserver + access token.",
 	order: 70,
+	markdownCapable: true,
 	quickstartAllowFrom: true
 };
 function buildMatrixTrafficStatusSummary(snapshot) {
@@ -1318,7 +1316,7 @@ const matrixPlugin = createChatChannelPlugin({
 			await previousLock;
 			let monitorMatrixProvider;
 			try {
-				monitorMatrixProvider = (await import("./monitor-j0WwEmVj.js")).monitorMatrixProvider;
+				monitorMatrixProvider = (await import("./monitor-DO1yiHWm.js")).monitorMatrixProvider;
 			} finally {
 				releaseLock();
 			}

package/dist/channel-plugin-api.js

@@ -1,2 +1,2 @@
-import { t as matrixPlugin } from "./channel-Q-9mXTAf.js";
+import { t as matrixPlugin } from "./channel-BLuA_9If.js";
 export { matrixPlugin };

package/dist/{channel.runtime-Dfg5ICEI.js → channel.runtime-CCAsyp75.js}

@@ -1,12 +1,12 @@
-import { a as sendMessageMatrix, c as sendTypingMatrix, o as sendPollMatrix } from "./send-DiYHONuz.js";
+import { a as sendMessageMatrix, c as sendTypingMatrix, o as sendPollMatrix } from "./send-DivaFHb1.js";
 import { t as isBunRuntime } from "./runtime-BefyhPWv.js";
 import { l as resolveMatrixAuth } from "./shared-3K27tl8e.js";
 import "./client-QO7vDxm0.js";
 import { n as listMatrixDirectoryGroupsLive, r as listMatrixDirectoryPeersLive } from "./directory-live-2-Vb6nss.js";
-import { f as resolveOutboundSendDep, n as chunkTextForOutbound } from "./runtime-api-CtNLoJ_E.js";
+import { f as resolveOutboundSendDep, n as chunkTextForOutbound } from "./runtime-api-B-jlPE4A.js";
 import { t as resolveMatrixTargets } from "./resolve-targets-BPhBqXyj.js";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
-import { createReplyToFanout } from "openclaw/plugin-sdk/outbound-runtime";
+import { createReplyToFanout } from "openclaw/plugin-sdk/channel-outbound";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { renderMessagePresentationFallbackText } from "openclaw/plugin-sdk/interactive-runtime";
 import { resolvePayloadMediaUrls } from "openclaw/plugin-sdk/reply-payload";

package/dist/{cli-MPGdj4tQ.js → cli-Bo50M7l4.js}

@@ -1,16 +1,16 @@
 import { c as resolveMatrixAccountConfig } from "./config-paths-ZBCMwSos.js";
 import { t as getMatrixRuntime } from "./runtime-6S3DNFNv.js";
-import { c as resolveMatrixConfigPath, g as resolveMatrixAccount, l as updateMatrixAccountConfig, n as matrixSetupAdapter } from "./setup-core-DiRWksVZ.js";
+import { c as resolveMatrixConfigPath, g as resolveMatrixAccount, l as updateMatrixAccountConfig, n as matrixSetupAdapter } from "./setup-core-s8s_Qudu.js";
 import { t as formatMatrixErrorMessage } from "./errors-C47hvAF8.js";
 import { t as resolveMatrixRoomKeyBackupIssue } from "./backup-health-Dm_YMVFT.js";
 import { i as setMatrixSdkLogMode, r as setMatrixSdkConsoleLogging } from "./logging-BR-gcAjp.js";
-import { n as withResolvedActionClient } from "./client-DLpRIMeD.js";
+import { n as withResolvedActionClient } from "./client-BgsOzckO.js";
 import { u as resolveMatrixAuthContext } from "./shared-3K27tl8e.js";
 import "./client-QO7vDxm0.js";
-import { i as formatZonedTimestamp } from "./runtime-api-CtNLoJ_E.js";
+import { i as formatZonedTimestamp } from "./runtime-api-B-jlPE4A.js";
 import { isOpenClawManagedMatrixDevice, summarizeMatrixDeviceHealth } from "./device-health-D4LBxuPq.js";
-import { n as updateMatrixOwnProfile, t as applyMatrixProfileUpdate } from "./profile-update-Esnq0p93.js";
-import { a as confirmMatrixVerificationSas, b as verifyMatrixRecoveryKey, c as getMatrixRoomKeyBackupStatus, d as listMatrixVerifications, f as mismatchMatrixVerificationSas, g as runMatrixSelfVerification, h as restoreMatrixRoomKeyBackup, l as getMatrixVerificationSas, m as resetMatrixRoomKeyBackup, n as bootstrapMatrixVerification, p as requestMatrixVerification, r as cancelMatrixVerification, t as acceptMatrixVerification, u as getMatrixVerificationStatus, v as startMatrixVerification } from "./verification-CVQiUQ9Y.js";
+import { n as updateMatrixOwnProfile, t as applyMatrixProfileUpdate } from "./profile-update-B_LpeC8E.js";
+import { a as confirmMatrixVerificationSas, b as verifyMatrixRecoveryKey, c as getMatrixRoomKeyBackupStatus, d as listMatrixVerifications, f as mismatchMatrixVerificationSas, g as runMatrixSelfVerification, h as restoreMatrixRoomKeyBackup, l as getMatrixVerificationSas, m as resetMatrixRoomKeyBackup, n as bootstrapMatrixVerification, p as requestMatrixVerification, r as cancelMatrixVerification, t as acceptMatrixVerification, u as getMatrixVerificationStatus, v as startMatrixVerification } from "./verification-Dar6QON4.js";
 import { normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 //#region extensions/matrix/src/matrix/actions/devices.ts
 async function listMatrixOwnDevices(opts = {}) {
@@ -37,11 +37,11 @@ let matrixCliExitScheduled = false;
 let matrixActionClientModulePromise;
 let matrixDirectManagementModulePromise;
 function loadMatrixActionClientModule() {
-	matrixActionClientModulePromise ??= import("./client-DLpRIMeD.js").then((n) => n.t);
+	matrixActionClientModulePromise ??= import("./client-BgsOzckO.js").then((n) => n.t);
 	return matrixActionClientModulePromise;
 }
 function loadMatrixDirectManagementModule() {
-	matrixDirectManagementModulePromise ??= import("./send-DiYHONuz.js").then((n) => n.d);
+	matrixDirectManagementModulePromise ??= import("./send-DivaFHb1.js").then((n) => n.d);
 	return matrixDirectManagementModulePromise;
 }
 function scheduleMatrixCliExit() {
@@ -208,7 +208,7 @@ async function addMatrixAccount(params) {
 		backupVersion: null
 	};
 	if (accountConfig.encryption === true) {
-		const { maybeBootstrapNewEncryptedMatrixAccount } = await import("./setup-bootstrap-Cgq4GjHo.js");
+		const { maybeBootstrapNewEncryptedMatrixAccount } = await import("./setup-bootstrap-ClcP-tDQ.js");
 		verificationBootstrap = await maybeBootstrapNewEncryptedMatrixAccount({
 			previousCfg: cfg,
 			cfg: updated,

package/dist/{cli-metadata-DnXlx9Nh.js → cli-metadata-CqUHNx_0.js}

@@ -2,7 +2,7 @@ import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 //#region extensions/matrix/src/cli-metadata.ts
 function registerMatrixCliMetadata(api) {
 	api.registerCli(async ({ program }) => {
-		const { registerMatrixCli } = await import("./cli-MPGdj4tQ.js");
+		const { registerMatrixCli } = await import("./cli-Bo50M7l4.js");
 		registerMatrixCli({ program });
 	}, { descriptors: [{
 		name: "matrix",

package/dist/cli-metadata.js

@@ -1,2 +1,2 @@
-import { n as registerMatrixCliMetadata, t as cli_metadata_default } from "./cli-metadata-DnXlx9Nh.js";
+import { n as registerMatrixCliMetadata, t as cli_metadata_default } from "./cli-metadata-CqUHNx_0.js";
 export { cli_metadata_default as default, registerMatrixCliMetadata };

package/dist/{client-DLpRIMeD.js → client-BgsOzckO.js}

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
-import { u as resolveMatrixRoomId } from "./send-DiYHONuz.js";
+import { u as resolveMatrixRoomId } from "./send-DivaFHb1.js";
 import { n as withResolvedRuntimeMatrixClient } from "./client-bootstrap-DK9i3KZ5.js";
 //#region extensions/matrix/src/matrix/actions/client.ts
 var client_exports = /* @__PURE__ */ __exportAll({

package/dist/{config-schema-qPgAoSU2.js → config-schema-DuSRVdwT.js}

@@ -1,5 +1,5 @@
 import { c as resolveMatrixAccountConfig } from "./config-paths-ZBCMwSos.js";
-import { g as resolveMatrixAccount, h as resolveDefaultMatrixAccountId, p as listMatrixAccountIds } from "./setup-core-DiRWksVZ.js";
+import { g as resolveMatrixAccount, h as resolveDefaultMatrixAccountId, p as listMatrixAccountIds } from "./setup-core-s8s_Qudu.js";
 import { DEFAULT_ACCOUNT_ID as DEFAULT_ACCOUNT_ID$1 } from "openclaw/plugin-sdk/account-id";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { adaptScopedAccountAccessor, createScopedChannelConfigAdapter } from "openclaw/plugin-sdk/channel-config-helpers";

package/dist/contract-api.js

@@ -1,8 +1,8 @@
 import { s as resetMatrixThreadBindingsForTests } from "./thread-bindings-shared-CKnY4LSd.js";
 import { r as setMatrixRuntime } from "./runtime-6S3DNFNv.js";
-import { d as resolveSingleAccountPromotionTarget, f as singleAccountKeysToMove, n as matrixSetupAdapter, u as namedAccountPromotionKeys } from "./setup-core-DiRWksVZ.js";
+import { d as resolveSingleAccountPromotionTarget, f as singleAccountKeysToMove, n as matrixSetupAdapter, u as namedAccountPromotionKeys } from "./setup-core-s8s_Qudu.js";
 import { n as normalizeCompatibilityConfig, t as legacyConfigRules } from "./doctor-contract-D9oKDvsJ.js";
 import { n as collectRuntimeConfigAssignments, r as secretTargetRegistryEntries } from "./secret-contract-DTgQyQxc.js";
-import { n as matrixOnboardingAdapter } from "./setup-surface-DD5dKWcB.js";
-import { t as createMatrixThreadBindingManager } from "./thread-bindings-DpAW-FD_.js";
+import { n as matrixOnboardingAdapter } from "./setup-surface-BOt10HNf.js";
+import { t as createMatrixThreadBindingManager } from "./thread-bindings-CLjJrThw.js";
 export { collectRuntimeConfigAssignments, createMatrixThreadBindingManager, legacyConfigRules, matrixSetupAdapter, matrixOnboardingAdapter as matrixSetupWizard, namedAccountPromotionKeys, normalizeCompatibilityConfig, resetMatrixThreadBindingsForTests, resolveSingleAccountPromotionTarget, secretTargetRegistryEntries, setMatrixRuntime, singleAccountKeysToMove };

package/dist/{draft-stream-D1PvVZ3B.js → draft-stream-BBVqdEbn.js}

@@ -1,5 +1,5 @@
-import { n as editMessageMatrix, r as prepareMatrixSingleText, s as sendSingleTextMessageMatrix, y as MsgType } from "./send-DiYHONuz.js";
-import { createDraftStreamLoop } from "openclaw/plugin-sdk/channel-lifecycle";
+import { n as editMessageMatrix, r as prepareMatrixSingleText, s as sendSingleTextMessageMatrix, y as MsgType } from "./send-DivaFHb1.js";
+import { createDraftStreamLoop } from "openclaw/plugin-sdk/channel-outbound";
 //#region extensions/matrix/src/matrix/draft-stream.ts
 const DEFAULT_THROTTLE_MS = 1e3;
 function resolveDraftPreviewOptions(mode) {
@@ -7,7 +7,10 @@ function resolveDraftPreviewOptions(mode) {
 		msgtype: MsgType.Notice,
 		includeMentions: false
 	};
-	return { msgtype: MsgType.Text };
+	return {
+		msgtype: MsgType.Text,
+		includeMentions: false
+	};
 }
 function createMatrixDraftStream(params) {
 	const { roomId, client, cfg, threadId, accountId, log } = params;

package/dist/index.js

@@ -1,4 +1,4 @@
-import { n as registerMatrixCliMetadata } from "./cli-metadata-DnXlx9Nh.js";
+import { n as registerMatrixCliMetadata } from "./cli-metadata-CqUHNx_0.js";
 import { t as registerMatrixSubagentHooks } from "./subagent-hooks-api-bedE4GYl.js";
 import { defineBundledChannelEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 //#region extensions/matrix/index.ts

package/dist/{media-text-Dowl-J8F.js → media-text-C6q1S0AJ.js}

@@ -1,4 +1,4 @@
-import { C as formatPollResultsAsText, D as parsePollStartContent, O as resolvePollReferenceEventId, S as formatPollAsText, T as isPollStartType, w as isPollEventType, x as buildPollResultsSummary } from "./send-DiYHONuz.js";
+import { C as formatPollResultsAsText, D as parsePollStartContent, O as resolvePollReferenceEventId, S as formatPollAsText, T as isPollStartType, w as isPollEventType, x as buildPollResultsSummary } from "./send-DivaFHb1.js";
 import path from "node:path";
 //#region extensions/matrix/src/matrix/poll-summary.ts
 function resolveMatrixPollRootEventId(event) {

package/dist/{messages-D_zHS_2K.js → messages-D-VxmWkC.js}

@@ -1,8 +1,8 @@
 import { r as isMatrixNotFoundError } from "./errors-C47hvAF8.js";
-import { a as sendMessageMatrix, n as editMessageMatrix, w as isPollEventType } from "./send-DiYHONuz.js";
+import { a as sendMessageMatrix, n as editMessageMatrix, w as isPollEventType } from "./send-DivaFHb1.js";
 import { n as MATRIX_REACTION_EVENT_TYPE } from "./reaction-common-DkrQdBSZ.js";
-import { a as resolveMatrixMessageBody, c as resolveMatrixPollRootEventId, i as resolveMatrixMessageAttachment, o as fetchMatrixPollMessageSummary } from "./media-text-Dowl-J8F.js";
-import { r as withResolvedRoomAction } from "./client-DLpRIMeD.js";
+import { a as resolveMatrixMessageBody, c as resolveMatrixPollRootEventId, i as resolveMatrixMessageAttachment, o as fetchMatrixPollMessageSummary } from "./media-text-C6q1S0AJ.js";
+import { r as withResolvedRoomAction } from "./client-BgsOzckO.js";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 //#region extensions/matrix/src/matrix/actions/limits.ts
 function resolveMatrixActionLimit(raw, fallback) {

package/dist/{monitor-j0WwEmVj.js → monitor-DO1yiHWm.js}

@@ -1,41 +1,39 @@
 import { t as isMatrixQualifiedUserId } from "./target-ids-B-5aQxwn.js";
 import { c as resolveMatrixAccountConfig, s as resolveMatrixAccountAllowlistConfig } from "./config-paths-ZBCMwSos.js";
 import { t as getMatrixRuntime } from "./runtime-6S3DNFNv.js";
-import { m as resolveConfiguredMatrixBotUserIds } from "./setup-core-DiRWksVZ.js";
-import { a as buildAllowlistResolutionSummary, c as createTypingCallbacks, d as logInboundDrop, f as logTypingFailure, h as toLocationContext, i as addAllowlistUserEntriesFromConfigEntry, l as formatLocationText, m as summarizeMapping, n as resolveMatrixStoredSessionMeta, o as canonicalizeAllowlistWithResolvedIds, p as patchAllowlistUsersInConfigEntries, r as resolveMatrixRoomConfig, s as createReplyPrefixOptions, u as getAgentScopedMediaLocalRoots } from "./channel-Q-9mXTAf.js";
-import { a as normalizeMatrixUserId, i as normalizeMatrixAllowList, o as resolveMatrixAllowListMatch } from "./config-schema-qPgAoSU2.js";
+import { m as resolveConfiguredMatrixBotUserIds } from "./setup-core-s8s_Qudu.js";
+import { a as buildAllowlistResolutionSummary, c as createTypingCallbacks, d as logInboundDrop, f as logTypingFailure, h as toLocationContext, i as addAllowlistUserEntriesFromConfigEntry, l as formatLocationText, m as summarizeMapping, n as resolveMatrixStoredSessionMeta, o as canonicalizeAllowlistWithResolvedIds, p as patchAllowlistUsersInConfigEntries, r as resolveMatrixRoomConfig, s as createReplyPrefixOptions, u as getAgentScopedMediaLocalRoots } from "./channel-BLuA_9If.js";
+import { a as normalizeMatrixUserId, i as normalizeMatrixAllowList, o as resolveMatrixAllowListMatch } from "./config-schema-DuSRVdwT.js";
 import { r as isMatrixNotFoundError, t as formatMatrixErrorMessage } from "./errors-C47hvAF8.js";
 import { i as resolveMatrixStateFilePath } from "./storage-onzulLbU.js";
-import { D as parsePollStartContent, S as formatPollAsText, T as isPollStartType, _ as readJoinedMatrixMembers, a as sendMessageMatrix, f as promoteMatrixDirectRoomCandidate, g as isStrictDirectMembership, h as hasDirectMatrixMemberFlag, t as chunkMatrixText, v as MATRIX_OPENCLAW_FINALIZED_PREVIEW_KEY, w as isPollEventType } from "./send-DiYHONuz.js";
-import { t as createMatrixThreadBindingManager } from "./thread-bindings-DpAW-FD_.js";
+import { D as parsePollStartContent, S as formatPollAsText, T as isPollStartType, _ as readJoinedMatrixMembers, a as sendMessageMatrix, f as promoteMatrixDirectRoomCandidate, g as isStrictDirectMembership, h as hasDirectMatrixMemberFlag, t as chunkMatrixText, v as MATRIX_OPENCLAW_FINALIZED_PREVIEW_KEY, w as isPollEventType } from "./send-DivaFHb1.js";
+import { t as createMatrixThreadBindingManager } from "./thread-bindings-CLjJrThw.js";
 import { t as createAsyncLock } from "./async-lock-BcLS4KOc.js";
 import { i as throwIfMatrixStartupAborted, o as LogService, r as isMatrixStartupAbortError } from "./startup-abort-Bs0Up_Qx.js";
 import { i as isMatrixMediaSizeLimitError, r as MatrixMediaSizeLimitError } from "./http-client-DJNugFzO.js";
 import { n as isMatrixReadySyncState, r as isMatrixTerminalSyncState, t as isMatrixDisconnectedSyncState } from "./sync-state-CWbp0QSY.js";
-import { a as resolveMatrixMessageBody, i as resolveMatrixMessageAttachment, n as formatMatrixMediaUnavailableText, r as formatMatrixMessageText, s as fetchMatrixPollSnapshot, t as formatMatrixMediaTooLargeText } from "./media-text-Dowl-J8F.js";
+import { a as resolveMatrixMessageBody, i as resolveMatrixMessageAttachment, n as formatMatrixMediaUnavailableText, r as formatMatrixMessageText, s as fetchMatrixPollSnapshot, t as formatMatrixMediaTooLargeText } from "./media-text-C6q1S0AJ.js";
 import { n as setActiveMatrixClient } from "./active-client-DXvz2gCo.js";
 import { t as isBunRuntime } from "./runtime-BefyhPWv.js";
 import { c as backfillMatrixAuthDeviceIdAfterStartup, i as resolveSharedMatrixClient, l as resolveMatrixAuth, n as releaseSharedClientInstance, u as resolveMatrixAuthContext } from "./shared-3K27tl8e.js";
 import "./client-QO7vDxm0.js";
-import { d as resolveDefaultGroupPolicy, h as warnMissingProviderGroupPolicyFallbackOnce, m as resolveThreadBindingMaxAgeMsForChannel, p as resolveThreadBindingIdleTimeoutMsForChannel, t as GROUP_POLICY_BLOCKED_LABEL, u as resolveAllowlistProviderRuntimeGroupPolicy } from "./runtime-api-CtNLoJ_E.js";
+import { d as resolveDefaultGroupPolicy, h as warnMissingProviderGroupPolicyFallbackOnce, m as resolveThreadBindingMaxAgeMsForChannel, p as resolveThreadBindingIdleTimeoutMsForChannel, t as GROUP_POLICY_BLOCKED_LABEL, u as resolveAllowlistProviderRuntimeGroupPolicy } from "./runtime-api-B-jlPE4A.js";
 import { t as resolveMatrixTargets } from "./resolve-targets-BPhBqXyj.js";
 import { t as formatMatrixEncryptedEventDisabledWarning } from "./encryption-guidance-CU-OAPMg.js";
 import { a as EventType, i as resolveMatrixThreadRouting, n as resolveMatrixReplyToEventId, o as RelationType, r as resolveMatrixThreadRootId, t as resolveMatrixInboundRoute } from "./route-DY6at4qJ.js";
 import { normalizeLowercaseStringOrEmpty, normalizeOptionalString, normalizeStringifiedEntries, uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
-import { createPreviewMessageReceipt, defineFinalizableLivePreviewAdapter, deliverWithFinalizableLivePreviewAdapter } from "openclaw/plugin-sdk/channel-message";
+import { buildChannelProgressDraftLineForEntry, createChannelProgressDraftGate, createPreviewMessageReceipt, defineFinalizableLivePreviewAdapter, deliverWithFinalizableLivePreviewAdapter, formatChannelProgressDraftLine, formatChannelProgressDraftLineForEntry, formatChannelProgressDraftText, isChannelProgressDraftWorkToolName, mergeChannelProgressDraftLine, normalizeChannelProgressDraftLineIdentity, resolveChannelProgressDraftMaxLines, waitUntilAbort } from "openclaw/plugin-sdk/channel-outbound";
 import { CHANNEL_APPROVAL_NATIVE_RUNTIME_CONTEXT_CAPABILITY } from "openclaw/plugin-sdk/approval-handler-adapter-runtime";
 import { resolveInboundLastRouteSessionKey } from "openclaw/plugin-sdk/routing";
+import { buildChannelInboundEventContext, hasFinalInboundReplyDispatch, toInboundMediaFacts } from "openclaw/plugin-sdk/channel-inbound";
 import { loadSessionStore, resolveSessionStoreEntry } from "openclaw/plugin-sdk/session-store-runtime";
 import { readJsonFileWithFallback, writeJsonFileAtomically } from "openclaw/plugin-sdk/json-store";
 import { format } from "node:util";
 import { buildTtsSupplementMediaPayload, getReplyPayloadTtsSupplement } from "openclaw/plugin-sdk/reply-payload";
 import { resolveAckReaction } from "openclaw/plugin-sdk/channel-feedback";
-import { hasFinalInboundReplyDispatch } from "openclaw/plugin-sdk/inbound-reply-dispatch";
-import { waitUntilAbort } from "openclaw/plugin-sdk/channel-lifecycle";
 import { registerChannelRuntimeContext } from "openclaw/plugin-sdk/channel-runtime-context";
 import { isDangerousNameMatchingEnabled } from "openclaw/plugin-sdk/dangerous-name-runtime";
 import { createChannelIngressResolver, defineStableChannelIngressIdentity } from "openclaw/plugin-sdk/channel-ingress-runtime";
-import { buildChannelProgressDraftLineForEntry, createChannelProgressDraftGate, formatChannelProgressDraftLine, formatChannelProgressDraftLineForEntry, formatChannelProgressDraftText, isChannelProgressDraftWorkToolName, mergeChannelProgressDraftLine, normalizeChannelProgressDraftLineIdentity, resolveChannelProgressDraftMaxLines } from "openclaw/plugin-sdk/channel-streaming";
 import { evaluateSupplementalContextVisibility, resolveChannelContextVisibilityMode } from "openclaw/plugin-sdk/context-visibility-runtime";
 import { mergePairLoopGuardConfig } from "openclaw/plugin-sdk/pair-loop-guard-runtime";
 import { buildInboundHistoryFromEntries } from "openclaw/plugin-sdk/reply-history";
@@ -811,7 +809,7 @@ const SAS_NOTICE_RETRY_DELAY_MS = 750;
 const VERIFICATION_EVENT_STARTUP_GRACE_MS = 3e4;
 let matrixDirectRoomDepsPromise;
 async function loadMatrixDirectRoomDeps() {
-	matrixDirectRoomDepsPromise ??= Promise.all([import("./send-DiYHONuz.js").then((n) => n.d), import("./send-DiYHONuz.js").then((n) => n.m)]).then(([directManagementModule, directRoomModule]) => ({
+	matrixDirectRoomDepsPromise ??= Promise.all([import("./send-DivaFHb1.js").then((n) => n.d), import("./send-DivaFHb1.js").then((n) => n.m)]).then(([directManagementModule, directRoomModule]) => ({
 		inspectMatrixDirectRooms: directManagementModule.inspectMatrixDirectRooms,
 		isStrictDirectRoom: directRoomModule.isStrictDirectRoom
 	}));
@@ -2020,7 +2018,7 @@ let sessionBindingRuntimePromise;
 let matrixReactionEventsPromise;
 let matrixDraftStreamPromise;
 function loadMatrixSendModule() {
-	matrixSendModulePromise ??= import("./send-DiYHONuz.js").then((n) => n.l);
+	matrixSendModulePromise ??= import("./send-DivaFHb1.js").then((n) => n.l);
 	return matrixSendModulePromise;
 }
 function loadAcpBindingRuntime() {
@@ -2032,13 +2030,21 @@ function loadSessionBindingRuntime() {
 	return sessionBindingRuntimePromise;
 }
 function loadMatrixReactionEvents() {
-	matrixReactionEventsPromise ??= import("./reaction-events-BP49GRln.js");
+	matrixReactionEventsPromise ??= import("./reaction-events-BefH3-Gu.js");
 	return matrixReactionEventsPromise;
 }
 function loadMatrixDraftStream() {
-	matrixDraftStreamPromise ??= import("./draft-stream-D1PvVZ3B.js");
+	matrixDraftStreamPromise ??= import("./draft-stream-BBVqdEbn.js");
 	return matrixDraftStreamPromise;
 }
+async function matrixTextWouldActivateMentions(client, text) {
+	const { resolveMatrixMentionsForBody } = await loadMatrixSendModule();
+	const mentions = await resolveMatrixMentionsForBody({
+		client,
+		body: text
+	});
+	return mentions.room === true || (mentions.user_ids?.length ?? 0) > 0;
+}
 const MAX_TRACKED_PAIRING_REPLY_SENDERS = 512;
 const MAX_TRACKED_SHARED_DM_CONTEXT_NOTICES = 512;
 var MatrixRetryableInboundError = class extends Error {
@@ -2752,10 +2758,7 @@ function createMatrixRoomMessageHandler(params) {
 				roomId,
 				eventId: replyToEventId
 			}) : void 0;
-			if (replyContext?.replyToSenderId && !shouldIncludeRoomContextSender("quote", replyContext.replyToSenderId)) {
-				logVerboseMessage(`matrix: drop reply context (mode=${contextVisibilityMode})`);
-				replyContext = void 0;
-			}
+			const replySenderAllowed = !replyContext?.replyToSenderId || isRoomContextSenderAllowed(replyContext.replyToSenderId);
 			const roomName = (isRoom ? await getRoomInfo(roomId) : void 0)?.name;
 			const envelopeFrom = isDirectMessage ? senderName : roomName ?? roomId;
 			const textWithId = `${bodyText}\n[matrix event id: ${messageId} room: ${roomId}]`;
@@ -2784,47 +2787,83 @@ function createMatrixRoomMessageHandler(params) {
 				body: textWithId
 			});
 			const groupSystemPrompt = normalizeOptionalString(roomConfig?.systemPrompt);
-			const ctxPayload = core.channel.reply.finalizeInboundContext({
-				Body: body,
-				RawBody: bodyText,
-				CommandBody: commandBodyText,
-				BodyForAgent: bodyText,
-				BodyForCommands: commandBodyText,
-				InboundHistory: inboundHistory && inboundHistory.length > 0 ? inboundHistory : void 0,
-				From: isDirectMessage ? `matrix:${senderId}` : `matrix:channel:${roomId}`,
-				To: `room:${roomId}`,
-				SessionKey: _route.sessionKey,
-				AccountId: _route.accountId,
-				ChatType: isDirectMessage ? "direct" : "channel",
-				ConversationLabel: envelopeFrom,
-				SenderName: senderName,
-				SenderId: senderId,
-				SenderUsername: senderId.split(":")[0]?.replace(/^@/, ""),
-				GroupSubject: isRoom ? roomName ?? roomId : void 0,
-				GroupId: isRoom ? roomId : void 0,
-				GroupChannel: isRoom ? roomId : void 0,
-				GroupSystemPrompt: isRoom ? groupSystemPrompt : void 0,
-				Provider: "matrix",
-				Surface: "matrix",
-				WasMentioned: isRoom ? wasMentioned : void 0,
-				MessageSid: messageId,
-				ReplyToId: threadTarget ? void 0 : replyToEventId ?? void 0,
-				ReplyToBody: replyContext?.replyToBody,
-				ReplyToSender: replyContext?.replyToSender,
-				MessageThreadId: threadTarget,
-				ThreadStarterBody: threadContext?.threadStarterBody,
-				Timestamp: eventTs ?? void 0,
-				MediaPath: media?.path,
-				MediaType: media?.contentType,
-				MediaUrl: media?.path,
-				...locationPayload?.context,
-				CommandAuthorized: commandAuthorized,
-				CommandSource: "text",
-				NativeChannelId: roomId,
-				NativeDirectUserId: isDirectMessage ? senderId : void 0,
-				OriginatingChannel: "matrix",
-				OriginatingTo: `room:${roomId}`
+			const quoteHidden = Boolean(replyContext && !evaluateSupplementalContextVisibility({
+				mode: contextVisibilityMode,
+				kind: "quote",
+				senderAllowed: replySenderAllowed
+			}).include);
+			const ctxPayload = buildChannelInboundEventContext({
+				channel: "matrix",
+				finalize: core.channel.reply.finalizeInboundContext,
+				contextVisibility: contextVisibilityMode,
+				supplemental: {
+					quote: replyContext ? {
+						id: threadTarget ? void 0 : replyToEventId ?? void 0,
+						body: replyContext.replyToBody,
+						sender: replyContext.replyToSender,
+						senderAllowed: replySenderAllowed
+					} : void 0,
+					thread: {
+						starterBody: threadContext?.threadStarterBody,
+						senderAllowed: threadContext ? true : void 0
+					},
+					groupSystemPrompt: isRoom ? groupSystemPrompt : void 0
+				},
+				media: toInboundMediaFacts(media ? [{
+					path: media.path,
+					url: media.path,
+					contentType: media.contentType
+				}] : void 0),
+				messageId,
+				timestamp: eventTs ?? void 0,
+				from: isDirectMessage ? `matrix:${senderId}` : `matrix:channel:${roomId}`,
+				sender: {
+					id: senderId,
+					name: senderName,
+					username: senderId.split(":")[0]?.replace(/^@/, "")
+				},
+				conversation: {
+					kind: isDirectMessage ? "direct" : "channel",
+					id: roomId,
+					label: envelopeFrom,
+					nativeChannelId: roomId,
+					threadId: threadTarget
+				},
+				route: {
+					agentId: _route.agentId,
+					accountId: _route.accountId,
+					routeSessionKey: _route.sessionKey
+				},
+				reply: {
+					to: `room:${roomId}`,
+					replyToId: threadTarget ? void 0 : replyToEventId ?? void 0,
+					messageThreadId: threadTarget,
+					nativeChannelId: roomId
+				},
+				message: {
+					body,
+					rawBody: bodyText,
+					commandBody: commandBodyText,
+					bodyForAgent: bodyText,
+					inboundHistory: inboundHistory && inboundHistory.length > 0 ? inboundHistory : void 0
+				},
+				access: {
+					...isRoom ? { mentions: {
+						canDetectMention: true,
+						wasMentioned
+					} } : {},
+					commands: { authorized: commandAuthorized }
+				},
+				extra: {
+					GroupSubject: isRoom ? roomName ?? roomId : void 0,
+					GroupId: isRoom ? roomId : void 0,
+					GroupChannel: isRoom ? roomId : void 0,
+					...locationPayload?.context,
+					CommandSource: "text",
+					NativeDirectUserId: isDirectMessage ? senderId : void 0
+				}
 			});
+			if (quoteHidden) logVerboseMessage(`matrix: drop reply context (mode=${contextVisibilityMode})`);
 			logVerboseMessage(`matrix inbound: room=${roomId} from=${senderId} preview="${bodyText.slice(0, 200).replace(/\n/g, "\\n")}"`);
 			const replyTarget = ctxPayload.To;
 			if (!replyTarget) {
@@ -3114,7 +3153,8 @@ function createMatrixRoomMessageHandler(params) {
 							mustDeliverFinalNormally = draftStream.mustDeliverFinalNormally();
 						} else await draftStream.discardPending();
 						const draftEventId = draftStream.eventId();
-						if (draftEventId && payload.text && !payload.isError && !hasMedia && !payloadReplyMismatch && !mustDeliverFinalNormally) {
+						const draftFinalTextNeedsNormalMentionDelivery = Boolean(draftEventId) && typeof payload.text === "string" && Boolean(payload.text.trim()) && !payload.isError && !payloadReplyMismatch && !mustDeliverFinalNormally && await matrixTextWouldActivateMentions(client, payload.text);
+						if (draftEventId && payload.text && !payload.isError && !hasMedia && !payloadReplyMismatch && !mustDeliverFinalNormally && !draftFinalTextNeedsNormalMentionDelivery) {
 							const finalPreviewText = payload.text;
 							await deliverWithFinalizableLivePreviewAdapter({
 								kind: "final",
@@ -3177,7 +3217,10 @@ function createMatrixRoomMessageHandler(params) {
 							const payloadText = payload.text ?? ttsSupplement?.spokenText;
 							const payloadTextMatchesDraft = typeof payloadText === "string" && draftStream.matchesPreparedText(payloadText);
 							const reusesDraftTextUnchanged = typeof payloadText === "string" && Boolean(payloadText.trim()) && payloadTextMatchesDraft;
-							if (textEditOk && payloadText && (quietDraftStreaming || typeof payloadText === "string" && !payloadTextMatchesDraft)) {
+							const mediaTextNeedsNormalMentionDelivery = typeof payloadText === "string" && Boolean(payloadText.trim()) && await matrixTextWouldActivateMentions(client, payloadText);
+							const requiresFinalTextEdit = quietDraftStreaming || typeof payloadText === "string" && !payloadTextMatchesDraft;
+							if (textEditOk && mediaTextNeedsNormalMentionDelivery) textEditOk = false;
+							else if (textEditOk && payloadText && requiresFinalTextEdit) {
 								const { editMessageMatrix } = await loadMatrixSendModule();
 								textEditOk = await editMessageMatrix(roomId, draftEventId, payloadText, {
 									client,
@@ -3207,7 +3250,7 @@ function createMatrixRoomMessageHandler(params) {
 							});
 							draftConsumed = true;
 						} else {
-							const draftRedacted = Boolean(draftEventId) && (payload.isError || payloadReplyMismatch || mustDeliverFinalNormally);
+							const draftRedacted = Boolean(draftEventId) && (payload.isError || payloadReplyMismatch || mustDeliverFinalNormally || draftFinalTextNeedsNormalMentionDelivery);
 							if (draftRedacted && draftEventId) await redactMatrixDraftEvent(client, roomId, draftEventId);
 							const deliveredFallback = await deliverMatrixReplies({
 								cfg,
@@ -3281,7 +3324,7 @@ function createMatrixRoomMessageHandler(params) {
 				route: _route,
 				sessionKey: _route.sessionKey
 			});
-			const turnResult = await core.channel.turn.run({
+			const turnResult = await core.channel.inbound.run({
 				channel: "matrix",
 				accountId: _route.accountId,
 				raw: event,
@@ -3331,12 +3374,14 @@ function createMatrixRoomMessageHandler(params) {
 							}
 						}),
 						runDispatch: async () => {
-							if (sharedDmContextNotice && markTrackedRoomIfFirst(sharedDmContextNoticeRooms, roomId)) client.sendMessage(roomId, {
-								msgtype: "m.notice",
-								body: sharedDmContextNotice
-							}).catch((err) => {
+							if (sharedDmContextNotice && markTrackedRoomIfFirst(sharedDmContextNoticeRooms, roomId)) try {
+								await client.sendMessage(roomId, {
+									msgtype: "m.notice",
+									body: sharedDmContextNotice
+								});
+							} catch (err) {
 								logVerboseMessage(`matrix: failed sending shared DM session notice room=${roomId}: ${String(err)}`);
-							});
+							}
 							return await core.channel.reply.withReplyDispatcher({
 								dispatcher,
 								onSettled: () => {
@@ -3715,9 +3760,9 @@ function createMatrixRoomInfoResolver(client) {
 let matrixStartupMaintenanceDepsPromise;
 async function loadMatrixStartupMaintenanceDeps() {
 	matrixStartupMaintenanceDepsPromise ??= Promise.all([
-		import("./setup-core-DiRWksVZ.js").then((n) => n.s),
+		import("./setup-core-s8s_Qudu.js").then((n) => n.s),
 		import("./device-health-D4LBxuPq.js"),
-		import("./setup-core-DiRWksVZ.js").then((n) => n.a),
+		import("./setup-core-s8s_Qudu.js").then((n) => n.a),
 		import("./legacy-crypto-restore-BgW3I87R.js"),
 		import("./startup-verification-BmTEngvU.js")
 	]).then(([configUpdateModule, deviceHealthModule, profileModule, legacyCryptoRestoreModule, startupVerificationModule]) => ({

package/dist/plugin-entry.handlers.runtime.js

@@ -3,7 +3,7 @@ import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runti
 //#region extensions/matrix/src/plugin-entry.runtime.ts
 let matrixVerificationRuntimePromise;
 function loadMatrixVerificationRuntime() {
-	matrixVerificationRuntimePromise ??= import("./verification-CVQiUQ9Y.js").then((n) => n.y);
+	matrixVerificationRuntimePromise ??= import("./verification-Dar6QON4.js").then((n) => n.y);
 	return matrixVerificationRuntimePromise;
 }
 function sendError(respond, err) {

package/dist/{profile-update-Esnq0p93.js → profile-update-B_LpeC8E.js}

@@ -1,6 +1,6 @@
 import { t as getMatrixRuntime } from "./runtime-6S3DNFNv.js";
-import { c as resolveMatrixConfigPath, l as updateMatrixAccountConfig, o as syncMatrixOwnProfile } from "./setup-core-DiRWksVZ.js";
-import { n as withResolvedActionClient } from "./client-DLpRIMeD.js";
+import { c as resolveMatrixConfigPath, l as updateMatrixAccountConfig, o as syncMatrixOwnProfile } from "./setup-core-s8s_Qudu.js";
+import { n as withResolvedActionClient } from "./client-BgsOzckO.js";
 import { normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 //#region extensions/matrix/src/matrix/actions/profile.ts
 async function updateMatrixOwnProfile(opts = {}) {

package/dist/{reaction-events-BP49GRln.js → reaction-events-BefH3-Gu.js}

@@ -7,7 +7,7 @@ import { getSessionBindingService } from "openclaw/plugin-sdk/session-binding-ru
 let approvalReactionAuthPromise;
 let execApprovalResolverPromise;
 function loadApprovalReactionAuth() {
-	approvalReactionAuthPromise ??= import("./approval-reaction-auth-B1S7D_cq.js");
+	approvalReactionAuthPromise ??= import("./approval-reaction-auth-BvK3dXMH.js");
 	return approvalReactionAuthPromise;
 }
 function loadExecApprovalResolver() {

package/dist/{runtime-api-CtNLoJ_E.js → runtime-api-B-jlPE4A.js}

@@ -1,15 +1,14 @@
 import "./timeout-abort-signal-DMrgRFIy.js";
 import "openclaw/plugin-sdk/account-id";
 import { resolveThreadBindingIdleTimeoutMsForChannel, resolveThreadBindingMaxAgeMsForChannel } from "openclaw/plugin-sdk/conversation-runtime";
-import "openclaw/plugin-sdk/channel-message";
+import { resolveOutboundSendDep } from "openclaw/plugin-sdk/channel-outbound";
 import { chunkTextForOutbound as chunkTextForOutbound$1 } from "openclaw/plugin-sdk/text-chunking";
 import { createActionGate as createActionGate$1, jsonResult, readNumberParam as readNumberParam$1, readReactionParams, readStringArrayParam, readStringParam as readStringParam$1 } from "openclaw/plugin-sdk/channel-actions";
 import "openclaw/plugin-sdk/routing";
 import "openclaw/plugin-sdk/channel-status";
 import "openclaw/plugin-sdk/channel-config-primitives";
 import "openclaw/plugin-sdk/ssrf-runtime";
-import "openclaw/plugin-sdk/channel-location";
-import "openclaw/plugin-sdk/channel-logging";
+import "openclaw/plugin-sdk/channel-inbound";
 import "openclaw/plugin-sdk/channel-targets";
 import "openclaw/plugin-sdk/setup";
 import "openclaw/plugin-sdk/json-store";
@@ -18,7 +17,5 @@ import "openclaw/plugin-sdk/poll-runtime";
 import { formatZonedTimestamp } from "openclaw/plugin-sdk/time-runtime";
 import "openclaw/plugin-sdk/channel-feedback";
 import { GROUP_POLICY_BLOCKED_LABEL, resolveAllowlistProviderRuntimeGroupPolicy, resolveDefaultGroupPolicy, warnMissingProviderGroupPolicyFallbackOnce } from "openclaw/plugin-sdk/runtime-group-policy";
-import "openclaw/plugin-sdk/inbound-reply-dispatch";
 import "openclaw/plugin-sdk/acp-binding-runtime";
-import { resolveOutboundSendDep } from "openclaw/plugin-sdk/outbound-send-deps";
 export { jsonResult as a, readStringArrayParam as c, resolveDefaultGroupPolicy as d, resolveOutboundSendDep as f, warnMissingProviderGroupPolicyFallbackOnce as h, formatZonedTimestamp as i, readStringParam$1 as l, resolveThreadBindingMaxAgeMsForChannel as m, chunkTextForOutbound$1 as n, readNumberParam$1 as o, resolveThreadBindingIdleTimeoutMsForChannel as p, createActionGate$1 as r, readReactionParams as s, GROUP_POLICY_BLOCKED_LABEL as t, resolveAllowlistProviderRuntimeGroupPolicy as u };

package/dist/{send-DiYHONuz.js → send-DivaFHb1.js}

@@ -4,7 +4,7 @@ import { c as resolveMatrixAccountConfig } from "./config-paths-ZBCMwSos.js";
 import { t as getMatrixRuntime } from "./runtime-6S3DNFNv.js";
 import { n as MATRIX_REACTION_EVENT_TYPE, r as buildMatrixReactionContent, t as MATRIX_ANNOTATION_RELATION_TYPE } from "./reaction-common-DkrQdBSZ.js";
 import { normalizeLowercaseStringOrEmpty, normalizeOptionalString, normalizeOptionalStringifiedId } from "openclaw/plugin-sdk/string-coerce-runtime";
-import { createMessageReceiptFromOutboundResults } from "openclaw/plugin-sdk/channel-message";
+import { createMessageReceiptFromOutboundResults } from "openclaw/plugin-sdk/channel-outbound";
 import { requireRuntimeConfig } from "openclaw/plugin-sdk/plugin-config-runtime";
 import { loadOutboundMediaFromUrl } from "openclaw/plugin-sdk/outbound-media";
 import { normalizePollInput } from "openclaw/plugin-sdk/poll-runtime";
@@ -270,7 +270,7 @@ md.enable("strikethrough");
 const { escapeHtml } = md.utils;
 const ESCAPED_MENTION_SENTINEL = "";
 const MENTION_PATTERN = /@[A-Za-z0-9._=+\-/:[\]]+/g;
-const MATRIX_MENTION_USER_ID_PATTERN = /^@[A-Za-z0-9._=+\-/]+:(?:[A-Za-z0-9.-]+|\[[0-9A-Fa-f:.]+\])(?::\d+)?$/;
+const MATRIX_MENTION_USER_ID_PATTERN = new RegExp(`^@[A-Za-z0-9._=+\\-/]+:(?:${/(?:[A-Za-z0-9](?:[A-Za-z0-9-]*[A-Za-z0-9])?)(?:\.(?:[A-Za-z0-9](?:[A-Za-z0-9-]*[A-Za-z0-9])?))*(?::\d+)?/.source}|\\[[0-9A-Fa-f:.]+\\](?::\\d+)?)$`);
 const TRIMMABLE_MENTION_SUFFIX = /[),.!?:;\]]/;
 function shouldSuppressAutoLink(tokens, idx) {
 	const token = tokens[idx];
@@ -1149,6 +1149,7 @@ var send_exports = /* @__PURE__ */ __exportAll({
 	editMessageMatrix: () => editMessageMatrix,
 	prepareMatrixSingleText: () => prepareMatrixSingleText,
 	reactMatrixMessage: () => reactMatrixMessage,
+	resolveMatrixMentionsForBody: () => resolveMatrixMentionsForBody,
 	resolveMatrixRoomId: () => resolveMatrixRoomId,
 	sendMessageMatrix: () => sendMessageMatrix,
 	sendPollMatrix: () => sendPollMatrix,

package/dist/{setup-bootstrap-Cgq4GjHo.js → setup-bootstrap-ClcP-tDQ.js}

@@ -1,7 +1,7 @@
 import { a as hasExplicitMatrixAccountConfig, c as resolveMatrixAccountConfig } from "./config-paths-ZBCMwSos.js";
-import "./setup-core-DiRWksVZ.js";
+import "./setup-core-s8s_Qudu.js";
 import { t as formatMatrixErrorMessage } from "./errors-C47hvAF8.js";
-import { n as bootstrapMatrixVerification } from "./verification-CVQiUQ9Y.js";
+import { n as bootstrapMatrixVerification } from "./verification-Dar6QON4.js";
 //#region extensions/matrix/src/setup-bootstrap.ts
 async function maybeBootstrapNewEncryptedMatrixAccount(params) {
 	const accountConfig = resolveMatrixAccountConfig({

package/dist/{setup-core-DiRWksVZ.js → setup-core-s8s_Qudu.js}

@@ -664,7 +664,7 @@ const matrixSetupAdapter = {
 		input
 	}),
 	afterAccountConfigWritten: async ({ previousCfg, cfg, accountId, runtime }) => {
-		const { runMatrixSetupBootstrapAfterConfigWrite } = await import("./setup-bootstrap-Cgq4GjHo.js");
+		const { runMatrixSetupBootstrapAfterConfigWrite } = await import("./setup-bootstrap-ClcP-tDQ.js");
 		await runMatrixSetupBootstrapAfterConfigWrite({
 			previousCfg,
 			cfg,

package/dist/setup-plugin-api.js

@@ -1,5 +1,5 @@
-import { g as resolveMatrixAccount, n as matrixSetupAdapter, t as createMatrixSetupWizardProxy } from "./setup-core-DiRWksVZ.js";
-import { r as matrixConfigAdapter, t as MatrixChannelConfigSchema } from "./config-schema-qPgAoSU2.js";
+import { g as resolveMatrixAccount, n as matrixSetupAdapter, t as createMatrixSetupWizardProxy } from "./setup-core-s8s_Qudu.js";
+import { r as matrixConfigAdapter, t as MatrixChannelConfigSchema } from "./config-schema-DuSRVdwT.js";
 import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 const matrixSetupPlugin = {
 	id: "matrix",
@@ -13,7 +13,7 @@ const matrixSetupPlugin = {
 		order: 70,
 		quickstartAllowFrom: true
 	},
-	setupWizard: createMatrixSetupWizardProxy(async () => ({ matrixSetupWizard: (await import("./setup-surface-DD5dKWcB.js").then((n) => n.t)).matrixSetupWizard })),
+	setupWizard: createMatrixSetupWizardProxy(async () => ({ matrixSetupWizard: (await import("./setup-surface-BOt10HNf.js").then((n) => n.t)).matrixSetupWizard })),
 	setup: matrixSetupAdapter,
 	capabilities: {
 		chatTypes: [

package/dist/{setup-surface-DD5dKWcB.js → setup-surface-BOt10HNf.js}

@@ -2,7 +2,7 @@ import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
 import { n as requiresExplicitMatrixDefaultAccount } from "./account-selection-C3arLOhC.js";
 import { c as resolveMatrixAccountConfig, t as resolveMatrixConfigFieldPath } from "./config-paths-ZBCMwSos.js";
 import { r as resolveMatrixEnvAuthReadiness } from "./env-auth-DIzOApj0.js";
-import { g as resolveMatrixAccount, h as resolveDefaultMatrixAccountId, i as moveSingleMatrixAccountConfigToNamedAccount, l as updateMatrixAccountConfig, p as listMatrixAccountIds, r as resolveMatrixSetupDmAllowFrom } from "./setup-core-DiRWksVZ.js";
+import { g as resolveMatrixAccount, h as resolveDefaultMatrixAccountId, i as moveSingleMatrixAccountConfigToNamedAccount, l as updateMatrixAccountConfig, p as listMatrixAccountIds, r as resolveMatrixSetupDmAllowFrom } from "./setup-core-s8s_Qudu.js";
 import { n as validateMatrixHomeserverUrl, r as isPrivateOrLoopbackHost, t as resolveValidatedMatrixHomeserverUrl } from "./url-validation-GRHde6lq.js";
 import { n as ensureMatrixSdkInstalled, r as isMatrixSdkAvailable } from "./deps-CAdiytPJ.js";
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/account-id";
@@ -507,7 +507,7 @@ const matrixOnboardingAdapter = {
 		});
 	},
 	afterConfigWritten: async ({ previousCfg, cfg, accountId, runtime }) => {
-		const { runMatrixSetupBootstrapAfterConfigWrite } = await import("./setup-bootstrap-Cgq4GjHo.js");
+		const { runMatrixSetupBootstrapAfterConfigWrite } = await import("./setup-bootstrap-ClcP-tDQ.js");
 		await runMatrixSetupBootstrapAfterConfigWrite({
 			previousCfg,
 			cfg,

package/dist/test-api.js

@@ -1,4 +1,4 @@
 import { r as setMatrixRuntime } from "./runtime-6S3DNFNv.js";
-import { t as matrixPlugin } from "./channel-Q-9mXTAf.js";
+import { t as matrixPlugin } from "./channel-BLuA_9If.js";
 import { t as MatrixClient } from "./sdk-BKBZkPKt.js";
 export { MatrixClient, matrixPlugin, setMatrixRuntime };

package/dist/{thread-bindings-DpAW-FD_.js → thread-bindings-CLjJrThw.js}

@@ -1,6 +1,6 @@
 import { a as listBindingsForAccount, c as resolveBindingKey, f as setMatrixThreadBindingManagerEntry, h as toSessionBindingRecord, l as resolveEffectiveBindingExpiry, m as toMatrixBindingTargetKind, o as removeBindingRecord, r as getMatrixThreadBindingManagerEntry, t as deleteMatrixThreadBindingManagerEntry, u as setBindingRecord } from "./thread-bindings-shared-CKnY4LSd.js";
 import { i as resolveMatrixStateFilePath, t as claimCurrentTokenStorageState } from "./storage-onzulLbU.js";
-import { a as sendMessageMatrix } from "./send-DiYHONuz.js";
+import { a as sendMessageMatrix } from "./send-DivaFHb1.js";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { registerSessionBindingAdapter, resolveThreadBindingFarewellText, unregisterSessionBindingAdapter } from "openclaw/plugin-sdk/thread-bindings-session-runtime";
 import path from "node:path";

package/dist/{tool-actions.runtime-B0cTgnsO.js → tool-actions.runtime-Vky1krcK.js}

@@ -1,12 +1,12 @@
 import { c as resolveMatrixAccountConfig } from "./config-paths-ZBCMwSos.js";
-import "./setup-core-DiRWksVZ.js";
-import { E as parsePollStart, T as isPollStartType, b as buildPollResponseContent, i as reactMatrixMessage, u as resolveMatrixRoomId } from "./send-DiYHONuz.js";
+import "./setup-core-s8s_Qudu.js";
+import { E as parsePollStart, T as isPollStartType, b as buildPollResponseContent, i as reactMatrixMessage, u as resolveMatrixRoomId } from "./send-DivaFHb1.js";
 import { i as buildMatrixReactionRelationsPath, o as selectOwnMatrixReactionEventIds, s as summarizeMatrixReactionEvents } from "./reaction-common-DkrQdBSZ.js";
-import { n as withResolvedActionClient, r as withResolvedRoomAction } from "./client-DLpRIMeD.js";
-import { a as fetchEventSummary, c as resolveMatrixActionLimit, i as sendMatrixMessage, n as editMatrixMessage, o as readPinnedEvents, r as readMatrixMessages, s as EventType, t as deleteMatrixMessage } from "./messages-D_zHS_2K.js";
-import { a as jsonResult, c as readStringArrayParam, l as readStringParam, o as readNumberParam, r as createActionGate, s as readReactionParams } from "./runtime-api-CtNLoJ_E.js";
-import { t as applyMatrixProfileUpdate } from "./profile-update-Esnq0p93.js";
-import { _ as scanMatrixVerificationQr, a as confirmMatrixVerificationSas, b as verifyMatrixRecoveryKey, c as getMatrixRoomKeyBackupStatus, d as listMatrixVerifications, f as mismatchMatrixVerificationSas, h as restoreMatrixRoomKeyBackup, i as confirmMatrixVerificationReciprocateQr, l as getMatrixVerificationSas, n as bootstrapMatrixVerification, o as generateMatrixVerificationQr, p as requestMatrixVerification, r as cancelMatrixVerification, s as getMatrixEncryptionStatus, t as acceptMatrixVerification, u as getMatrixVerificationStatus, v as startMatrixVerification } from "./verification-CVQiUQ9Y.js";
+import { n as withResolvedActionClient, r as withResolvedRoomAction } from "./client-BgsOzckO.js";
+import { a as fetchEventSummary, c as resolveMatrixActionLimit, i as sendMatrixMessage, n as editMatrixMessage, o as readPinnedEvents, r as readMatrixMessages, s as EventType, t as deleteMatrixMessage } from "./messages-D-VxmWkC.js";
+import { a as jsonResult, c as readStringArrayParam, l as readStringParam, o as readNumberParam, r as createActionGate, s as readReactionParams } from "./runtime-api-B-jlPE4A.js";
+import { t as applyMatrixProfileUpdate } from "./profile-update-B_LpeC8E.js";
+import { _ as scanMatrixVerificationQr, a as confirmMatrixVerificationSas, b as verifyMatrixRecoveryKey, c as getMatrixRoomKeyBackupStatus, d as listMatrixVerifications, f as mismatchMatrixVerificationSas, h as restoreMatrixRoomKeyBackup, i as confirmMatrixVerificationReciprocateQr, l as getMatrixVerificationSas, n as bootstrapMatrixVerification, o as generateMatrixVerificationQr, p as requestMatrixVerification, r as cancelMatrixVerification, s as getMatrixEncryptionStatus, t as acceptMatrixVerification, u as getMatrixVerificationStatus, v as startMatrixVerification } from "./verification-Dar6QON4.js";
 import { normalizeOptionalLowercaseString, uniqueStrings, uniqueValues } from "openclaw/plugin-sdk/string-coerce-runtime";
 //#region extensions/matrix/src/matrix/actions/polls.ts
 function normalizeOptionIndexes(indexes) {

package/dist/{verification-CVQiUQ9Y.js → verification-Dar6QON4.js}

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
-import { i as withStartedActionClient, n as withResolvedActionClient } from "./client-DLpRIMeD.js";
+import { i as withStartedActionClient, n as withResolvedActionClient } from "./client-BgsOzckO.js";
 import { n as formatMatrixEncryptionUnavailableError } from "./encryption-guidance-CU-OAPMg.js";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { requireRuntimeConfig } from "openclaw/plugin-sdk/plugin-config-runtime";

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@openclaw/matrix",
-  "version": "2026.5.26",
+  "version": "2026.5.27-beta.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@openclaw/matrix",
-      "version": "2026.5.26",
+      "version": "2026.5.27-beta.1",
       "dependencies": {
         "@matrix-org/matrix-sdk-crypto-nodejs": "0.4.0",
         "@matrix-org/matrix-sdk-crypto-wasm": "18.3.0",
@@ -18,7 +18,7 @@
         "zod": "4.4.3"
       },
       "peerDependencies": {
-        "openclaw": ">=2026.5.26"
+        "openclaw": ">=2026.5.27-beta.1"
       },
       "peerDependenciesMeta": {
         "openclaw": {

package/openclaw.plugin.json

@@ -1,5 +1,7 @@
 {
   "id": "matrix",
+  "name": "Matrix",
+  "description": "OpenClaw Matrix channel plugin for rooms and direct messages.",
   "commandAliases": [
     {
       "name": "matrix"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@openclaw/matrix",
-  "version": "2026.5.26",
-  "description": "OpenClaw Matrix channel plugin",
+  "version": "2026.5.27-beta.1",
+  "description": "OpenClaw Matrix channel plugin for rooms and direct messages.",
   "repository": {
     "type": "git",
     "url": "https://github.com/openclaw/openclaw"
@@ -18,7 +18,7 @@
     "zod": "4.4.3"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.5.26"
+    "openclaw": ">=2026.5.27-beta.1"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -41,6 +41,7 @@
       "docsLabel": "matrix",
       "blurb": "open protocol; install the plugin to enable.",
       "order": 70,
+      "markdownCapable": true,
       "quickstartAllowFrom": true,
       "doctorCapabilities": {
         "dmAllowFromMode": "nestedOnly",
@@ -83,10 +84,10 @@
       "allowInvalidConfigRecovery": true
     },
     "compat": {
-      "pluginApi": ">=2026.5.26"
+      "pluginApi": ">=2026.5.27-beta.1"
     },
     "build": {
-      "openclawVersion": "2026.5.26"
+      "openclawVersion": "2026.5.27-beta.1"
     },
     "release": {
       "publishToClawHub": true,