@openclaw/matrix 2026.8.1-beta.3 → 2026.8.1

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

@@ -2,7 +2,7 @@ import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 //#region extensions/matrix/src/plugin-entry.runtime.ts
-const loadMatrixVerificationRuntime = createLazyRuntimeModule(() => import("./verification-CabtBTtB.js").then((n) => n.y));
+const loadMatrixVerificationRuntime = createLazyRuntimeModule(() => import("./verification-4vsW_WSn.js").then((n) => n.y));
 function sendError(respond, err) {
 	respond(false, { error: formatErrorMessage(err) });
 }

package/dist/probe.runtime-Bxpr1FFy.js

@@ -0,0 +1,2 @@
+import { o as createMatrixClient } from "./client-kSi51NKp.js";
+export { createMatrixClient };

package/dist/{profile-update-BQlE5s2J.js → profile-update-zXVCMg7y.js}

@@ -1,7 +1,7 @@
 import { t as getMatrixRuntime } from "./runtime-6S3DNFNv.js";
-import { n as resolveMatrixConfigPath, r as updateMatrixAccountConfig } from "./config-update-Bor_Pjsv.js";
+import { n as resolveMatrixConfigPath, r as updateMatrixAccountConfig } from "./config-update-DC0fWBxc.js";
 import { r as syncMatrixOwnProfile } from "./profile-D-Wubo0A.js";
-import { n as withResolvedActionClient } from "./client-D8XghqmX.js";
+import { n as withResolvedActionClient } from "./client-CZ_JvrO0.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-BKOLlnCo.js → reaction-events-CjVUiqcY.js}

@@ -1,5 +1,5 @@
-import { a as resolveMatrixAccountConfig } from "./account-config-BZWN9tGS.js";
-import { a as resolveMatrixThreadRootId, o as resolveMatrixThreadRouting, r as resolveMatrixInboundRoute } from "./channel-CzQw5OZN.js";
+import { a as resolveMatrixAccountConfig } from "./account-config-CRsKoMqJ.js";
+import { a as resolveMatrixThreadRootId, o as resolveMatrixThreadRouting, r as resolveMatrixInboundRoute } from "./channel-BkEcVUs_.js";
 import { a as extractMatrixReactionAnnotation } from "./reaction-common-DkrQdBSZ.js";
 import { i as resolveMatrixApprovalReactionTargetWithPersistence, o as unregisterMatrixApprovalReactionTargetsForApproval } from "./approval-reactions-tXh9KYrW.js";
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
@@ -7,9 +7,9 @@ import { isApprovalNotFoundError } from "openclaw/plugin-sdk/error-runtime";
 import { normalizeAccountId } from "openclaw/plugin-sdk/routing";
 import { getSessionBindingService } from "openclaw/plugin-sdk/session-binding-runtime";
 //#region extensions/matrix/src/matrix/monitor/reaction-events.ts
-const loadApprovalReactionAuth = createLazyRuntimeModule(() => import("./approval-reaction-auth-CziKXatm.js"));
+const loadApprovalReactionAuth = createLazyRuntimeModule(() => import("./approval-reaction-auth-BDONXxnF.js"));
 const loadExecApprovalResolver = createLazyRuntimeModule(() => import("openclaw/plugin-sdk/approval-gateway-runtime"));
