@openclaw/matrix 2026.8.1-beta.2 → 2026.8.1-beta.3

package/dist/{client-CeGw0G5S.js → client-BBQdBG7t.js}

@@ -20,7 +20,7 @@ import { retryAsync } from "openclaw/plugin-sdk/retry-runtime";
 import { sleepWithAbort } from "openclaw/plugin-sdk/runtime-env";
 import { createDeferred } from "openclaw/plugin-sdk/extension-shared";
 //#region extensions/matrix/src/matrix/client/config.ts
-const loadMatrixAuthClientDeps = createLazyRuntimeModule(() => Promise.all([import("./sdk-DjaQFCHc.js"), import("./logging-DRjvUOIh.js").then((n) => n.n)]).then(([sdkModule, loggingModule]) => ({
+const loadMatrixAuthClientDeps = createLazyRuntimeModule(() => Promise.all([import("./sdk-NxK3vzMa.js"), import("./logging-DRjvUOIh.js").then((n) => n.n)]).then(([sdkModule, loggingModule]) => ({
 	MatrixClient: sdkModule.MatrixClient,
 	ensureMatrixSdkLoggingConfigured: loggingModule.ensureMatrixSdkLoggingConfigured
 })));
@@ -416,7 +416,7 @@ async function backfillMatrixAuthDeviceIdAfterStartup(params) {
 //#endregion
 //#region extensions/matrix/src/matrix/client/create-client.ts
 var create_client_exports = /* @__PURE__ */ __exportAll({ createMatrixClient: () => createMatrixClient });
-const loadMatrixCreateClientRuntimeDeps = createLazyRuntimeModule(() => Promise.all([import("./sdk-DjaQFCHc.js"), import("./logging-DRjvUOIh.js").then((n) => n.n)]).then(([sdkModule, loggingModule]) => ({
+const loadMatrixCreateClientRuntimeDeps = createLazyRuntimeModule(() => Promise.all([import("./sdk-NxK3vzMa.js"), import("./logging-DRjvUOIh.js").then((n) => n.n)]).then(([sdkModule, loggingModule]) => ({
 	MatrixClient: sdkModule.MatrixClient,
 	ensureMatrixSdkLoggingConfigured: loggingModule.ensureMatrixSdkLoggingConfigured
 })));
@@ -549,6 +549,9 @@ function deleteSharedClientState(state) {
 	if (sharedClientStates.get(state.key) === state) sharedClientStates.delete(state.key);
 	sharedClientPromises.delete(state.key);
 }
+function deleteSharedClientStateAfterLateDrain(state) {
+	if (state.phase === "late-drain-stopped" && state.leases.size === 0) deleteSharedClientState(state);
+}
 async function ensureSharedClientStarted(state, abortSignal) {
 	if (state.started) return;
 	if (state.startPromise) {
@@ -645,20 +648,14 @@ function mergeReleaseMode(current, requested) {
 function abortTransientLeases(state) {
 	for (const lease of state.leases) if (lease.role === "transient") lease.abortController.abort();
 }
-function forceReleaseLeases(state, releasePromise = Promise.resolve()) {
-	for (const lease of state.leases) {
-		lease.abortController.abort();
-		lease.releasePromise ??= releasePromise;
-	}
-	state.leases.clear();
-	state.noLeases.resolve();
-}
 async function waitForLeaseDrain(state) {
 	if (state.leases.size === 0) return;
 	let deadline;
 	try {
 		await Promise.race([state.noLeases.promise, new Promise((_, reject) => {
 			deadline = setTimeout(() => {
+				if (state.leases.size === 0) return;
+				state.phase = "late-drain";
 				reject(/* @__PURE__ */ new Error(`Matrix transient leases did not drain within ${MATRIX_TRANSIENT_LEASE_DRAIN_TIMEOUT_MS}ms`));
 			}, MATRIX_TRANSIENT_LEASE_DRAIN_TIMEOUT_MS);
 			deadline.unref?.();
@@ -672,6 +669,7 @@ function beginGenerationRetirement(params) {
 	if (state.retirementPromise) return state.retirementPromise;
 	state.phase = "quiescing";
 	state.retirementPromise = Promise.resolve().then(async () => {
+		let poisonDisposition = "replace-after-stop";
 		try {
 			await state.client.quiesceSync();
 			state.started = false;
@@ -683,17 +681,25 @@ function beginGenerationRetirement(params) {
 			await retireMonitorLeases(state, params.monitorLeases ?? []);
 		} catch (error) {
 			state.poisonError ??= toStringifiedError(error);
+			poisonDisposition = "retain";
 		}
 		state.phase = "closing";
 		try {
 			await waitForLeaseDrain(state);
 		} catch (error) {
 			state.poisonError ??= toStringifiedError(error);
-			forceReleaseLeases(state);
+			if (poisonDisposition !== "retain") poisonDisposition = "replace-after-late-drain";
 		}
 		if (state.poisonError) {
-			await state.client.drainPendingDecryptions("matrix poisoned client shutdown").catch(() => void 0);
+			const decryptionsDrained = await state.client.drainPendingDecryptions("matrix poisoned client shutdown").then(() => true, () => false);
 			state.client.stopWithoutPersist();
+			if (decryptionsDrained) {
+				if (poisonDisposition === "replace-after-stop") deleteSharedClientState(state);
+				else if (poisonDisposition === "replace-after-late-drain") {
+					state.phase = "late-drain-stopped";
+					deleteSharedClientStateAfterLateDrain(state);
+				}
+			}
 			throw state.poisonError;
 		}
 		try {
@@ -719,6 +725,7 @@ function beginGenerationRetirement(params) {
 	return state.retirementPromise;
 }
 function createSharedMatrixClientLease(state, role) {
+	if (state.phase !== "open" || state.poisonError) return null;
 	const leaseState = {
 		abortController: new AbortController(),
 		monitorRetirement: null,
@@ -747,6 +754,11 @@ function createSharedMatrixClientLease(state, role) {
 			state.releaseMode = mergeReleaseMode(state.releaseMode, releaseParams.mode ?? "stop");
 			state.leases.delete(leaseState);
 			if (state.leases.size === 0) state.noLeases.resolve();
+			if (state.phase === "late-drain" || state.phase === "late-drain-stopped") {
+				leaseState.releasePromise = Promise.resolve();
+				deleteSharedClientStateAfterLateDrain(state);
+				return leaseState.releasePromise;
+			}
 			const finalMonitor = role === "monitor" && !Array.from(state.leases).some((lease) => lease.role === "monitor");
 			if (role === "monitor" && !finalMonitor) {
 				leaseState.releasePromise = retireMonitorLease(state, leaseState);
@@ -765,14 +777,17 @@ function createSharedMatrixClientLease(state, role) {
 	};
 }
 async function acquireSharedMatrixClient(params = {}) {
-	const lease = createSharedMatrixClientLease(await resolveOpenSharedMatrixClientState(params), params.role ?? "transient");
-	if (params.startClient !== false) try {
-		await lease.start(params.abortSignal);
-	} catch (error) {
-		await lease.release({ mode: "stop" }).catch(() => void 0);
-		throw error;
+	while (true) {
+		const lease = createSharedMatrixClientLease(await resolveOpenSharedMatrixClientState(params), params.role ?? "transient");
+		if (!lease) continue;
+		if (params.startClient !== false) try {
+			await lease.start(params.abortSignal);
+		} catch (error) {
+			await lease.release({ mode: "stop" }).catch(() => void 0);
+			throw error;
+		}
+		return lease;
 	}
-	return lease;
 }
 //#endregion
 //#region extensions/matrix/src/matrix/client.ts

package/dist/{client-sJesKQmp.js → client-D8XghqmX.js}

@@ -1,6 +1,6 @@
 import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
-import { x as resolveMatrixRoomId } from "./send-ZDLU4JTk.js";
-import { n as withResolvedRuntimeMatrixClient } from "./client-bootstrap-BFwT_2VT.js";
+import { x as resolveMatrixRoomId } from "./send-ClHgDZLT.js";
+import { n as withResolvedRuntimeMatrixClient } from "./client-bootstrap-Co3RlItb.js";
 //#region extensions/matrix/src/matrix/actions/client.ts
 var client_exports = /* @__PURE__ */ __exportAll({
 	withResolvedActionClient: () => withResolvedActionClient,

package/dist/{client-bootstrap-BFwT_2VT.js → client-bootstrap-Co3RlItb.js}

@@ -7,7 +7,7 @@ var client_bootstrap_exports = /* @__PURE__ */ __exportAll({
 	resolveRuntimeMatrixClientWithReadiness: () => resolveRuntimeMatrixClientWithReadiness,
 	withResolvedRuntimeMatrixClient: () => withResolvedRuntimeMatrixClient
 });
-const loadMatrixSharedClientRuntimeDeps = createLazyRuntimeModule(() => import("./client-CeGw0G5S.js").then((n) => n.t).then((clientModule) => ({
+const loadMatrixSharedClientRuntimeDeps = createLazyRuntimeModule(() => import("./client-BBQdBG7t.js").then((n) => n.t).then((clientModule) => ({
 	acquireSharedMatrixClient: clientModule.acquireSharedMatrixClient,
 	resolveMatrixAuthContext: clientModule.resolveMatrixAuthContext
 })));

package/dist/contract-api.js

@@ -1,3 +1,3 @@
-import { c as singleAccountKeysToMove, n as matrixSetupAdapter, o as namedAccountPromotionKeys, s as resolveSingleAccountPromotionTarget } from "./setup-core-DQn6b5vi.js";
-import { n as matrixOnboardingAdapter } from "./setup-surface-DlhJdrNI.js";
+import { c as singleAccountKeysToMove, n as matrixSetupAdapter, o as namedAccountPromotionKeys, s as resolveSingleAccountPromotionTarget } from "./setup-core-DigrLebY.js";
+import { n as matrixOnboardingAdapter } from "./setup-surface-Dtn8sAWs.js";
 export { matrixSetupAdapter, matrixOnboardingAdapter as matrixSetupWizard, namedAccountPromotionKeys, resolveSingleAccountPromotionTarget, singleAccountKeysToMove };

package/dist/{directory-live-Bvg2wAnR.js → directory-live-DLQzel12.js}

@@ -1,6 +1,6 @@
 import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
-import { n as normalizeMatrixMessagingTarget, t as isMatrixQualifiedUserId } from "./target-ids-B-5aQxwn.js";
-import { c as resolveMatrixAuth } from "./client-CeGw0G5S.js";
+import { r as normalizeMatrixMessagingTarget, t as isMatrixQualifiedUserId } from "./target-ids-Nwx7cMVE.js";
+import { c as resolveMatrixAuth } from "./client-BBQdBG7t.js";
 import { t as MatrixAuthedHttpClient } from "./http-client-CycYxU9-.js";
 import { normalizeLowercaseStringOrEmpty, normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 //#region extensions/matrix/src/directory-live.ts

package/dist/doctor-contract-api.js

@@ -508,7 +508,13 @@ const stateMigrations = [
 				}
 				const existing = normalizeMatrixStoredCredentials(stored, source.accountId);
 				if (existing && JSON.stringify(existing) !== JSON.stringify(credentials)) {
-					warnings.push(`Kept existing Matrix credentials for account ${source.accountId}; left differing legacy source in place`);
+					changes.push(`Kept existing Matrix credentials for account ${source.accountId}`);
+					await archiveLegacyStateSource({
+						filePath: source.filePath,
+						label: "Matrix credentials",
+						changes,
+						warnings
+					});
 					continue;
 				}
 				if (!existing) try {

package/dist/{draft-stream-BRi7PRRS.js → draft-stream-DQ7QNC-l.js}

@@ -1,4 +1,4 @@
-import { E as MsgType, a as sendSingleTextMessageMatrix, l as prepareMatrixSingleText, t as editMessageMatrix } from "./send-ZDLU4JTk.js";
+import { E as MsgType, a as sendSingleTextMessageMatrix, l as prepareMatrixSingleText, t as editMessageMatrix } from "./send-ClHgDZLT.js";
 import { createFinalizableDraftStreamControlsForState } from "openclaw/plugin-sdk/channel-outbound";
 //#region extensions/matrix/src/matrix/draft-stream.ts
 const DEFAULT_THROTTLE_MS = 1e3;

package/dist/index.js

@@ -1,4 +1,4 @@
-import { n as registerMatrixCliMetadata } from "./cli-metadata-B1d1aGM5.js";
+import { n as registerMatrixCliMetadata } from "./cli-metadata-BmUYWjuM.js";
 import { registerMatrixSubagentHooks } from "./subagent-hooks-api.js";
 import { defineBundledChannelEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";

package/dist/{media-text-JudlYOSc.js → media-text-Dh-DpTc3.js}

@@ -1,4 +1,4 @@
-import { _ as parsePollStartContent, d as buildPollResultsSummary, f as formatPollAsText, h as isPollStartType, m as isPollEventType, p as formatPollResultsAsText, v as resolvePollReferenceEventId } from "./send-ZDLU4JTk.js";
+import { _ as parsePollStartContent, d as buildPollResultsSummary, f as formatPollAsText, h as isPollStartType, m as isPollEventType, p as formatPollResultsAsText, v as resolvePollReferenceEventId } from "./send-ClHgDZLT.js";
 import path from "node:path";
 //#region extensions/matrix/src/matrix/poll-summary.ts
 function resolveMatrixPollRootEventId(event) {
@@ -10,11 +10,14 @@ function resolveMatrixPollRootEventId(event) {
 }
 async function readAllPollRelations(client, roomId, pollEventId) {
 	const relationEvents = [];
+	const seenCursors = /* @__PURE__ */ new Set();
 	let nextBatch;
 	do {
 		const page = await client.getRelations(roomId, pollEventId, "m.reference", void 0, { from: nextBatch });
 		relationEvents.push(...page.events);
 		nextBatch = page.nextBatch ?? void 0;
+		if (nextBatch && seenCursors.has(nextBatch)) throw new Error("Matrix poll pagination returned a repeated cursor");
+		if (nextBatch) seenCursors.add(nextBatch);
 	} while (nextBatch);
 	return relationEvents;
 }

package/dist/{messages-BW0s-6Y9.js → messages-DEqg7HVy.js}

@@ -1,13 +1,12 @@
-import { h as isPollStartType, m as isPollEventType, r as sendMessageMatrix, t as editMessageMatrix } from "./send-ZDLU4JTk.js";
 import { n as MATRIX_REACTION_EVENT_TYPE } from "./reaction-common-DkrQdBSZ.js";
-import { a as resolveMatrixMessageAttachment, l as resolveMatrixPollRootEventId, o as resolveMatrixMessageBody, s as fetchMatrixPollMessageSummary } from "./media-text-JudlYOSc.js";
-import { r as withResolvedRoomAction } from "./client-sJesKQmp.js";
+import { h as isPollStartType, m as isPollEventType, r as sendMessageMatrix, t as editMessageMatrix } from "./send-ClHgDZLT.js";
+import { a as resolveMatrixMessageAttachment, l as resolveMatrixPollRootEventId, o as resolveMatrixMessageBody, s as fetchMatrixPollMessageSummary } from "./media-text-Dh-DpTc3.js";
+import { r as withResolvedRoomAction } from "./client-D8XghqmX.js";
 import { n as isMatrixNotFoundError } from "./errors-DKVS3_DO.js";
-import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
-import { resolveIntegerOption } from "openclaw/plugin-sdk/number-runtime";
+import { asNullableObjectRecord, normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 //#region extensions/matrix/src/matrix/actions/limits.ts
 function resolveMatrixActionLimit(raw, fallback) {
-	return resolveIntegerOption(raw, fallback, { min: 1 });
+	return Math.max(1, Math.floor(raw !== void 0 && Number.isFinite(raw) ? raw : fallback));
 }
 //#endregion
 //#region extensions/matrix/src/matrix/actions/types.ts
@@ -19,6 +18,26 @@ const EventType = {
 };
 //#endregion
 //#region extensions/matrix/src/matrix/actions/summary.ts
+function parseMatrixRawEvent(value) {
+	const event = asNullableObjectRecord(value);
+	const content = asNullableObjectRecord(event?.content);
+	if (!event || typeof event.event_id !== "string" || typeof event.sender !== "string" || typeof event.type !== "string" || typeof event.origin_server_ts !== "number" || !content) return null;
+	const unsigned = asNullableObjectRecord(event.unsigned);
+	const relations = asNullableObjectRecord(unsigned?.["m.relations"]);
+	return {
+		event_id: event.event_id,
+		sender: event.sender,
+		type: event.type,
+		origin_server_ts: event.origin_server_ts,
+		content,
+		...unsigned ? { unsigned: {
+			...typeof unsigned.age === "number" ? { age: unsigned.age } : {},
+			...relations ? { "m.relations": relations } : {},
+			...unsigned.redacted_because !== void 0 ? { redacted_because: unsigned.redacted_because } : {}
+		} } : {},
+		...typeof event.state_key === "string" ? { state_key: event.state_key } : {}
+	};
+}
 function resolveBundledMatrixReplacementContent(event) {
 	const rawReplacement = event.unsigned?.["m.relations"]?.["m.replace"];
 	if (!rawReplacement || typeof rawReplacement !== "object" || event.state_key !== void 0) return;
@@ -73,7 +92,8 @@ async function readPinnedEvents(client, roomId) {
 }
 async function fetchEventSummary(client, roomId, eventId) {
 	try {
-		const raw = await client.getEvent(roomId, eventId);
+		const raw = parseMatrixRawEvent(await client.getEvent(roomId, eventId));
+		if (!raw) return null;
 		if (raw.unsigned?.redacted_because) return null;
 		const pollSummary = await fetchMatrixPollMessageSummary(client, roomId, raw);
 		if (pollSummary) return pollSummary;

package/dist/{monitor-Ddfc-vjX.js → monitor-FNrfkuWL.js}

@@ -1,23 +1,22 @@
 import { a as resolveMatrixAccountConfig, i as resolveMatrixAccountAllowlistConfig } from "./account-config-BZWN9tGS.js";
 import { t as getMatrixRuntime } from "./runtime-6S3DNFNv.js";
 import { n as resolveConfiguredMatrixBotUserIds } from "./accounts-BCzyubQt.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-VSrHgTON.js";
-import { a as normalizeMatrixUserId, i as normalizeMatrixAllowList, o as resolveMatrixAllowListMatch } from "./channel.setup-PpxRP9Du.js";
-import { t as isMatrixQualifiedUserId } from "./target-ids-B-5aQxwn.js";
-import { C as promoteMatrixDirectRoomCandidate, T as MATRIX_OPENCLAW_FINALIZED_PREVIEW_KEY, _ as parsePollStartContent, c as chunkMatrixText, f as formatPollAsText, h as isPollStartType, m as isPollEventType, r as sendMessageMatrix } from "./send-ZDLU4JTk.js";
+import { _ as logInboundDrop, a as resolveMatrixThreadRootId, b as summarizeMapping, c as RelationType, d as buildAllowlistResolutionSummary, f as canonicalizeAllowlistWithResolvedIds, g as getAgentScopedMediaLocalRoots, h as formatLocationText, i as resolveMatrixReplyToEventId, l as resolveMatrixRoomConfig, m as createTypingCallbacks, n as resolveMatrixStoredSessionMeta, o as resolveMatrixThreadRouting, p as createReplyPrefixOptions, r as resolveMatrixInboundRoute, s as EventType, u as addAllowlistUserEntriesFromConfigEntry, v as logTypingFailure, x as toLocationContext, y as patchAllowlistUsersInConfigEntries } from "./channel-CzQw5OZN.js";
+import { a as normalizeMatrixUserId, i as normalizeMatrixAllowList, o as resolveMatrixAllowListMatch } from "./channel.setup-aNaa3Uyn.js";
+import { n as isMatrixRoomId, t as isMatrixQualifiedUserId } from "./target-ids-Nwx7cMVE.js";
+import { C as promoteMatrixDirectRoomCandidate, T as MATRIX_OPENCLAW_FINALIZED_PREVIEW_KEY, _ as parsePollStartContent, c as chunkMatrixText, f as formatPollAsText, h as isPollStartType, m as isPollEventType, r as sendMessageMatrix } from "./send-ClHgDZLT.js";
 import { i as isStrictDirectMembership, n as hasDirectMatrixMemberFlag, o as readJoinedMatrixMembers } from "./direct-room-RinHjtqX.js";
-import { t as createMatrixThreadBindingManager } from "./thread-bindings-CcHZP3w2.js";
-import { a as resolveMatrixMessageAttachment, c as fetchMatrixPollSnapshot, i as isLikelyBareFilename, n as formatMatrixMediaUnavailableText, o as resolveMatrixMessageBody, r as formatMatrixMessageText, t as formatMatrixMediaTooLargeText } from "./media-text-JudlYOSc.js";
+import { t as createMatrixThreadBindingManager } from "./thread-bindings-BYEGfw3h.js";
+import { a as resolveMatrixMessageAttachment, c as fetchMatrixPollSnapshot, i as isLikelyBareFilename, n as formatMatrixMediaUnavailableText, o as resolveMatrixMessageBody, r as formatMatrixMessageText, t as formatMatrixMediaTooLargeText } from "./media-text-Dh-DpTc3.js";
 import { t as isBunRuntime } from "./runtime-BefyhPWv.js";
-import { a as throwIfMatrixStartupAborted, c as resolveMatrixAuth, i as isMatrixStartupAbortError, l as resolveMatrixAuthContext, n as acquireSharedMatrixClient, s as backfillMatrixAuthDeviceIdAfterStartup } from "./client-CeGw0G5S.js";
+import { a as throwIfMatrixStartupAborted, c as resolveMatrixAuth, i as isMatrixStartupAbortError, l as resolveMatrixAuthContext, n as acquireSharedMatrixClient, s as backfillMatrixAuthDeviceIdAfterStartup } from "./client-BBQdBG7t.js";
 import { i as isMatrixMediaSizeLimitError, r as MatrixMediaSizeLimitError } from "./http-client-CycYxU9-.js";
 import { d as resolveAllowlistProviderRuntimeGroupPolicy, f as resolveDefaultGroupPolicy, g as warnMissingProviderGroupPolicyFallbackOnce, h as resolveThreadBindingMaxAgeMsForChannel, m as resolveThreadBindingIdleTimeoutMsForChannel, t as GROUP_POLICY_BLOCKED_LABEL } from "./runtime-api-BGO16Fu8.js";
-import { t as resolveMatrixTargets } from "./resolve-targets-BJAPY4Vb.js";
+import { t as resolveMatrixTargets } from "./resolve-targets-e7AI0P75.js";
 import { t as formatMatrixEncryptedEventDisabledWarning } from "./encryption-guidance-DmLY8NiO.js";
 import { createMatrixInboundEventDeduper } from "./inbound-dedupe-RvSLqdsz.js";
 import { a as isMatrixAccessTokenInvalidatedError, d as isMatrixDisconnectedSyncState, f as isMatrixReadySyncState, p as isMatrixTerminalSyncState } from "./client-support-DLj4vDeu.js";
 import { n as setBoundedMap, t as createMatrixRoomInfoResolver } from "./room-info-BXQA7y10.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 { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 import { buildChannelProgressDraftLineForEntry, createChannelProgressDraftCompositor, createMessageReceiptFromOutboundResults, createPreviewMessageReceipt, defineFinalizableLivePreviewAdapter, deliverWithFinalizableLivePreviewAdapter, formatChannelProgressDraftLine, formatChannelProgressDraftText, listMessageReceiptPlatformIds, resolveChannelStreamingBlockEnabled, waitUntilAbort } from "openclaw/plugin-sdk/channel-outbound";
 import { normalizeLowercaseStringOrEmpty, normalizeNullableString, normalizeOptionalString, normalizeStringifiedEntries, uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
@@ -26,7 +25,7 @@ import { CHANNEL_APPROVAL_NATIVE_RUNTIME_CONTEXT_CAPABILITY } from "openclaw/plu
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { isFutureDateTimestampMs, parseStrictFiniteNumber, resolveExpiresAtMsFromDurationMs, resolveOptionalIntegerOption } from "openclaw/plugin-sdk/number-runtime";
 import { resolveInboundLastRouteSessionKey } from "openclaw/plugin-sdk/routing";
-import { createChannelInboundEnvelopeBuilder, createChannelPartialDeliveryError, hasFinalInboundReplyDispatch, isChannelPartialDeliveryError, resolveInboundMentionDecision, toInboundMediaFactsWithMetadata } from "openclaw/plugin-sdk/channel-inbound";
+import { createChannelInboundEnvelopeBuilder, createChannelPartialDeliveryError, hasFinalInboundReplyDispatch, isChannelPartialDeliveryError, resolveInboundMentionDecision, resolveInboundReplyDispatchCounts, toInboundMediaFactsWithMetadata } from "openclaw/plugin-sdk/channel-inbound";
 import { getSessionEntry, resolveStorePath } from "openclaw/plugin-sdk/session-store-runtime";
 import { KeyedAsyncQueue } from "openclaw/plugin-sdk/keyed-async-queue";
 import { format } from "node:util";
@@ -40,7 +39,7 @@ import { createChannelIngressResolver, defineStableChannelIngressIdentity } from
 import { resolveHumanDelayConfig } from "openclaw/plugin-sdk/agent-runtime";
 import { evaluateSupplementalContextVisibility, resolveChannelContextVisibilityMode } from "openclaw/plugin-sdk/context-visibility-runtime";
 import { getGlobalHookRunner } from "openclaw/plugin-sdk/plugin-runtime";
-import { createChannelPreflightAudio } from "openclaw/plugin-sdk/media-understanding-runtime";
+import { createChannelPreflightAudio, formatAudioTranscriptForAgent } from "openclaw/plugin-sdk/media-understanding-runtime";
 import { mergePairLoopGuardConfig } from "openclaw/plugin-sdk/pair-loop-guard-runtime";
 import { buildInboundHistoryFromEntries } from "openclaw/plugin-sdk/reply-history";
 import { decodeHtmlEntities } from "openclaw/plugin-sdk/html-entity-runtime";
@@ -153,7 +152,7 @@ function isMatrixDangerousNameMatchingEnabled(params) {
 function addUniqueMatrixAllowlistEntry(params) {
 	const trimmed = params.entry.trim();
 	if (!trimmed) return;
-	const key = trimmed.toLowerCase();
+	const key = normalizeMatrixUserId(trimmed);
 	if (params.seen.has(key)) return;
 	params.seen.add(key);
 	params.entries.push(trimmed);
@@ -186,7 +185,8 @@ function resolveStableMatrixMonitorUserAllowlist(params) {
 	const resolution = resolveStableMatrixMonitorUserEntries(allowList);
 	const canonicalized = canonicalizeAllowlistWithResolvedIds({
 		existing: allowList,
-		resolvedMap: resolution.resolvedMap
+		resolvedMap: resolution.resolvedMap,
+		entryKey: normalizeMatrixUserId
 	});
 	logStableMatrixAllowlistUnresolved({
 		label: params.label,
@@ -263,7 +263,8 @@ async function resolveMatrixMonitorUserAllowlist(params) {
 	});
 	const canonicalized = canonicalizeAllowlistWithResolvedIds({
 		existing: allowList,
-		resolvedMap: resolution.resolvedMap
+		resolvedMap: resolution.resolvedMap,
+		entryKey: normalizeMatrixUserId
 	});
 	summarizeMapping(params.label, resolution.mapping, resolution.unresolved, params.runtime);
 	if (resolution.unresolved.length > 0) params.runtime.log?.(`${params.label} entries must be full Matrix IDs (example: @user:server). Unresolved entries will not match any sender.`);
@@ -332,7 +333,8 @@ async function resolveMatrixMonitorLiveUserAllowlist(params) {
 			entries: pending,
 			runtime: params.runtime,
 			resolveTargets: params.resolveTargets ?? resolveMatrixTargets
-		})).resolvedMap
+		})).resolvedMap,
+		entryKey: normalizeMatrixUserId
 	});
 	const resolvedEntries = params.failClosedOnUnresolved ? filterFailClosedMatrixAllowlistEntries(canonicalized) : filterResolvedMatrixAllowlistEntries(canonicalized);
 	for (const entry of resolvedEntries) addUniqueMatrixAllowlistEntry({
@@ -363,7 +365,7 @@ async function resolveMatrixMonitorRoomsConfig(params) {
 			unresolved.push(entry);
 			continue;
 		}
-		if (cleaned.startsWith("!") && cleaned.includes(":")) {
+		if (isMatrixRoomId(cleaned)) {
 			if (!nextRooms[cleaned]) nextRooms[cleaned] = roomConfig;
 			if (cleaned !== input) mapping.push(`${input}→${cleaned}`);
 			continue;
@@ -394,7 +396,7 @@ async function resolveMatrixMonitorRoomsConfig(params) {
 		} else unresolved.push(source.input);
 	});
 	summarizeMapping("matrix rooms", mapping, unresolved, params.runtime);
-	if (unresolved.length > 0) params.runtime.log?.("matrix rooms must be room IDs or aliases (example: !room:server or #alias:server). Unresolved entries are ignored.");
+	if (unresolved.length > 0) params.runtime.log?.("matrix rooms must be room IDs or aliases (example: !room:server, the suffixless !room form on room version 12+, or #alias:server). Unresolved entries are ignored.");
 	const roomUsers = /* @__PURE__ */ new Set();
 	for (const roomConfig of Object.values(nextRooms)) addAllowlistUserEntriesFromConfigEntry(roomUsers, roomConfig);
 	if (roomUsers.size === 0) return nextRooms;
@@ -408,7 +410,8 @@ async function resolveMatrixMonitorRoomsConfig(params) {
 		return patchAllowlistUsersInConfigEntries({
 			entries: nextRooms,
 			resolvedMap: resolution.resolvedMap,
-			strategy: "canonicalize"
+			strategy: "canonicalize",
+			entryKey: normalizeMatrixUserId
 		});
 	}
 	const resolution = await resolveMatrixMonitorUserEntries({
@@ -423,7 +426,8 @@ async function resolveMatrixMonitorRoomsConfig(params) {
 	return patchAllowlistUsersInConfigEntries({
 		entries: nextRooms,
 		resolvedMap: resolution.resolvedMap,
-		strategy: "canonicalize"
+		strategy: "canonicalize",
+		entryKey: normalizeMatrixUserId
 	});
 }
 async function resolveMatrixMonitorConfig(params) {
@@ -815,7 +819,7 @@ const matrixVerificationConstants = {
 const MAX_TRACKED_VERIFICATION_EVENTS = 1024;
 const SAS_NOTICE_RETRY_DELAY_MS = 750;
 const VERIFICATION_EVENT_STARTUP_GRACE_MS = 3e4;
-const loadMatrixDirectRoomDeps = createLazyRuntimeModule(() => Promise.all([import("./send-ZDLU4JTk.js").then((n) => n.S), import("./direct-room-RinHjtqX.js").then((n) => n.t)]).then(([directManagementModule, directRoomModule]) => ({
+const loadMatrixDirectRoomDeps = createLazyRuntimeModule(() => Promise.all([import("./send-ClHgDZLT.js").then((n) => n.S), import("./direct-room-RinHjtqX.js").then((n) => n.t)]).then(([directManagementModule, directRoomModule]) => ({
 	inspectMatrixDirectRooms: directManagementModule.inspectMatrixDirectRooms,
 	isStrictDirectRoom: directRoomModule.isStrictDirectRoom
 })));
@@ -1425,9 +1429,6 @@ function resolveMatrixAckReactionConfig(params) {
 }
 //#endregion
 //#region extensions/matrix/src/matrix/monitor/preflight-audio.ts
-function formatMatrixAudioTranscript(transcript) {
-	return `[Audio transcript (machine-generated, untrusted)]: ${JSON.stringify(transcript)}`;
-}
 function isMatrixAudioContent(params) {
 	if (params.msgtype === "m.audio") return true;
 	if (params.msgtype === "m.file" && typeof params.mimetype === "string") return params.mimetype.toLowerCase().startsWith("audio/");
@@ -1576,11 +1577,11 @@ async function redactMatrixDraftEvent(client, roomId, draftEventId) {
 function buildMatrixFinalizedPreviewContent() {
 	return { [MATRIX_OPENCLAW_FINALIZED_PREVIEW_KEY]: true };
 }
-const loadMatrixSendModule = createLazyRuntimeModule(() => import("./send-ZDLU4JTk.js").then((n) => n.s));
+const loadMatrixSendModule = createLazyRuntimeModule(() => import("./send-ClHgDZLT.js").then((n) => n.s));
 const loadAcpBindingRuntime = createLazyRuntimeModule(() => import("openclaw/plugin-sdk/acp-binding-runtime"));
 const loadSessionBindingRuntime = createLazyRuntimeModule(() => import("openclaw/plugin-sdk/session-binding-runtime"));
-const loadMatrixReactionEvents = createLazyRuntimeModule(() => import("./reaction-events-nfUbFLdV.js"));
-const loadMatrixDraftStream = createLazyRuntimeModule(() => import("./draft-stream-BRi7PRRS.js"));
+const loadMatrixReactionEvents = createLazyRuntimeModule(() => import("./reaction-events-BKOLlnCo.js"));
+const loadMatrixDraftStream = createLazyRuntimeModule(() => import("./draft-stream-DQ7QNC-l.js"));
 async function matrixTextWouldActivateMentions(client, text) {
 	const { resolveMatrixMentionsForBody } = await loadMatrixSendModule();
 	const mentions = await resolveMatrixMentionsForBody({
@@ -2908,7 +2909,7 @@ async function resolveMatrixIngressContent(config) {
 	const { effectiveWasMentioned, shouldBypassMention } = mentionDecision;
 	const canDetectMention = agentMentionRegexes.length > 0 || hasExplicitMention;
 	if (mentionDecision.shouldSkip) {
-		const pendingHistoryBody = preflightAudioTranscript ? formatMatrixAudioTranscript(preflightAudioTranscript) : pendingHistoryText || pendingHistoryPollText;
+		const pendingHistoryBody = preflightAudioTranscript ? formatAudioTranscriptForAgent(preflightAudioTranscript) : pendingHistoryText || pendingHistoryPollText;
 		if (historyLimit > 0 && pendingHistoryBody) {
 			const pendingEntry = {
 				sender: senderId,
@@ -2991,7 +2992,7 @@ async function resolveMatrixIngressContent(config) {
 	});
 	if (preflightMedia && bodyText && bodyText !== preflightMedia.placeholder && isLikelyBareFilename(bodyText)) bodyText = preflightMedia.placeholder;
 	if (preflightAudioTranscript) {
-		const transcriptBody = formatMatrixAudioTranscript(preflightAudioTranscript);
+		const transcriptBody = formatAudioTranscriptForAgent(preflightAudioTranscript);
 		bodyText = !bodyText || bodyText === media?.placeholder ? transcriptBody : `${bodyText}\n${transcriptBody}`;
 	}
 	if (!bodyText) {
@@ -4077,7 +4078,7 @@ function createMatrixRoomMessageHandler(params) {
 				return;
 			}
 			const { dispatchResult } = turnResult;
-			const { queuedFinal, counts } = dispatchResult;
+			const { queuedFinal } = dispatchResult;
 			if (replyDispatcher.finalReplyDeliveryFailed()) {
 				logVerboseMessage(`matrix: final reply delivery failed room=${roomId} id=${messageId}; keeping replay committed`);
 				await commitInboundEventIfClaimed();
@@ -4089,14 +4090,11 @@ function createMatrixRoomMessageHandler(params) {
 				return;
 			}
 			if (isRoom && triggerSnapshot) roomHistoryTracker.consumeHistory(_route.agentId, roomId, triggerSnapshot, messageId, threadRootId ? thread.threadId : void 0);
-			if (!hasFinalInboundReplyDispatch({
-				queuedFinal,
-				counts
-			})) {
+			if (!hasFinalInboundReplyDispatch(dispatchResult)) {
 				await commitInboundEventIfClaimed();
 				return;
 			}
-			const finalCount = counts.final;
+			const finalCount = resolveInboundReplyDispatchCounts(dispatchResult).final;
 			logVerboseMessage(`matrix: delivered ${finalCount} reply${finalCount === 1 ? "" : "ies"} to ${replyTarget}`);
 			await commitInboundEventIfClaimed();
 		} catch (err) {
@@ -4688,7 +4686,7 @@ async function monitorMatrixProvider(opts = {}) {
 			logVerboseMessage
 		});
 		if (monitorSetupClosed) {
-			createdThreadBindingManager.stop();
+			await createdThreadBindingManager.stop();
 			await cleanup("stop");
 			return;
 		}

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-C7ig-bQE.js").then((n) => n.y));
+const loadMatrixVerificationRuntime = createLazyRuntimeModule(() => import("./verification-CabtBTtB.js").then((n) => n.y));
 function sendError(respond, err) {
 	respond(false, { error: formatErrorMessage(err) });
 }

package/dist/probe.runtime-NIJZYqc2.js

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

package/dist/{profile-update-BkgWYDIp.js → profile-update-BQlE5s2J.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 { r as syncMatrixOwnProfile } from "./profile-D-Wubo0A.js";
-import { n as withResolvedActionClient } from "./client-sJesKQmp.js";
+import { n as withResolvedActionClient } from "./client-D8XghqmX.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-nfUbFLdV.js → reaction-events-BKOLlnCo.js}

@@ -1,15 +1,15 @@
 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 extractMatrixReactionAnnotation } from "./reaction-common-DkrQdBSZ.js";
 import { i as resolveMatrixApprovalReactionTargetWithPersistence, o as unregisterMatrixApprovalReactionTargetsForApproval } from "./approval-reactions-tXh9KYrW.js";
-import { i as resolveMatrixThreadRouting, r as resolveMatrixThreadRootId, t as resolveMatrixInboundRoute } from "./route-DY6at4qJ.js";
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 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-wBwbEDpZ.js"));
+const loadApprovalReactionAuth = createLazyRuntimeModule(() => import("./approval-reaction-auth-CziKXatm.js"));
 const loadExecApprovalResolver = createLazyRuntimeModule(() => import("openclaw/plugin-sdk/approval-gateway-runtime"));
-const loadMatrixSend = createLazyRuntimeModule(() => import("./send-ZDLU4JTk.js").then((n) => n.s));
+const loadMatrixSend = createLazyRuntimeModule(() => import("./send-ClHgDZLT.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";

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

@@ -1,6 +1,6 @@
 import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
-import { n as normalizeMatrixMessagingTarget, t as isMatrixQualifiedUserId } from "./target-ids-B-5aQxwn.js";
-import { n as listMatrixDirectoryGroupsLive, r as listMatrixDirectoryPeersLive } from "./directory-live-Bvg2wAnR.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 { 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-LWJELYq5.js → resolver.runtime-V8u0pHEb.js}

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

package/dist/runtime-api.js

@@ -2,7 +2,7 @@ import { a as resolveMatrixDefaultOrOnlyAccountId, i as resolveMatrixChannelConf
 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";
-import { d as setMatrixThreadBindingIdleTimeoutBySessionKey, p as setMatrixThreadBindingMaxAgeBySessionKey } from "./thread-bindings-shared-CKnY4LSd.js";
+import { f as setMatrixThreadBindingMaxAgeBySessionKey, u as setMatrixThreadBindingIdleTimeoutBySessionKey } from "./thread-bindings-shared-oNPiyMWY.js";
 import { n as ensureMatrixSdkInstalled, r as isMatrixSdkAvailable } from "./deps-CcVJfvRM.js";
 import { chunkTextForOutbound as chunkTextForOutbound$1 } from "openclaw/plugin-sdk/text-chunking";
 import { assertHttpUrlTargetsPrivateNetwork, closeDispatcher, createPinnedDispatcher, resolvePinnedHostnameWithPolicy, ssrfPolicyFromDangerouslyAllowPrivateNetwork } from "openclaw/plugin-sdk/ssrf-runtime";