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

package/dist/{messages-BW0s-6Y9.js → messages-Dow9EOoJ.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-BKu9Ghi4.js";
+import { a as resolveBundledMatrixReplacementContent, l as resolveMatrixPollRootEventId, o as resolveMatrixMessageAttachment, s as fetchMatrixPollMessageSummary } from "./media-text-OR9uoC4W.js";
+import { r as withResolvedRoomAction } from "./client-BUtHbzib.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,15 +18,25 @@ const EventType = {
 };
 //#endregion
 //#region extensions/matrix/src/matrix/actions/summary.ts
-function resolveBundledMatrixReplacementContent(event) {
-	const rawReplacement = event.unsigned?.["m.relations"]?.["m.replace"];
-	if (!rawReplacement || typeof rawReplacement !== "object" || event.state_key !== void 0) return;
-	const replacement = rawReplacement;
-	const content = replacement.content;
-	const relation = content?.["m.relates_to"];
-	const newContent = content?.["m.new_content"];
-	if (replacement.sender !== event.sender || replacement.type !== event.type || replacement.state_key !== void 0 || replacement.unsigned?.redacted_because || !relation || typeof relation !== "object" || relation.rel_type !== "m.replace" || relation.event_id !== event.event_id || !newContent || typeof newContent !== "object" || Array.isArray(newContent)) return;
-	return newContent;
+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 summarizeMatrixRawEvent(event) {
 	const content = event.content;
@@ -45,20 +54,17 @@ function summarizeMatrixRawEvent(event) {
 		relType,
 		eventId
 	} : void 0;
+	const attachment = resolveMatrixMessageAttachment({
+		body: displayContent.body,
+		filename: displayContent.filename,
+		msgtype: displayContent.msgtype
+	});
 	return {
 		eventId: event.event_id,
 		sender: event.sender,
-		body: resolveMatrixMessageBody({
-			body: displayContent.body,
-			filename: displayContent.filename,
-			msgtype: displayContent.msgtype
-		}),
+		body: attachment ? attachment.caption : displayContent.body?.trim() || void 0,
 		msgtype: displayContent.msgtype,
-		attachment: resolveMatrixMessageAttachment({
-			body: displayContent.body,
-			filename: displayContent.filename,
-			msgtype: displayContent.msgtype
-		}),
+		attachment,
 		timestamp: event.origin_server_ts,
 		relatesTo
 	};
@@ -73,7 +79,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-DBB47wTy.js}

@@ -1,46 +1,46 @@
 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-CBEvelTE.js";
+import { a as normalizeMatrixUserId, i as normalizeMatrixAllowList, o as resolveMatrixAllowListMatch } from "./channel.setup-sWPOGyQG.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-BKu9Ghi4.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-BvyU66kE.js";
+import { a as resolveBundledMatrixReplacementContent, c as fetchMatrixPollSnapshot, i as isLikelyBareFilename, n as formatMatrixMediaUnavailableText, r as formatMatrixMessageText, t as formatMatrixMediaTooLargeText } from "./media-text-OR9uoC4W.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 { 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 { a as throwIfMatrixStartupAborted, c as resolveMatrixAuth, i as isMatrixStartupAbortError, l as resolveMatrixAuthContext, n as acquireSharedMatrixClient, s as backfillMatrixAuthDeviceIdAfterStartup } from "./client-hs1ePy2O.js";
+import { i as isMatrixMediaSizeLimitError, r as MatrixMediaSizeLimitError } from "./http-client-D8o8b9u6.js";
+import { t as resolveMatrixTargets } from "./resolve-targets-DXzZwsIY.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";
+import { normalizeLowercaseStringOrEmpty, normalizeNullableString, normalizeOptionalString, normalizeStringifiedEntries, readStringValue, uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { stripReasoningTagsFromText } from "openclaw/plugin-sdk/text-chunking";
 import { CHANNEL_APPROVAL_NATIVE_RUNTIME_CONTEXT_CAPABILITY } from "openclaw/plugin-sdk/approval-handler-adapter-runtime";
 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";
 import { resolvePinnedMainDmOwnerFromAllowlist } from "openclaw/plugin-sdk/security-runtime";
 import { escapeRegExp, sliceUtf16Safe, truncateUtf16Safe } from "openclaw/plugin-sdk/text-utility-runtime";
-import { buildTtsSupplementMediaPayload, getReplyPayloadTtsSupplement } from "openclaw/plugin-sdk/reply-payload";
-import { resolveAckReaction } from "openclaw/plugin-sdk/channel-feedback";
+import { buildTtsSupplementMediaPayload, getReplyPayloadTtsSupplement, resolveSendableOutboundReplyParts } from "openclaw/plugin-sdk/reply-payload";
 import { registerChannelRuntimeContext } from "openclaw/plugin-sdk/channel-runtime-context";
+import { GROUP_POLICY_BLOCKED_LABEL, resolveAllowlistProviderRuntimeGroupPolicy, resolveDefaultGroupPolicy, warnMissingProviderGroupPolicyFallbackOnce } from "openclaw/plugin-sdk/runtime-group-policy";
+import { resolveThreadBindingIdleTimeoutMsForChannel, resolveThreadBindingMaxAgeMsForChannel } from "openclaw/plugin-sdk/thread-bindings-runtime";
 import { isDangerousNameMatchingEnabled } from "openclaw/plugin-sdk/dangerous-name-runtime";
 import { createChannelIngressResolver, defineStableChannelIngressIdentity } from "openclaw/plugin-sdk/channel-ingress-runtime";
 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 { resolveAckReaction } from "openclaw/plugin-sdk/channel-feedback";
+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 +153,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 +186,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 +264,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 +334,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 +366,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 +397,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 +411,8 @@ async function resolveMatrixMonitorRoomsConfig(params) {
 		return patchAllowlistUsersInConfigEntries({
 			entries: nextRooms,
 			resolvedMap: resolution.resolvedMap,
-			strategy: "canonicalize"
+			strategy: "canonicalize",
+			entryKey: normalizeMatrixUserId
 		});
 	}
 	const resolution = await resolveMatrixMonitorUserEntries({
@@ -423,7 +427,8 @@ async function resolveMatrixMonitorRoomsConfig(params) {
 	return patchAllowlistUsersInConfigEntries({
 		entries: nextRooms,
 		resolvedMap: resolution.resolvedMap,
-		strategy: "canonicalize"
+		strategy: "canonicalize",
+		entryKey: normalizeMatrixUserId
 	});
 }
 async function resolveMatrixMonitorConfig(params) {
@@ -815,7 +820,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-BKu9Ghi4.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 +1430,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/");
@@ -1527,37 +1529,35 @@ function resolveMatrixSharedDmContextNotice(params) {
 	}
 }
 function resolveMatrixPendingHistoryText(params) {
-	if (params.mentionPrecheckText) return params.mentionPrecheckText;
-	if (!params.mediaUrl) return "";
-	const body = typeof params.content.body === "string" ? params.content.body.trim() : void 0;
-	const filename = typeof params.content.filename === "string" ? params.content.filename.trim() : void 0;
-	const msgtype = typeof params.content.msgtype === "string" ? params.content.msgtype : void 0;
+	if (!params.mediaUrl) return params.mentionPrecheckText;
 	return formatMatrixMessageText({
-		body: resolveMatrixMessageBody({
-			body,
-			filename,
-			msgtype
-		}),
-		attachment: resolveMatrixMessageAttachment({
-			body,
-			filename,
-			msgtype
-		})
-	}) ?? "";
+		body: typeof params.content.body === "string" ? params.content.body : void 0,
+		filename: typeof params.content.filename === "string" ? params.content.filename : void 0,
+		msgtype: typeof params.content.msgtype === "string" ? params.content.msgtype : void 0
+	}) ?? params.mentionPrecheckText;
+}
+function resolveMatrixInboundMediaContent(content) {
+	const file = content.file && typeof content.file === "object" ? content.file : void 0;
+	const info = content.info && typeof content.info === "object" ? content.info : void 0;
+	const body = normalizeOptionalString(content.body);
+	return {
+		url: normalizeOptionalString(content.url) ?? normalizeOptionalString(file?.url),
+		file,
+		body: body ?? "",
+		contentType: info?.mimetype,
+		sizeBytes: typeof info?.size === "number" ? info.size : void 0,
+		originalFilename: normalizeOptionalString(content.filename) ?? body
+	};
 }
 function isMatrixAudioMediaEnabled(cfg) {
 	return cfg.tools?.media?.audio?.enabled !== false;
 }
 function shouldDeferMatrixAudioPreflightForRoomIngress(params) {
 	if (!isMatrixAudioMediaEnabled(params.cfg)) return false;
-	const content = params.content;
-	const contentUrl = "url" in content && typeof content.url === "string" ? content.url : void 0;
-	const contentFile = "file" in content && content.file && typeof content.file === "object" ? content.file : void 0;
-	const mediaUrl = contentUrl ?? contentFile?.url;
-	const contentInfo = "info" in content && content.info && typeof content.info === "object" ? content.info : void 0;
-	return mediaUrl?.startsWith("mxc://") === true && isMatrixAudioContent({
-		msgtype: typeof content.msgtype === "string" ? content.msgtype : void 0,
-		mimetype: contentInfo?.mimetype
+	const mediaContent = resolveMatrixInboundMediaContent(params.content);
+	return mediaContent.url?.startsWith("mxc://") === true && isMatrixAudioContent({
+		msgtype: typeof params.content.msgtype === "string" ? params.content.msgtype : void 0,
+		mimetype: mediaContent.contentType
 	});
 }
 function resolveMatrixAllowBotsMode(value) {
@@ -1576,11 +1576,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-BKu9Ghi4.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-BZUgLIZI.js"));
+const loadMatrixDraftStream = createLazyRuntimeModule(() => import("./draft-stream-B_m79Ynb.js"));
 async function matrixTextWouldActivateMentions(client, text) {
 	const { resolveMatrixMentionsForBody } = await loadMatrixSendModule();
 	const mentions = await resolveMatrixMentionsForBody({
@@ -1596,18 +1596,11 @@ function summarizeMatrixMessageContextEvent(event) {
 		const pollSummary = parsePollStartContent(event.content);
 		if (pollSummary) return formatPollAsText(pollSummary);
 	}
-	const content = event.content;
+	const content = event.unsigned?.redacted_because ? event.content : resolveBundledMatrixReplacementContent(event) ?? event.content;
 	return formatMatrixMessageText({
-		body: resolveMatrixMessageBody({
-			body: normalizeOptionalString(content.body),
-			filename: normalizeOptionalString(content.filename),
-			msgtype: normalizeOptionalString(content.msgtype)
-		}),
-		attachment: resolveMatrixMessageAttachment({
-			body: normalizeOptionalString(content.body),
-			filename: normalizeOptionalString(content.filename),
-			msgtype: normalizeOptionalString(content.msgtype)
-		})
+		body: readStringValue(content.body),
+		filename: readStringValue(content.filename),
+		msgtype: normalizeOptionalString(content.msgtype)
 	});
 }
 //#endregion
@@ -2756,14 +2749,8 @@ async function resolveMatrixIngressContent(config) {
 		content,
 		locationText: locationPayload?.text
 	});
-	const contentUrl = "url" in content && typeof content.url === "string" ? content.url : void 0;
-	const contentFile = "file" in content && content.file && typeof content.file === "object" ? content.file : void 0;
-	const mediaUrl = contentUrl ?? contentFile?.url;
-	const earlyContentInfo = "info" in content && content.info && typeof content.info === "object" ? content.info : void 0;
-	const earlyContentType = earlyContentInfo?.mimetype;
-	const earlyContentSize = typeof earlyContentInfo?.size === "number" ? earlyContentInfo.size : void 0;
-	const earlyContentBody = typeof content.body === "string" ? content.body.trim() : "";
-	const earlyOriginalFilename = (typeof content.filename === "string" ? content.filename.trim() : "") || earlyContentBody || void 0;
+	let mediaContent = resolveMatrixInboundMediaContent(content);
+	const mediaUrl = mediaContent.url;
 	const pendingHistoryText = resolveMatrixPendingHistoryText({
 		mentionPrecheckText,
 		content,
@@ -2793,7 +2780,7 @@ async function resolveMatrixIngressContent(config) {
 	const preflightAudioMediaUrl = mediaUrl?.startsWith("mxc://") ? mediaUrl : void 0;
 	const shouldRunMatrixAudioPreflight = isMatrixAudioContent({
 		msgtype: typeof content.msgtype === "string" ? content.msgtype : void 0,
-		mimetype: earlyContentType
+		mimetype: mediaContent.contentType
 	}) && isMatrixAudioMediaEnabled(cfg) && preflightAudioMediaUrl !== void 0;
 	if (shouldRunMatrixAudioPreflight && audioPreflightMode === "defer" && isRoom && historyLimit > 0 && !reservedHistorySlot) {
 		const reserved = roomHistoryTracker.reservePending(_route.agentId, roomId, {
@@ -2813,11 +2800,11 @@ async function resolveMatrixIngressContent(config) {
 			preflightMedia = await downloadMatrixMedia({
 				client,
 				mxcUrl: preflightAudioMediaUrl,
-				contentType: earlyContentType,
-				sizeBytes: earlyContentSize,
+				contentType: mediaContent.contentType,
+				sizeBytes: mediaContent.sizeBytes,
 				maxBytes: mediaMaxBytes,
-				file: contentFile,
-				originalFilename: earlyOriginalFilename
+				file: mediaContent.file,
+				originalFilename: mediaContent.originalFilename
 			});
 		} catch (err) {
 			preflightMediaDownloadFailed = true;
@@ -2828,7 +2815,7 @@ async function resolveMatrixIngressContent(config) {
 				roomId,
 				eventId: event.event_id,
 				msgtype: content.msgtype,
-				encrypted: Boolean(contentFile),
+				encrypted: Boolean(mediaContent.file),
 				error: errorText
 			});
 		}
@@ -2908,7 +2895,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,
@@ -2945,27 +2932,21 @@ async function resolveMatrixIngressContent(config) {
 			msgtype: "m.text",
 			body: pollSnapshot.text
 		};
+		mediaContent = resolveMatrixInboundMediaContent(content);
 	}
 	let media = preflightMedia;
 	let mediaDownloadFailed = preflightMediaDownloadFailed;
 	let mediaSizeLimitExceeded = preflightMediaSizeLimitExceeded;
-	const finalContentUrl = "url" in content && typeof content.url === "string" ? content.url : void 0;
-	const finalContentFile = "file" in content && content.file && typeof content.file === "object" ? content.file : void 0;
-	const finalMediaUrl = finalContentUrl ?? finalContentFile?.url;
-	const contentBody = typeof content.body === "string" ? content.body.trim() : "";
-	const originalFilename = (typeof content.filename === "string" ? content.filename.trim() : "") || contentBody || void 0;
-	const contentInfo = "info" in content && content.info && typeof content.info === "object" ? content.info : void 0;
-	const contentType = contentInfo?.mimetype;
-	const contentSize = typeof contentInfo?.size === "number" ? contentInfo.size : void 0;
+	const finalMediaUrl = mediaContent.url;
 	if (!media && !mediaDownloadFailed && finalMediaUrl?.startsWith("mxc://")) try {
 		media = await downloadMatrixMedia({
 			client,
 			mxcUrl: finalMediaUrl,
-			contentType,
-			sizeBytes: contentSize,
+			contentType: mediaContent.contentType,
+			sizeBytes: mediaContent.sizeBytes,
 			maxBytes: mediaMaxBytes,
-			file: finalContentFile,
-			originalFilename
+			file: mediaContent.file,
+			originalFilename: mediaContent.originalFilename
 		});
 	} catch (err) {
 		mediaDownloadFailed = true;
@@ -2976,12 +2957,12 @@ async function resolveMatrixIngressContent(config) {
 			roomId,
 			eventId: event.event_id,
 			msgtype: content.msgtype,
-			encrypted: Boolean(finalContentFile),
+			encrypted: Boolean(mediaContent.file),
 			error: errorText
 		});
 	}
 	let bodyText = resolveMatrixInboundBodyText({
-		rawBody: locationPayload?.text ?? contentBody,
+		rawBody: locationPayload?.text ?? mediaContent.body,
 		filename: typeof content.filename === "string" ? content.filename : void 0,
 		mediaPlaceholder: media?.placeholder,
 		msgtype: content.msgtype,
@@ -2991,7 +2972,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) {
@@ -3245,12 +3226,12 @@ async function deliverMatrixReplies(params) {
 	try {
 		for (const reply of params.replies) {
 			const visibleText = resolveVisibleMatrixReplyText(reply.text);
-			const hasMedia = Boolean(reply?.mediaUrl) || (reply?.mediaUrls?.length ?? 0) > 0;
+			const { hasMedia, hasText, mediaUrls } = resolveSendableOutboundReplyParts(reply);
 			if (reply.isReasoning === true || !hasMedia && reply.text && visibleText === void 0) {
 				logVerbose("matrix reply suppressed as reasoning-only");
 				continue;
 			}
-			if (!reply?.text && !hasMedia) {
+			if (!hasText && !hasMedia) {
 				if (reply?.audioAsVoice) {
 					logVerbose("matrix reply has audioAsVoice without media/text; skipping");
 					continue;
@@ -3258,17 +3239,14 @@ async function deliverMatrixReplies(params) {
 				params.runtime.error?.("matrix reply missing text/media");
 				continue;
 			}
-			const replyToIdRaw = (reply.replyToId ?? params.replyToId)?.trim();
-			const replyToId = params.threadId ? replyToIdRaw : params.replyToMode === "off" ? void 0 : replyToIdRaw;
+			const explicitReplyToId = reply.replyToTag || reply.replyToCurrent ? reply.replyToId?.trim() : void 0;
 			const rawText = visibleText ?? "";
-			const mediaList = reply.mediaUrls?.length ? reply.mediaUrls : reply.mediaUrl ? [reply.mediaUrl] : [];
-			const shouldIncludeReply = (id) => Boolean(id) && (params.threadId || params.replyToMode === "all" || !hasRepliedRef.value);
-			const replyToIdForReply = shouldIncludeReply(replyToId) ? replyToId : void 0;
+			const replyToIdForReply = explicitReplyToId || (params.threadId || params.replyToMode !== "off" && (params.replyToMode === "all" || !hasRepliedRef.value) ? (reply.replyToId ?? params.replyToId)?.trim() : void 0);
 			const onDeliveryResult = (result) => {
 				acceptedResults.push(result);
 				if (replyToIdForReply) hasRepliedRef.value = true;
 			};
-			if (mediaList.length === 0) {
+			if (mediaUrls.length === 0) {
 				const { chunks } = chunkMatrixText(rawText, {
 					cfg: params.cfg,
 					accountId: params.accountId,
@@ -3289,7 +3267,7 @@ async function deliverMatrixReplies(params) {
 				continue;
 			}
 			let first = true;
-			for (const mediaUrl of mediaList) {
+			for (const mediaUrl of mediaUrls) {
 				const caption = first ? rawText : "";
 				await sendMessageMatrix(params.roomId, caption, {
 					client: params.client,
@@ -3371,7 +3349,7 @@ function createMatrixReplyDispatcher(config) {
 				return replacement;
 			};
 			if (draftStream && info.kind !== "tool" && !payload.isCompactionNotice) {
-				const hasMedia = Boolean(payload.mediaUrl) || (payload.mediaUrls?.length ?? 0) > 0;
+				const { hasMedia } = resolveSendableOutboundReplyParts(payload);
 				const ttsSupplement = getReplyPayloadTtsSupplement(payload);
 				const fallbackPayload = ttsSupplement && ttsSupplement.visibleTextAlreadyDelivered !== true && !payload.text?.trim() ? {
 					...payload,
@@ -3395,8 +3373,7 @@ function createMatrixReplyDispatcher(config) {
 						tableMode
 					}));
 				}
-				const payloadReplyToId = normalizeOptionalString(payload.replyToId);
-				const payloadReplyMismatch = replyToMode !== "off" && !threadTarget && payloadReplyToId !== draftController.currentReplyToId();
+				const payloadReplyMismatch = !threadTarget && (replyToMode !== "off" || payload.replyToTag || payload.replyToCurrent) && normalizeOptionalString(payload.replyToId) !== draftController.currentReplyToId();
 				let mustDeliverFinalNormally = draftStream.mustDeliverFinalNormally();
 				if (Boolean(payload.text?.trim()) && !payload.isError && !payloadReplyMismatch && !mustDeliverFinalNormally) {
 					await draftStream.stop();
@@ -3775,9 +3752,10 @@ function createMatrixRoomMessageHandler(params) {
 			const eventTs = event.origin_server_ts;
 			const eventAge = event.unsigned?.age;
 			const commitInboundEventIfClaimed = async () => {
-				if (!inboundReplayClaim) return;
-				await inboundReplayClaim.commit();
-				inboundReplayClaim = void 0;
+				const claim = inboundReplayClaim;
+				if (!claim) return;
+				await claim.commit();
+				if (inboundReplayClaim === claim) inboundReplayClaim = void 0;
 			};
 			const readIngressPrefix = () => readMatrixIngressPrefix({
 				client,
@@ -3988,10 +3966,27 @@ function createMatrixRoomMessageHandler(params) {
 				route: _route,
 				sessionKey: _route.sessionKey
 			});
+			const replayClaimAtDispatch = inboundReplayClaim;
+			const turnAdoptionLifecycle = replayClaimAtDispatch ? {
+				admission: "exclusive",
+				onDeferred: () => {
+					if (inboundReplayClaim !== replayClaimAtDispatch) return false;
+					inboundReplayClaim = void 0;
+				},
+				onAdopted: async () => {
+					if (inboundReplayClaim === replayClaimAtDispatch) inboundReplayClaim = void 0;
+					await replayClaimAtDispatch.commit();
+				},
+				onAbandoned: () => {
+					if (inboundReplayClaim === replayClaimAtDispatch) inboundReplayClaim = void 0;
+					replayClaimAtDispatch.release();
+				}
+			} : void 0;
 			const turnResult = await core.channel.inbound.run({
 				channel: "matrix",
 				accountId: _route.accountId,
 				raw: event,
+				...turnAdoptionLifecycle ? { turnAdoptionLifecycle } : {},
 				adapter: {
 					ingest: () => ({
 						id: messageId,
@@ -4077,7 +4072,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 +4084,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 +4680,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-BP-3-XYn.js").then((n) => n.y));
 function sendError(respond, err) {
 	respond(false, { error: formatErrorMessage(err) });
 }

package/dist/probe.runtime-CRM7RIrB.js

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

package/dist/{profile-update-BkgWYDIp.js → profile-update-C61NR24_.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-BUtHbzib.js";
 import { normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 //#region extensions/matrix/src/matrix/actions/profile.ts
 async function updateMatrixOwnProfile(opts = {}) {