-const loadMatrixSend = createLazyRuntimeModule(() => import("./send-ClHgDZLT.js").then((n) => n.s));
+const loadMatrixSend = createLazyRuntimeModule(() => import("./send-BL_iH5Ox.js").then((n) => n.s));
 function buildMatrixApprovalTerminalText(result) {
 	const approval = result.approval;
 	const terminalLabel = approval.status === "allowed" ? approval.decision === "allow-always" ? "Allowed always" : "Allowed once" : approval.status === "denied" ? "Denied" : approval.status === "expired" ? "Expired" : "Cancelled";
@@ -93,7 +93,7 @@ async function maybeResolveMatrixApprovalReaction(params) {
 			return true;
 		}
 		params.logVerboseMessage(`matrix: approval reaction failed id=${params.target.approvalId} sender=${params.senderId}: ${String(err)}`);
-		return true;
+		throw err;
 	}
 }
 async function handleInboundMatrixReaction(params) {

package/dist/{resolve-targets-e7AI0P75.js → resolve-targets-qG6gceps.js}

@@ -1,6 +1,6 @@
 import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
 import { r as normalizeMatrixMessagingTarget, t as isMatrixQualifiedUserId } from "./target-ids-Nwx7cMVE.js";
-import { n as listMatrixDirectoryGroupsLive, r as listMatrixDirectoryPeersLive } from "./directory-live-DLQzel12.js";
+import { n as listMatrixDirectoryGroupsLive, r as listMatrixDirectoryPeersLive } from "./directory-live-DKr0w35b.js";
 import { normalizeOptionalLowercaseString } from "openclaw/plugin-sdk/string-coerce-runtime";
 //#region extensions/matrix/src/resolve-targets.ts
 var resolve_targets_exports = /* @__PURE__ */ __exportAll({ resolveMatrixTargets: () => resolveMatrixTargets });

package/dist/{resolver.runtime-V8u0pHEb.js → resolver.runtime-zX3TR3TN.js}

@@ -1,4 +1,4 @@
-import { t as resolveMatrixTargets } from "./resolve-targets-e7AI0P75.js";
+import { t as resolveMatrixTargets } from "./resolve-targets-qG6gceps.js";
 //#region extensions/matrix/src/resolver.runtime.ts
 const matrixResolverRuntime = { resolveMatrixTargets };
 //#endregion

package/dist/{room-info-BXQA7y10.js → room-info-yheP1mod.js}

@@ -1,3 +1,6 @@
+import { b as resolveMatrixRoomId } from "./send-BL_iH5Ox.js";
+import { s as EventType } from "./messages-DaGRt-tu.js";
+import { n as withResolvedActionClient, r as withResolvedRoomAction } from "./client-CZ_JvrO0.js";
 import { n as isMatrixNotFoundError } from "./errors-DKVS3_DO.js";
 //#region extensions/matrix/src/matrix/monitor/bounded-cache.ts
 function setBoundedMap(map, key, value, maxEntries) {
@@ -7,6 +10,57 @@ function setBoundedMap(map, key, value, maxEntries) {
 	if (!oldest.done) map.delete(oldest.value);
 }
 //#endregion
+//#region extensions/matrix/src/matrix/actions/room.ts
+async function getMatrixMemberInfo(userId, opts) {
+	return await withResolvedActionClient(opts, async (client) => {
+		const roomId = await resolveMatrixRoomId(client, opts.roomId);
+		if (!(await client.getJoinedRoomMembers(roomId)).includes(userId)) throw new Error(`User ${userId} is not a member of room ${roomId}`);
+		const profile = await client.getUserProfile(userId);
+		return {
+			userId,
+			profile: {
+				displayName: profile?.displayname ?? null,
+				avatarUrl: profile?.avatar_url ?? null
+			},
+			membership: null,
+			powerLevel: null,
+			displayName: profile?.displayname ?? null,
+			roomId
+		};
+	});
+}
+async function getMatrixRoomInfo(roomId, opts = {}) {
+	return await withResolvedRoomAction(roomId, opts, async (client, resolvedRoom) => {
+		let name = null;
+		let topic = null;
+		let canonicalAlias = null;
+		let memberCount = null;
+		try {
+			const nameState = await client.getRoomStateEvent(resolvedRoom, "m.room.name", "");
+			name = typeof nameState?.name === "string" ? nameState.name : null;
+		} catch {}
+		try {
+			const topicState = await client.getRoomStateEvent(resolvedRoom, EventType.RoomTopic, "");
+			topic = typeof topicState?.topic === "string" ? topicState.topic : null;
+		} catch {}
+		try {
+			const aliasState = await client.getRoomStateEvent(resolvedRoom, "m.room.canonical_alias", "");
+			canonicalAlias = typeof aliasState?.alias === "string" ? aliasState.alias : null;
+		} catch {}
+		try {
+			memberCount = (await client.getJoinedRoomMembers(resolvedRoom)).length;
+		} catch {}
+		return {
+			roomId: resolvedRoom,
+			name,
+			topic,
+			canonicalAlias,
+			altAliases: [],
+			memberCount
+		};
+	});
+}
+//#endregion
 //#region extensions/matrix/src/matrix/monitor/room-info.ts
 const MAX_ROOM_INFO = 1024;
 const MAX_MEMBER_DISPLAY_NAMES = 4096;
@@ -93,4 +147,4 @@ function createMatrixRoomInfoResolver(client) {
 	};
 }
 //#endregion
-export { setBoundedMap as n, createMatrixRoomInfoResolver as t };
+export { setBoundedMap as i, getMatrixMemberInfo as n, getMatrixRoomInfo as r, createMatrixRoomInfoResolver as t };

package/dist/runtime-api.js

@@ -1,4 +1,4 @@
-import { a as resolveMatrixDefaultOrOnlyAccountId, i as resolveMatrixChannelConfig, n as requiresExplicitMatrixDefaultAccount, o as resolveMatrixAccountStringValues, r as resolveConfiguredMatrixAccountIds, t as findMatrixAccountEntry } from "./account-selection-CWuhuFn1.js";
+import { a as resolveMatrixDefaultOrOnlyAccountId, i as resolveMatrixChannelConfig, l as resolveMatrixAccountStringValues, n as requiresExplicitMatrixDefaultAccount, r as resolveConfiguredMatrixAccountIds, t as findMatrixAccountEntry } from "./account-selection-C8nnBTxi.js";
 import { n as listMatrixEnvAccountIds, r as resolveMatrixEnvAccountToken, t as getMatrixScopedEnvVarNames } from "./env-vars-dGqak9dN.js";
 import { r as setMatrixRuntime } from "./runtime-6S3DNFNv.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";

package/dist/{sdk-NxK3vzMa.js → sdk-TZYyo0XQ.js}

@@ -3,8 +3,9 @@ import { t as SqliteBackedMatrixSyncStore } from "./file-sync-store-DjskBX2o.js"
 import { n as LogService, r as noop, t as ConsoleLogger } from "./logger-B_71hN6W.js";
 import { t as MATRIX_IDB_PERSIST_INTERVAL_MS } from "./idb-persistence-lock-DAJ49nZX.js";
 import { n as isMatrixNotFoundError, t as formatMatrixErrorReason } from "./errors-DKVS3_DO.js";
-import { a as throwIfMatrixStartupAborted, r as createMatrixStartupAbortError } from "./client-BBQdBG7t.js";
-import { a as matrixEventToRaw, n as createMatrixGuardedFetch, o as parseMxc, t as MatrixAuthedHttpClient } from "./http-client-CycYxU9-.js";
+import { a as throwIfMatrixStartupAborted, r as createMatrixStartupAbortError } from "./client-kSi51NKp.js";
+import { n as matrixEventToRaw, r as parseMxc } from "./event-helpers-XRfAbOIh.js";
+import { n as createMatrixGuardedFetch, t as MatrixAuthedHttpClient } from "./http-client-D8o8b9u6.js";
 import { n as resolveMatrixRoomKeyBackupReadinessError } from "./backup-health-Dm_YMVFT.js";
 import { t as createMatrixJsSdkClientLogger } from "./logging-DRjvUOIh.js";
 import { a as isMatrixAccessTokenInvalidatedError, c as resolveMatrixLocalTimeoutMs, f as isMatrixReadySyncState, i as createMatrixExplicitBootstrapOptions, l as unresolvedMatrixDeviceVerificationStatus, n as MATRIX_INITIAL_CRYPTO_BOOTSTRAP_OPTIONS, o as resolveMatrixDiagnostic, p as isMatrixTerminalSyncState, r as MATRIX_STATUS_DIAGNOSTIC_TIMEOUT_MS, s as resolveMatrixDiagnosticResult, t as MATRIX_AUTOMATIC_REPAIR_BOOTSTRAP_OPTIONS, u as unresolvedMatrixRoomKeyBackupStatus } from "./client-support-DLj4vDeu.js";
@@ -17,6 +18,7 @@ import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { KeyedAsyncQueue } from "openclaw/plugin-sdk/keyed-async-queue";
 import { ClientEvent, EventType, Filter, MatrixError, MatrixEventEvent, MsgType, Preset, createClient } from "matrix-js-sdk/lib/matrix.js";
 import { EventEmitter } from "node:events";
+import { RoomEvent } from "matrix-js-sdk/lib/models/room.js";
 import { VerificationMethod } from "matrix-js-sdk/lib/types.js";
 import { SyncApi, SyncState } from "matrix-js-sdk/lib/sync.js";
 import { EventStatus } from "matrix-js-sdk/lib/models/event-status.js";
@@ -65,6 +67,13 @@ async function listMatrixOwnDevices(client) {
 //#endregion
 //#region extensions/matrix/src/matrix/sdk/client-event-bridge.ts
 function registerMatrixClientBridge(params) {
+	let initialSyncComplete = false;
+	const joinTransitions = /* @__PURE__ */ new WeakSet();
+	params.client.on(RoomEvent.MyMembership, (room, membership, previousMembership) => {
+		if (!initialSyncComplete || membership !== "join" || previousMembership === "join") return;
+		const event = room.currentState.getStateEvents("m.room.member", params.getSelfUserId());
+		if (event) joinTransitions.add(event);
+	});
 	params.client.on(ClientEvent.Event, (event) => {
 		const roomId = event.getRoomId();
 		if (!roomId) return;
@@ -78,12 +87,16 @@ function registerMatrixClientBridge(params) {
 		const membership = raw.type === "m.room.member" ? raw.content.membership : void 0;
 		if (stateKey && selfUserId && stateKey === selfUserId) {
 			if (membership === "invite") params.emitter.emit("room.invite", roomId, raw);
-			else if (membership === "join") params.emitter.emit("room.join", roomId, raw);
+			else if (membership === "join") params.emitter.emit("room.join", roomId, {
+				...raw,
+				membershipProvenance: joinTransitions.delete(event) ? "transition" : initialSyncComplete ? "update" : "snapshot"
+			});
 		}
 		if (isEncryptedEvent) params.decryptBridge.attachEncryptedEvent(event, roomId);
 	});
 	params.client.on(ClientEvent.Room, params.emitMembershipForRoom);
 	params.client.on(ClientEvent.Sync, (state, prevState, data) => {
+		initialSyncComplete ||= state === "PREPARED" || state === "SYNCING";
 		const error = data && typeof data === "object" && "error" in data ? data.error : void 0;
 		params.setCurrentSyncState(state, error);
 		params.emitter.emit("sync.state", state, prevState, error);
@@ -103,7 +116,8 @@ function emitMatrixMembershipForRoom(params) {
 		state_key: params.selfUserId,
 		content: { membership },
 		origin_server_ts: Date.now(),
-		unsigned: { age: 0 }
+		unsigned: { age: 0 },
+		membershipProvenance: "snapshot"
 	};
 	if (membership === "invite") {
 		params.emitter.emit("room.invite", roomId, raw);
@@ -123,7 +137,7 @@ function refreshMatrixDmRoomIds(direct, dmRoomIds) {
 //#endregion
 //#region extensions/matrix/src/matrix/sdk/client-sync-quiesce.ts
 const MATRIX_SYNC_QUIESCE_TIMEOUT_MS = 5e3;
-const MATRIX_JS_SDK_SYNC_VERSION = "41.9.0";
+const MATRIX_JS_SDK_SYNC_VERSION = "42.2.0";
 const matrixJsSdkPackage = createRequire(import.meta.url)("matrix-js-sdk/package.json");
 function requireMatrixClassicSyncInternals(syncApi) {
 	return syncApi;
@@ -207,7 +221,7 @@ function resolveMessageWireDispatch(resource, init) {
 	};
 }
 let loadedMatrixCryptoRuntime = null;
-const loadMatrixCryptoRuntime = createLazyRuntimeModule(() => import("./crypto-runtime-Bnz3zEcS.js").then((runtime) => {
+const loadMatrixCryptoRuntime = createLazyRuntimeModule(() => import("./crypto-runtime-C4WDYxlP.js").then((runtime) => {
 	loadedMatrixCryptoRuntime = runtime;
 	return runtime;
 }));
@@ -229,6 +243,9 @@ var MatrixClientBase = class {
 		this.transactionScopePromise = null;
 		this.messageWireDispatchGuards = /* @__PURE__ */ new Map();
 		this.sdkStopped = false;
+		this.stopDiscardPromise = null;
+		this.idbPersistPromise = null;
+		this.idbPersistAbortController = null;
 		this.dms = {
 			update: async () => {
 				return await this.refreshDmCache();
@@ -433,6 +450,7 @@ var MatrixClientBase = class {
 		throwIfMatrixStartupAborted(opts.abortSignal);
 		this.registerBridge();
 		await this.initializeCryptoIfNeeded(opts.abortSignal);
+		throwIfMatrixStartupAborted(opts.abortSignal);
 		await this.client.startClient({
 			initialSyncLimit: this.initialSyncLimit,
 			...this.syncFilter ? { filter: Filter.fromJson(this.selfUserId, "", this.syncFilter) } : {}
@@ -467,10 +485,6 @@ var MatrixClientBase = class {
 	}
 	stopSdkClient() {
 		if (this.sdkStopped) return;
-		if (this.idbPersistTimer) {
-			clearInterval(this.idbPersistTimer);
-			this.idbPersistTimer = null;
-		}
 		this.currentSyncState = null;
 		this.currentSyncError = void 0;
 		this.client.stopClient();
@@ -495,15 +509,22 @@ var MatrixClientBase = class {
 	stop() {
 		this.stopAndPersist().catch(() => this.stopWithoutPersist()).catch(noop);
 	}
-	async stopAndPersist() {
-		if (this.stopPersistPromise) {
-			await this.stopPersistPromise;
-			return;
+	async stopClientGeneration(persist) {
+		if (persist) await this.quiesceSync();
+		else {
+			await this.quiesceSync().catch(noop);
+			this.syncStore?.discardPendingSyncCursorPersistence();
+		}
+		if (this.idbPersistTimer) {
+			clearInterval(this.idbPersistTimer);
+			this.idbPersistTimer = null;
 		}
-		this.stopPersistPromise = (async () => {
-			await this.quiesceSync();
-			this.stopSdkClient();
-			this.decryptBridge?.stop();
+		this.idbPersistAbortController?.abort();
+		const activePeriodicPersist = this.idbPersistPromise;
+		this.stopSdkClient();
+		this.decryptBridge?.stop();
+		await activePeriodicPersist;
+		if (persist) {
 			await (loadedMatrixCryptoRuntime ?? await loadMatrixCryptoRuntime()).persistIdbToDisk({
 				snapshotPath: this.idbSnapshotPath,
 				databasePrefix: this.cryptoDatabasePrefix,
@@ -511,14 +532,15 @@ var MatrixClientBase = class {
 			});
 			this.syncStore?.markCleanShutdown();
 			await this.syncStore?.flush();
-		})();
+		}
+	}
+	async stopAndPersist() {
+		this.stopPersistPromise ??= this.stopClientGeneration(true);
 		await this.stopPersistPromise;
 	}
 	stopWithoutPersist() {
-		this.syncStore?.discardPendingSyncCursorPersistence();
-		this.stopSdkClient();
-		this.decryptBridge?.stop();
-		this.stopPersistPromise = Promise.resolve();
+		if (!this.stopPersistPromise) this.stopPersistPromise = this.stopDiscardPromise = this.stopClientGeneration(false);
+		return this.stopDiscardPromise ??= this.stopPersistPromise.catch(() => this.stopClientGeneration(false));
 	}
 	async bootstrapCryptoIfNeeded(abortSignal) {
 		if (!this.encryptionEnabled || !this.cryptoInitialized || this.cryptoBootstrapped) return;
@@ -552,17 +574,26 @@ var MatrixClientBase = class {
 			throwIfMatrixStartupAborted(abortSignal);
 			await persistIdbToDisk({
 				snapshotPath: this.idbSnapshotPath,
-				databasePrefix: this.cryptoDatabasePrefix
+				databasePrefix: this.cryptoDatabasePrefix,
+				abortSignal
 			});
 			throwIfMatrixStartupAborted(abortSignal);
 			this.idbPersistTimer = setInterval(() => {
-				persistIdbToDisk({
+				if (this.idbPersistPromise) return;
+				const abortController = new AbortController();
+				this.idbPersistAbortController = abortController;
+				this.idbPersistPromise = persistIdbToDisk({
 					snapshotPath: this.idbSnapshotPath,
-					databasePrefix: this.cryptoDatabasePrefix
-				}).catch(noop);
+					databasePrefix: this.cryptoDatabasePrefix,
+					abortSignal: abortController.signal
+				}).catch(noop).finally(() => {
+					this.idbPersistPromise = null;
+					this.idbPersistAbortController = null;
+				});
 			}, MATRIX_IDB_PERSIST_INTERVAL_MS);
 			this.idbPersistTimer.unref?.();
 		} catch (err) {
+			throwIfMatrixStartupAborted(abortSignal);
 			LogService.warn("MatrixClientLite", "Failed to initialize rust crypto:", err);
 		}
 	}

package/dist/{send-ClHgDZLT.js → send-BL_iH5Ox.js}

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
-import { a as resolveMatrixAccountConfig } from "./account-config-BZWN9tGS.js";
+import { a as resolveMatrixAccountConfig } from "./account-config-CRsKoMqJ.js";
 import { t as getMatrixRuntime } from "./runtime-6S3DNFNv.js";
 import { i as normalizeMatrixResolvableTarget, t as isMatrixQualifiedUserId } from "./target-ids-Nwx7cMVE.js";
 import { n as MATRIX_REACTION_EVENT_TYPE, r as buildMatrixReactionContent, t as MATRIX_ANNOTATION_RELATION_TYPE } from "./reaction-common-DkrQdBSZ.js";
@@ -19,7 +19,7 @@ import { isAutoLinkedFileRef } from "openclaw/plugin-sdk/text-autolink-runtime";
 import { isVoiceMessageCompatibleAudio } from "openclaw/plugin-sdk/media-runtime";
 import { parseBuffer } from "music-metadata";
 //#region extensions/matrix/src/matrix/send/client.ts
-const loadMatrixSendClientRuntime = createLazyRuntimeModule(() => import("./client-bootstrap-Co3RlItb.js").then((n) => n.t));
+const loadMatrixSendClientRuntime = createLazyRuntimeModule(() => import("./client-bootstrap-D8irSL2i.js").then((n) => n.t));
 function resolveMediaMaxBytes(accountId, cfg) {
 	if (!cfg) throw new Error("Matrix media limits requires a resolved runtime config. Load and resolve config at the command or gateway boundary, then pass cfg through the runtime path.");
 	const mediaMaxMb = resolveMatrixAccountConfig({
@@ -890,6 +890,7 @@ const spoilerParser = new MarkdownIt({
 	linkify: true,
 	typographer: false
 });
+spoilerParser.linkify.set({ fuzzyLink: true });
 function findInlineMetadataRanges(markdown, references) {
 	const ranges = [];
 	const labelStack = [];
@@ -1066,9 +1067,9 @@ const md = new MarkdownIt({
 	breaks: true,
 	typographer: false
 });
+md.linkify.set({ fuzzyLink: true });
 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 = 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 = /[),.!?:;\]]/;
@@ -1096,7 +1097,7 @@ md.core.ruler.after("inline", "matrix_spoilers", (state) => {
 function shouldSuppressAutoLink(tokens, idx) {
 	const token = tokens[idx];
 	if (token?.type !== "link_open" || token.info !== "auto") return false;
-	const href = token.attrGet("href") ?? "";
+	const href = String(token.attrGet("href") ?? "");
 	const label = tokens[idx + 1]?.type === "text" ? tokens[idx + 1]?.content ?? "" : "";
 	return Boolean(href && label && isAutoLinkedFileRef(href, label));
 }
@@ -1106,6 +1107,7 @@ md.renderer.rules.image = (tokens, idx, options, env, self) => {
 };
 md.renderer.rules.html_block = (tokens, idx) => escapeHtml(tokens[idx]?.content ?? "");
 md.renderer.rules.html_inline = (tokens, idx) => escapeHtml(tokens[idx]?.content ?? "");
+md.renderer.rules.text_special = (tokens, idx) => escapeHtml(tokens[idx]?.content ?? "");
 md.renderer.rules.link_open = (tokens, idx, _options, _env, self) => shouldSuppressAutoLink(tokens, idx) ? "" : self.renderToken(tokens, idx, _options);
 md.renderer.rules.link_close = (tokens, idx, _options, _env, self) => {
 	const openIdx = idx - 2;
@@ -1116,6 +1118,8 @@ function maskEscapedMentions(markdown) {
 	let masked = "";
 	let idx = 0;
 	let codeFenceLength = 0;
+	let marker;
+	const metadataRanges = markdown.includes("\\@") ? findMatrixMarkdownMetadataRanges(markdown) : [];
 	while (idx < markdown.length) {
 		if (markdown[idx] === "`" && !isMarkdownEscaped(markdown, idx)) {
 			let runLength = 1;
@@ -1126,24 +1130,26 @@ function maskEscapedMentions(markdown) {
 			idx += runLength;
 			continue;
 		}
-		if (codeFenceLength === 0 && markdown[idx] === "\\" && markdown[idx + 1] === "@") {
-			masked += ESCAPED_MENTION_SENTINEL;
+		if (codeFenceLength === 0 && markdown[idx] === "\\" && markdown[idx + 1] === "@" && !metadataRanges.some((range) => idx >= range.start && idx < range.end)) {
+			marker ??= createMatrixPrivateMarkers(markdown, "Matrix mention formatting exhausted its private marker pool").open;
+			masked += marker;
 			idx += 2;
 			continue;
 		}
 		masked += markdown[idx] ?? "";
 		idx += 1;
 	}
-	return masked;
-}
-function restoreEscapedMentions(text) {
-	return text.replaceAll(ESCAPED_MENTION_SENTINEL, "@");
+	return {
+		markdown: masked,
+		...marker ? { marker } : {}
+	};
 }
-function restoreEscapedMentionsInCode(text) {
-	return text.replaceAll(ESCAPED_MENTION_SENTINEL, "\\@");
+function restoreEscapedMentions(text, marker, inCode = false) {
+	return marker ? text.replaceAll(marker, inCode ? "\\@" : "@") : text;
 }
-function restoreEscapedMentionsInBlockTokens(tokens) {
-	for (const token of tokens) if ((token.type === "fence" || token.type === "code_block") && token.content) token.content = restoreEscapedMentionsInCode(token.content);
+function restoreEscapedMentionsInBlockTokens(tokens, marker) {
+	if (!marker) return;
+	for (const token of tokens) if ((token.type === "fence" || token.type === "code_block") && token.content) token.content = restoreEscapedMentions(token.content, marker, true);
 }
 function isMentionStartBoundary(charBefore) {
 	return !charBefore || !/[A-Za-z0-9_]/.test(charBefore);
@@ -1286,6 +1292,7 @@ async function resolveMatrixSelfUserId(client) {
 }
 function mutateInlineTokensWithMentions(params) {
 	const nextChildren = [];
+	const restoreMention = (text) => restoreEscapedMentions(text, params.escapedMentionMarker);
 	let roomMentioned = false;
 	let insideLinkDepth = 0;
 	for (const child of params.children) {
@@ -1300,10 +1307,11 @@ function mutateInlineTokensWithMentions(params) {
 			continue;
 		}
 		if (child.type !== "text" || !child.content) {
+			for (const nested of child.children ?? []) nested.content = restoreMention(nested.content);
 			nextChildren.push(child);
 			continue;
 		}
-		const visibleContent = restoreEscapedMentions(child.content);
+		const visibleContent = restoreMention(child.content);
 		if (insideLinkDepth > 0) {
 			nextChildren.push(createTextToken(child, visibleContent));
 			continue;
@@ -1315,7 +1323,7 @@ function mutateInlineTokensWithMentions(params) {
 		}
 		let cursor = 0;
 		for (const match of matches) {
-			if (match.start > cursor) nextChildren.push(createTextToken(child, restoreEscapedMentions(child.content.slice(cursor, match.start))));
+			if (match.start > cursor) nextChildren.push(createTextToken(child, restoreMention(child.content.slice(cursor, match.start))));
 			cursor = match.end;
 			if (match.kind === "room") {
 				roomMentioned = true;
@@ -1337,7 +1345,7 @@ function mutateInlineTokensWithMentions(params) {
 				label: match.raw
 			}));
 		}
-		if (cursor < child.content.length) nextChildren.push(createTextToken(child, restoreEscapedMentions(child.content.slice(cursor))));
+		if (cursor < child.content.length) nextChildren.push(createTextToken(child, restoreMention(child.content.slice(cursor))));
 	}
 	return {
 		children: nextChildren,
@@ -1432,8 +1440,9 @@ function renderMatrixFallbackHtml(markdown) {
 	return `<p>${escapeHtml(markdownToMatrixBody(markdown)).replaceAll("\n", "<br>\n")}</p>`;
 }
 async function resolveMarkdownMentionState(params) {
-	const tokens = parseMatrixMarkdown(maskEscapedMentions(projectMatrixMarkdown(params.markdown)), params.tableMode);
-	restoreEscapedMentionsInBlockTokens(tokens);
+	const { markdown, marker } = maskEscapedMentions(projectMatrixMarkdown(params.markdown));
+	const tokens = parseMatrixMarkdown(markdown, params.tableMode);
+	restoreEscapedMentionsInBlockTokens(tokens, marker);
 	const selfUserId = await resolveMatrixSelfUserId(params.client);
 	const userIds = [];
 	const seenUserIds = /* @__PURE__ */ new Set();
@@ -1444,7 +1453,8 @@ async function resolveMarkdownMentionState(params) {
 			children: token.children,
 			userIds,
 			seenUserIds,
-			selfUserId
+			selfUserId,
+			escapedMentionMarker: marker
 		});
 		token.children = mutated.children;
 		roomMentioned ||= mutated.roomMentioned;
@@ -1594,10 +1604,12 @@ function prepareMatrixSingleText(text, opts) {
 	});
 	const convertedText = renderMatrixMarkdownTables(trimmedText, tableMode);
 	const singleEventLimit = normalizeMatrixEventLimit(Math.min(getCore$2().channel.text.resolveTextChunkLimit(cfg, "matrix", opts.accountId), MATRIX_FORMAT_PROFILE.chunk.limit));
-	const eventTextLength = Math.max(convertedText.length, markdownToMatrixBody(convertedText).length);
+	const preparedBody = markdownToMatrixBody(convertedText);
+	const eventTextLength = Math.max(convertedText.length, preparedBody.length);
 	return {
 		trimmedText,
 		convertedText,
+		preparedBody,
 		singleEventLimit,
 		eventTextLength,
 		fitsInSingleEvent: eventTextLength <= singleEventLimit,
@@ -1648,7 +1660,7 @@ function chunkMatrixText(text, opts) {
 const getCore$1 = () => getMatrixRuntime();
 async function renderMatrixFormattedContent(params) {
 	const markdown = params.markdown ?? "";
-	const body = markdownToMatrixBody(markdown);
+	const body = params.preparedBody ?? markdownToMatrixBody(markdown);
 	if (params.includeMentions === false) return {
 		body,
 		html: markdownToMatrixHtml(markdown, { tableMode: params.tableMode }).trimEnd() || void 0
@@ -1679,6 +1691,7 @@ async function enrichMatrixFormattedContent(params) {
 	const { body, html, mentions } = await renderMatrixFormattedContent({
 		client: params.client,
 		markdown: params.markdown,
+		preparedBody: params.preparedBody,
 		includeMentions: params.includeMentions,
 		tableMode: params.tableMode
 	});
@@ -2014,11 +2027,12 @@ async function sendMessageMatrix(to, message, opts) {
 			wireEventType
 		}) : null)?.events;
 		if (!plannedEvents) {
-			const { chunks, tableMode } = chunkMatrixText(messageText, {
+			const { chunks, convertedText, preparedBody, fitsInSingleEvent, tableMode } = chunkMatrixText(messageText, {
 				cfg,
 				accountId: opts.accountId,
 				preserveWhitespace: true
 			});
+			const singleEventBody = fitsInSingleEvent ? preparedBody : void 0;
 			const relation = threadId ? buildThreadRelation(threadId, opts.replyToId) : buildReplyRelation(opts.replyToId);
 			let pendingExtraContent = opts.extraContent;
 			const events = [];
@@ -2079,6 +2093,7 @@ async function sendMessageMatrix(to, message, opts) {
 					client,
 					content,
 					markdown: captionMarkdown,
+					preparedBody: captionMarkdown === convertedText ? singleEventBody : void 0,
 					tableMode
 				});
 				prepareContent(content, receiptKind);
@@ -2091,6 +2106,7 @@ async function sendMessageMatrix(to, message, opts) {
 						client,
 						content: followup,
 						markdown: chunk,
+						preparedBody: chunk === convertedText ? singleEventBody : void 0,
 						tableMode
 					});
 					prepareContent(followup, "text");
@@ -2102,6 +2118,7 @@ async function sendMessageMatrix(to, message, opts) {
 					client,
 					content,
 					markdown: chunk,
+					preparedBody: chunk === convertedText ? singleEventBody : void 0,
 					tableMode
 				});
 				prepareContent(content, "text");
@@ -2230,7 +2247,7 @@ async function sendReadReceiptMatrix(roomId, eventId, client) {
 	});
 }
 async function sendSingleTextMessageMatrix(roomId, text, opts) {
-	const { trimmedText, convertedText, singleEventLimit, eventTextLength, fitsInSingleEvent, tableMode } = prepareMatrixSingleText(text.trimEnd(), {
+	const { trimmedText, convertedText, preparedBody, singleEventLimit, eventTextLength, fitsInSingleEvent, tableMode } = prepareMatrixSingleText(text.trimEnd(), {
 		cfg: opts.cfg,
 		accountId: opts.accountId,
 		preserveWhitespace: true
@@ -2250,6 +2267,7 @@ async function sendSingleTextMessageMatrix(roomId, text, opts) {
 			client,
 			content,
 			markdown: convertedText,
+			preparedBody,
 			includeMentions: opts.includeMentions,
 			tableMode
 		});
@@ -2286,7 +2304,7 @@ async function editMessageMatrix(roomId, originalEventId, newText, opts) {
 		timeoutMs: opts.timeoutMs
 	}, async (client) => {
 		const resolvedRoom = await resolveMatrixRoomId(client, roomId);
-		const { convertedText, tableMode } = prepareMatrixSingleText(newText, {
+		const { convertedText, preparedBody, tableMode } = prepareMatrixSingleText(newText, {
 			cfg: requireRuntimeConfig(opts.cfg, "Matrix message edit"),
 			accountId: opts.accountId,
 			preserveWhitespace: true
@@ -2296,6 +2314,7 @@ async function editMessageMatrix(roomId, originalEventId, newText, opts) {
 			client,
 			content: newContent,
 			markdown: convertedText,
+			preparedBody,
 			includeMentions: opts.includeMentions,
 			tableMode
 		});
@@ -2341,4 +2360,4 @@ async function reactMatrixMessage(roomId, messageId, emoji, opts) {
 	});
 }
 //#endregion
-export { promoteMatrixDirectRoomCandidate as C, MsgType as E, direct_management_exports as S, MATRIX_OPENCLAW_FINALIZED_PREVIEW_KEY as T, parsePollStartContent as _, sendSingleTextMessageMatrix as a, reconcileMatrixUnknownSend as b, chunkMatrixText as c, buildPollResultsSummary as d, formatPollAsText as f, parsePollStart as g, isPollStartType as h, sendPollMatrix as i, prepareMatrixSingleText as l, isPollEventType as m, reactMatrixMessage as n, sendTypingMatrix as o, formatPollResultsAsText as p, sendMessageMatrix as r, send_exports as s, editMessageMatrix as t, buildPollResponseContent as u, resolvePollReferenceEventId as v, repairMatrixDirectRooms as w, resolveMatrixRoomId as x, cleanupMatrixDeliveryPlans as y };
+export { repairMatrixDirectRooms as C, promoteMatrixDirectRoomCandidate as S, MsgType as T, resolvePollReferenceEventId as _, sendSingleTextMessageMatrix as a, resolveMatrixRoomId as b, prepareMatrixSingleText as c, formatPollAsText as d, formatPollResultsAsText as f, parsePollStartContent as g, parsePollStart as h, sendPollMatrix as i, buildPollResponseContent as l, isPollStartType as m, reactMatrixMessage as n, sendTypingMatrix as o, isPollEventType as p, sendMessageMatrix as r, send_exports as s, editMessageMatrix as t, buildPollResultsSummary as u, cleanupMatrixDeliveryPlans as v, MATRIX_OPENCLAW_FINALIZED_PREVIEW_KEY as w, direct_management_exports as x, reconcileMatrixUnknownSend as y };

package/dist/session-binding-contract-api.js

@@ -1,3 +1,3 @@
 import { r as setMatrixRuntime } from "./runtime-6S3DNFNv.js";
-import { t as createMatrixThreadBindingManager } from "./thread-bindings-BYEGfw3h.js";
+import { t as createMatrixThreadBindingManager } from "./thread-bindings-ERWNousC.js";
 export { createMatrixThreadBindingManager, setMatrixRuntime };

package/dist/{setup-bootstrap-BGPjbA5N.js → setup-bootstrap-D8M7FmcO.js}

@@ -1,6 +1,6 @@
-import { a as resolveMatrixAccountConfig, n as hasExplicitMatrixAccountConfig } from "./account-config-BZWN9tGS.js";
-import "./accounts-BCzyubQt.js";
-import { n as bootstrapMatrixVerification } from "./verification-CabtBTtB.js";
+import { a as resolveMatrixAccountConfig, n as hasExplicitMatrixAccountConfig } from "./account-config-CRsKoMqJ.js";
+import "./accounts-fC57n-Jo.js";
+import { n as bootstrapMatrixVerification } from "./verification-4vsW_WSn.js";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 //#region extensions/matrix/src/setup-bootstrap.ts
 async function maybeBootstrapNewEncryptedMatrixAccount(params) {

package/dist/{setup-core-DigrLebY.js → setup-core-r6L0nno-.js}

@@ -1,8 +1,8 @@
-import { a as resolveMatrixAccountConfig } from "./account-config-BZWN9tGS.js";
-import { n as resolveMatrixEnvAuthReadiness } from "./env-auth-MVS-Vv41.js";
-import { r as resolveDefaultMatrixAccountId } from "./accounts-BCzyubQt.js";
+import { s as resolveMatrixEnvAuthReadiness } from "./account-selection-C8nnBTxi.js";
+import { a as resolveMatrixAccountConfig } from "./account-config-CRsKoMqJ.js";
+import { r as resolveDefaultMatrixAccountId } from "./accounts-fC57n-Jo.js";
 import { t as resolveMatrixConfigFieldPath } from "./config-paths-CnREYb1Y.js";
-import { r as updateMatrixAccountConfig } from "./config-update-Bor_Pjsv.js";
+import { r as updateMatrixAccountConfig } from "./config-update-DC0fWBxc.js";
 import { t as isSupportedMatrixAvatarSource } from "./profile-D-Wubo0A.js";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { defineChannelSetupContract } from "openclaw/plugin-sdk/channel-setup";
@@ -310,7 +310,7 @@ const matrixSetupAdapter = {
 		input
 	}),
 	afterAccountConfigWritten: async ({ previousCfg, cfg, accountId, runtime }) => {
-		const { runMatrixSetupBootstrapAfterConfigWrite } = await import("./setup-bootstrap-BGPjbA5N.js");
+		const { runMatrixSetupBootstrapAfterConfigWrite } = await import("./setup-bootstrap-D8M7FmcO.js");
 		await runMatrixSetupBootstrapAfterConfigWrite({
 			previousCfg,
 			cfg,

package/dist/setup-plugin-api.js

@@ -1,2 +1,2 @@
-import { n as matrixSetupPlugin } from "./channel.setup-aNaa3Uyn.js";
+import { n as matrixSetupPlugin } from "./channel.setup-CSacbORr.js";
 export { matrixSetupPlugin };