@openclaw/matrix 2026.9.4 → 2026.9.5

package/dist/{monitor-BUek91SW.js → .setup/monitor-DQfYX5rA.mjs}

@@ -1,23 +1,22 @@
-import { a as resolveMatrixAccountConfig, i as resolveMatrixAccountAllowlistConfig } from "./account-config-CRsKoMqJ.js";
-import { t as getMatrixRuntime } from "./runtime-6S3DNFNv.js";
-import { n as resolveConfiguredMatrixBotUserIds } from "./accounts-GwSAk9vY.js";
-import { _ as toLocationContext, a as resolveMatrixRoomConfig, c as canonicalizeAllowlistWithResolvedIds, d as formatLocationText, f as getAgentScopedMediaLocalRoots, g as summarizeMapping, h as patchAllowlistUsersInConfigEntries, i as resolveMatrixThreadRouting, l as createReplyPrefixOptions, m as logTypingFailure, n as resolveMatrixStoredSessionMeta, o as addAllowlistUserEntriesFromConfigEntry, p as logInboundDrop, r as resolveMatrixInboundRoute, s as buildAllowlistResolutionSummary, u as createTypingCallbacks } from "./channel-Cg97H4c1.js";
-import { a as normalizeMatrixUserId, i as normalizeMatrixAllowList, o as resolveMatrixAllowListMatch } from "./channel.setup-DmS7m7aT.js";
-import { n as isMatrixRoomId, t as isMatrixQualifiedUserId } from "./target-ids-Nwx7cMVE.js";
-import { A as promoteMatrixDirectRoomCandidate, S as isPollStartType, c as formatMatrixMediaTooLargeText, d as isLikelyBareFilename, g as resolveMatrixThreadRootId, h as resolveMatrixReplyToEventId, l as formatMatrixMediaUnavailableText, p as resolveMatrixReplacementContent, r as sendMessageMatrix, u as formatMatrixMessageText, w as parsePollStartContent, x as isPollEventType, y as formatPollAsText } from "./send-UWLIQ0bG.js";
-import { i as isStrictDirectMembership, n as hasDirectMatrixMemberFlag, o as readJoinedMatrixMembers } from "./direct-room-RinHjtqX.js";
-import { n as MATRIX_REACTION_EVENT_TYPE } from "./reaction-common-DkrQdBSZ.js";
-import { n as MATRIX_OPENCLAW_FINALIZED_PREVIEW_KEY } from "./types-DzSc7Sqm.js";
-import { t as createMatrixThreadBindingManager } from "./thread-bindings-Bwv87Gve.js";
-import { l as fetchMatrixPollSnapshot, r as readMatrixMessages } from "./messages-CpZfiQO0.js";
-import { a as throwIfMatrixStartupAborted, c as backfillMatrixAuthDeviceIdAfterStartup, i as isMatrixStartupAbortError, l as resolveMatrixAuth, n as acquireSharedMatrixClient, o as createMatrixMonitorTaskRunner, u as resolveMatrixAuthContext } from "./client-CPcRv6ab.js";
-import { i as isMatrixMediaSizeLimitError, r as MatrixMediaSizeLimitError } from "./http-client-BfPeF4CE.js";
-import { n as prepareMatrixReplyPayload, r as resolveMatrixExtraContent } from "./outbound-D91JinYa.js";
-import { t as resolveMatrixTargets } from "./resolve-targets-K8D0HWPX.js";
-import { t as formatMatrixEncryptedEventDisabledWarning } from "./encryption-guidance-mDyxJV9U.js";
-import { createMatrixInboundEventDeduper } from "./inbound-dedupe-Ch33GU06.js";
-import { a as isMatrixAccessTokenInvalidatedError, d as isMatrixDisconnectedSyncState, f as isMatrixReadySyncState, p as isMatrixTerminalSyncState } from "./client-support-DLj4vDeu.js";
-import { i as setBoundedMap, r as getMatrixRoomInfo, t as createMatrixRoomInfoResolver } from "./room-info-BPVJkXnp.js";
+import { t as getMatrixRuntime } from "./runtime-1kn1P6io.mjs";
+import { a as resolveMatrixAccountConfig, i as resolveMatrixAccountAllowlistConfig } from "./account-config-CRsKoMqJ.mjs";
+import { n as resolveConfiguredMatrixBotUserIds } from "./accounts-BF5hyc-1.mjs";
+import { _ as toLocationContext, a as resolveMatrixRoomConfig, c as canonicalizeAllowlistWithResolvedIds, d as formatLocationText, f as getAgentScopedMediaLocalRoots, g as summarizeMapping, h as patchAllowlistUsersInConfigEntries, i as resolveMatrixThreadRouting, l as createReplyPrefixOptions, m as logTypingFailure, n as resolveMatrixStoredSessionMeta, o as addAllowlistUserEntriesFromConfigEntry, p as logInboundDrop, r as resolveMatrixInboundRoute, s as buildAllowlistResolutionSummary, u as createTypingCallbacks } from "./channel-q6TBKEiG.mjs";
+import { a as normalizeMatrixUserId, i as normalizeMatrixAllowList, o as resolveMatrixAllowListMatch } from "./channel.setup-DZQ5rf9k.mjs";
+import { n as isMatrixRoomId, t as isMatrixQualifiedUserId } from "./target-ids-Nwx7cMVE.mjs";
+import { a as MATRIX_REACTION_EVENT_TYPE } from "./send-currentness-BrGXL7b8.mjs";
+import { c as isStrictDirectMembership, f as resolveMatrixReplyToEventId, h as MATRIX_OPENCLAW_FINALIZED_PREVIEW_KEY, i as promoteMatrixDirectRoomCandidate, p as resolveMatrixThreadRootId, s as hasDirectMatrixMemberFlag, u as readJoinedMatrixMembers } from "./direct-management-B2Bno2xL.mjs";
+import { S as parsePollStartContent, _ as formatPollAsText, b as isPollStartType, c as formatMatrixMediaTooLargeText, d as isLikelyBareFilename, l as formatMatrixMediaUnavailableText, p as resolveMatrixReplacementContent, r as sendMessageMatrix, u as formatMatrixMessageText, y as isPollEventType } from "./send-h0gZ_-qk.mjs";
+import { t as createMatrixThreadBindingManager } from "./thread-bindings-Hy96ujd3.mjs";
+import { l as fetchMatrixPollSnapshot, r as readMatrixMessages } from "./messages-SW0NPYnR.mjs";
+import { c as createMatrixMonitorTaskRunner, d as resolveMatrixAuthContext, l as backfillMatrixAuthDeviceIdAfterStartup, o as isMatrixStartupAbortError, r as acquireSharedMatrixClient, s as throwIfMatrixStartupAborted, u as resolveMatrixAuth } from "./client-DsJUnWlV.mjs";
+import { i as isMatrixMediaSizeLimitError, r as MatrixMediaSizeLimitError } from "./http-client-BJjo-iw5.mjs";
+import { n as prepareMatrixReplyPayload, r as resolveMatrixExtraContent } from "./outbound-DRWtSUe-.mjs";
+import { t as resolveMatrixTargets } from "./resolve-targets-drjgAdIe.mjs";
+import { t as formatMatrixEncryptedEventDisabledWarning } from "./encryption-guidance-DYEbeYj-.mjs";
+import { createMatrixInboundEventDeduper } from "./inbound-dedupe-BSlv35xl.mjs";
+import { a as isMatrixAccessTokenInvalidatedError, d as isMatrixDisconnectedSyncState, f as isMatrixReadySyncState, p as isMatrixTerminalSyncState } from "./client-support-Bn9Bk0-H.mjs";
+import { i as setBoundedMap, r as getMatrixRoomInfo, t as createMatrixRoomInfoResolver } from "./room-info-DHd1j3qM.mjs";
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 import { createChannelProgressDraftCompositor, createPreviewMessageReceipt, defineFinalizableLivePreviewAdapter, deliverWithFinalizableLivePreviewAdapter, resolveChannelStreamingBlockEnabled, waitUntilAbort } from "openclaw/plugin-sdk/channel-outbound";
 import { normalizeLowercaseStringOrEmpty, normalizeNullableString, normalizeOptionalString, normalizeStringifiedEntries, readStringValue, uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
@@ -30,9 +29,9 @@ import { createAcceptedChannelDeliveryResult, createChannelInboundEnvelopeBuilde
 import { getSessionEntry, resolveStorePath } from "openclaw/plugin-sdk/session-store-runtime";
 import { KeyedAsyncQueue } from "openclaw/plugin-sdk/keyed-async-queue";
 import { escapeRegExp, sliceUtf16Safe, truncateUtf16Safe } from "openclaw/plugin-sdk/text-utility-runtime";
+import { buildTtsSupplementMediaPayload, getReplyPayloadTtsSupplement, resolveSendableOutboundReplyParts } from "openclaw/plugin-sdk/reply-payload";
 import { format } from "node:util";
 import { resolvePinnedMainDmOwnerFromAllowlist } from "openclaw/plugin-sdk/security-runtime";
-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";
@@ -40,8 +39,8 @@ import { isDangerousNameMatchingEnabled } from "openclaw/plugin-sdk/dangerous-na
 import { reportChannelRoomJoin } from "openclaw/plugin-sdk/channel-join-intro-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 { evaluateSupplementalContextVisibility, resolveChannelContextVisibilityMode } from "openclaw/plugin-sdk/context-visibility-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";
@@ -837,7 +836,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-UWLIQ0bG.js").then((n) => n.k), import("./direct-room-RinHjtqX.js").then((n) => n.t)]).then(([directManagementModule, directRoomModule]) => ({
+const loadMatrixDirectRoomDeps = createLazyRuntimeModule(() => Promise.all([import("./direct-management-B2Bno2xL.mjs").then((n) => n.t), import("./direct-management-B2Bno2xL.mjs").then((n) => n.o)]).then(([directManagementModule, directRoomModule]) => ({
 	inspectMatrixDirectRooms: directManagementModule.inspectMatrixDirectRooms,
 	isStrictDirectRoom: directRoomModule.isStrictDirectRoom
 })));
@@ -1655,11 +1654,11 @@ async function redactMatrixDraftEvent(client, roomId, draftEventId) {
 function buildMatrixFinalizedPreviewContent() {
 	return { [MATRIX_OPENCLAW_FINALIZED_PREVIEW_KEY]: true };
 }
-const loadMatrixSendModule = createLazyRuntimeModule(() => import("./send-UWLIQ0bG.js").then((n) => n.s));
+const loadMatrixSendModule = createLazyRuntimeModule(() => import("./send-h0gZ_-qk.mjs").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-2WM2nJe_.js"));
-const loadMatrixDraftStream = createLazyRuntimeModule(() => import("./draft-stream--NdEtnZ8.js"));
+const loadMatrixReactionEvents = createLazyRuntimeModule(() => import("./reaction-events-CdAk_rh_.mjs"));
+const loadMatrixDraftStream = createLazyRuntimeModule(() => import("./draft-stream-DIFZDNrb.mjs"));
 async function matrixTextWouldActivateMentions(client, text) {
 	const { resolveMatrixMentionsForBody } = await loadMatrixSendModule();
 	const mentions = await resolveMatrixMentionsForBody({
@@ -1670,6 +1669,11 @@ async function matrixTextWouldActivateMentions(client, text) {
 }
 //#endregion
 //#region extensions/matrix/src/matrix/monitor/context-summary.ts
+const MAX_CONTEXT_BODY_LENGTH = 500;
+function truncateMatrixContextBody(value) {
+	if (value.length <= MAX_CONTEXT_BODY_LENGTH) return value;
+	return `${sliceUtf16Safe(value, 0, 497)}...`;
+}
 function summarizeMatrixMessageContextEvent(event) {
 	if (isPollStartType(event.type)) {
 		const pollSummary = parsePollStartContent(event.content);
@@ -1685,14 +1689,9 @@ function summarizeMatrixMessageContextEvent(event) {
 //#endregion
 //#region extensions/matrix/src/matrix/monitor/reply-context.ts
 const MAX_CACHED_REPLY_CONTEXTS = 256;
-const MAX_REPLY_BODY_LENGTH = 500;
-function truncateReplyBody(value) {
-	if (value.length <= MAX_REPLY_BODY_LENGTH) return value;
-	return `${sliceUtf16Safe(value, 0, 497)}...`;
-}
 function summarizeMatrixReplyEvent(event) {
 	const body = summarizeMatrixMessageContextEvent(event);
-	return body ? truncateReplyBody(body) : void 0;
+	return body ? truncateMatrixContextBody(body) : void 0;
 }
 /**
 * Creates a cached resolver that fetches the body and sender of a replied-to
@@ -1702,11 +1701,7 @@ function summarizeMatrixReplyEvent(event) {
 function createMatrixReplyContextResolver(params) {
 	const cache = /* @__PURE__ */ new Map();
 	const remember = (key, value) => {
-		cache.set(key, value);
-		if (cache.size > MAX_CACHED_REPLY_CONTEXTS) {
-			const oldest = cache.keys().next().value;
-			if (typeof oldest === "string") cache.delete(oldest);
-		}
+		setBoundedMap(cache, key, value, MAX_CACHED_REPLY_CONTEXTS);
 		return value;
 	};
 	return async (input) => {
@@ -1738,14 +1733,9 @@ function createMatrixReplyContextResolver(params) {
 //#endregion
 //#region extensions/matrix/src/matrix/monitor/thread-context.ts
 const MAX_TRACKED_THREAD_STARTERS = 256;
-const MAX_THREAD_STARTER_BODY_LENGTH = 500;
-function truncateThreadStarterBody(value) {
-	if (value.length <= MAX_THREAD_STARTER_BODY_LENGTH) return value;
-	return `${sliceUtf16Safe(value, 0, 497)}...`;
-}
 function summarizeMatrixThreadStarterEvent(event) {
 	const body = summarizeMatrixMessageContextEvent(event);
-	if (body) return truncateThreadStarterBody(body);
+	if (body) return truncateMatrixContextBody(body);
 	const content = event.content;
 	const msgtype = normalizeOptionalString(content.msgtype);
 	if (msgtype) return `Matrix ${msgtype} message`;
@@ -1761,11 +1751,7 @@ function formatMatrixThreadStarterBody(params) {
 function createMatrixThreadContextResolver(params) {
 	const cache = /* @__PURE__ */ new Map();
 	const remember = (key, value) => {
-		cache.set(key, value);
-		if (cache.size > MAX_TRACKED_THREAD_STARTERS) {
-			const oldest = cache.keys().next().value;
-			if (typeof oldest === "string") cache.delete(oldest);
-		}
+		setBoundedMap(cache, key, value, MAX_TRACKED_THREAD_STARTERS);
 		return value;
 	};
 	return async (input) => {
@@ -1798,7 +1784,14 @@ function createMatrixThreadContextResolver(params) {
 //#endregion
 //#region extensions/matrix/src/matrix/monitor/handler-context.ts
 async function resolveMatrixInboundContext(config) {
-	const { client, core, cfg, accountId, resolveMessageIngress, runtime, logVerboseMessage, roomId, event, eventTs, route: _route, isDirectMessage, isRoom, effectiveRoomUsers, groupPolicy, effectiveGroupAllowFrom, contextVisibilityMode, resolveThreadContext, resolveReplyContext, threadRootId, thread, getRoomInfo, senderId, senderName, bodyText, commandBodyText, roomConfig, messageId, inboundHistory, wasMentioned, effectiveWasMentioned, shouldBypassMention, canDetectMention, shouldRequireMention, commandAuthorized, locationPayload, media, preflightAudioTranscript, historyLimit, hasExplicitSessionBinding, dmSessionScope, sharedDmContextNoticeRooms, resolveStorePath: resolveStorePathImpl, createChannelInboundEnvelopeBuilder: createChannelInboundEnvelopeBuilderImpl, finalizeInboundContext } = config;
+	const { handler, ingress, roomId, event, eventTs, resolveThreadContext, resolveReplyContext, senderId, sharedDmContextNoticeRooms } = config;
+	const { client, core, accountId, runtime, logVerboseMessage, groupPolicy, getRoomInfo, historyLimit, dmSessionScope, resolveStorePath: resolveStorePathImpl, createChannelInboundEnvelopeBuilder: createChannelInboundEnvelopeBuilderImpl, finalizeInboundContext } = handler;
+	const { cfg, resolveMessageIngress, route: _route, isDirectMessage, isRoom, effectiveRoomUsers, effectiveGroupAllowFrom, threadRootId, thread, senderName, bodyText, commandBodyText, roomConfig, messageId, inboundHistory, wasMentioned, effectiveWasMentioned, shouldBypassMention, canDetectMention, shouldRequireMention, commandAuthorized, locationPayload, media, preflightAudioTranscript, hasExplicitSessionBinding } = ingress;
+	const contextVisibilityMode = resolveChannelContextVisibilityMode({
+		cfg,
+		channel: "matrix",
+		accountId
+	});
 	const replyToEventId = resolveMatrixReplyToEventId(event.content);
 	const threadTarget = thread.threadId;
 	const isRoomContextSenderAllowed = (contextSenderId) => {
@@ -2045,7 +2038,10 @@ async function createMatrixDraftController(params) {
 			},
 			onPlanUpdate: async (payload) => {
 				if (payload.phase !== "update") return false;
-				return await progressDraft.pushPlanProgress(payload.steps, { explanation: payload.explanation });
+				return await progressDraft.pushPlanProgress(payload.steps, {
+					explanation: payload.explanation,
+					explanationFormat: payload.explanationFormat
+				});
 			},
 			onApprovalEvent: async (payload) => {
 				return await progressDraft.pushApprovalEvent(payload);
@@ -2152,7 +2148,7 @@ const MAX_WATERMARK_ENTRIES = 5e3;
 const MAX_PREPARED_TRIGGER_ENTRIES = 500;
 /** Maximum thread queues retained per room (FIFO eviction beyond this). */
 const MAX_THREAD_QUEUES_PER_ROOM = 200;
-function createRoomHistoryTrackerInternal(maxQueueSize = DEFAULT_MAX_QUEUE_SIZE, maxRoomQueues = DEFAULT_MAX_ROOM_QUEUES, maxWatermarkEntries = MAX_WATERMARK_ENTRIES, maxPreparedTriggerEntries = MAX_PREPARED_TRIGGER_ENTRIES) {
+function createRoomHistoryTracker(maxQueueSize = DEFAULT_MAX_QUEUE_SIZE, maxRoomQueues = DEFAULT_MAX_ROOM_QUEUES, maxWatermarkEntries = MAX_WATERMARK_ENTRIES, maxPreparedTriggerEntries = MAX_PREPARED_TRIGGER_ENTRIES) {
 	const roomQueues = /* @__PURE__ */ new Map();
 	/** Maps `{agentId, roomId, scope}` → absolute consumed-up-to index */
 	const agentWatermarks = /* @__PURE__ */ new Map();
@@ -2368,18 +2364,6 @@ function createRoomHistoryTrackerInternal(maxQueueSize = DEFAULT_MAX_QUEUE_SIZE,
 		}
 	};
 }
-function createRoomHistoryTracker(maxQueueSize = DEFAULT_MAX_QUEUE_SIZE, maxRoomQueues = DEFAULT_MAX_ROOM_QUEUES, maxWatermarkEntries = MAX_WATERMARK_ENTRIES, maxPreparedTriggerEntries = MAX_PREPARED_TRIGGER_ENTRIES) {
-	const tracker = createRoomHistoryTrackerInternal(maxQueueSize, maxRoomQueues, maxWatermarkEntries, maxPreparedTriggerEntries);
-	return {
-		recordPending: tracker.recordPending,
-		reservePending: tracker.reservePending,
-		finalizePending: tracker.finalizePending,
-		discardPending: tracker.discardPending,
-		prepareTrigger: tracker.prepareTrigger,
-		prepareReservedTrigger: tracker.prepareReservedTrigger,
-		consumeHistory: tracker.consumeHistory
-	};
-}
 //#endregion
 //#region extensions/matrix/src/matrix/monitor/handler-ingress-access.ts
 async function resolveMatrixIngressAccess(config) {
@@ -2586,46 +2570,24 @@ async function resolveMatrixIngressAccess(config) {
 //#endregion
 //#region extensions/matrix/src/matrix/monitor/media.ts
 const MATRIX_MEDIA_DOWNLOAD_IDLE_TIMEOUT_MS = 3e4;
-async function fetchMatrixMediaBuffer(params) {
-	try {
-		return { buffer: await params.client.downloadContent(params.mxcUrl, {
-			maxBytes: params.maxBytes,
-			readIdleTimeoutMs: MATRIX_MEDIA_DOWNLOAD_IDLE_TIMEOUT_MS
-		}) };
+async function downloadMatrixMedia(params) {
+	if (typeof params.sizeBytes === "number" && params.sizeBytes > params.maxBytes) throw new MatrixMediaSizeLimitError();
+	const options = {
+		maxBytes: params.maxBytes,
+		readIdleTimeoutMs: MATRIX_MEDIA_DOWNLOAD_IDLE_TIMEOUT_MS
+	};
+	let buffer;
+	if (params.file) {
+		if (!params.client.crypto) throw new Error("Cannot decrypt media: crypto not enabled");
+		buffer = await params.client.crypto.decryptMedia(params.file, options);
+		if (buffer.byteLength > params.maxBytes) throw new MatrixMediaSizeLimitError();
+	} else try {
+		buffer = await params.client.downloadContent(params.mxcUrl, options);
 	} catch (err) {
 		if (isMatrixMediaSizeLimitError(err)) throw err;
 		throw new Error(`Matrix media download failed: ${String(err)}`, { cause: err });
 	}
-}
-/**
-* Download and decrypt encrypted media from a Matrix room.
-* Uses the Matrix crypto adapter's decryptMedia helper.
-*/
-async function fetchEncryptedMediaBuffer(params) {
-	if (!params.client.crypto) throw new Error("Cannot decrypt media: crypto not enabled");
-	const decrypted = await params.client.crypto.decryptMedia(params.file, {
-		maxBytes: params.maxBytes,
-		readIdleTimeoutMs: MATRIX_MEDIA_DOWNLOAD_IDLE_TIMEOUT_MS
-	});
-	if (decrypted.byteLength > params.maxBytes) throw new MatrixMediaSizeLimitError();
-	return { buffer: decrypted };
-}
-async function downloadMatrixMedia(params) {
-	let fetched;
-	if (typeof params.sizeBytes === "number" && params.sizeBytes > params.maxBytes) throw new MatrixMediaSizeLimitError();
-	if (params.file) fetched = await fetchEncryptedMediaBuffer({
-		client: params.client,
-		file: params.file,
-		maxBytes: params.maxBytes
-	});
-	else fetched = await fetchMatrixMediaBuffer({
-		client: params.client,
-		mxcUrl: params.mxcUrl,
-		maxBytes: params.maxBytes
-	});
-	if (!fetched) return null;
-	const headerType = params.contentType ?? void 0;
-	const saved = await getMatrixRuntime().channel.media.saveMediaBuffer(fetched.buffer, headerType, "inbound", params.maxBytes, params.originalFilename);
+	const saved = await getMatrixRuntime().channel.media.saveMediaBuffer(buffer, params.contentType, "inbound", params.maxBytes, params.originalFilename);
 	return {
 		path: saved.path,
 		contentType: saved.contentType,
@@ -2803,9 +2765,35 @@ async function resolveMatrixIngressContent(config) {
 		return;
 	}
 	let preflightMedia = null;
-	let preflightMediaDownloadFailed = false;
-	let preflightMediaSizeLimitExceeded = false;
+	let mediaDownloadFailed = false;
+	let mediaSizeLimitExceeded = false;
 	let preflightAudioTranscript;
+	const downloadMedia = async (mxcUrl) => {
+		try {
+			return await downloadMatrixMedia({
+				client,
+				mxcUrl,
+				contentType: mediaContent.contentType,
+				sizeBytes: mediaContent.sizeBytes,
+				maxBytes: mediaMaxBytes,
+				file: mediaContent.file,
+				originalFilename: mediaContent.originalFilename
+			});
+		} catch (err) {
+			mediaDownloadFailed = true;
+			mediaSizeLimitExceeded = isMatrixMediaSizeLimitError(err);
+			const errorText = formatErrorMessage(err);
+			logVerboseMessage(`matrix: media download failed room=${roomId} id=${event.event_id ?? "unknown"} type=${content.msgtype} error=${errorText}`);
+			logger.warn("matrix media download failed", {
+				roomId,
+				eventId: event.event_id,
+				msgtype: content.msgtype,
+				encrypted: Boolean(mediaContent.file),
+				error: errorText
+			});
+			return null;
+		}
+	};
 	const { route: _route, configuredBinding: _configuredBinding, runtimeBindingId: _runtimeBindingId } = resolveMatrixInboundRoute({
 		cfg,
 		accountId,
@@ -2836,29 +2824,7 @@ async function resolveMatrixIngressContent(config) {
 		} };
 	}
 	if (shouldRunMatrixAudioPreflight) {
-		try {
-			preflightMedia = await downloadMatrixMedia({
-				client,
-				mxcUrl: preflightAudioMediaUrl,
-				contentType: mediaContent.contentType,
-				sizeBytes: mediaContent.sizeBytes,
-				maxBytes: mediaMaxBytes,
-				file: mediaContent.file,
-				originalFilename: mediaContent.originalFilename
-			});
-		} catch (err) {
-			preflightMediaDownloadFailed = true;
-			if (isMatrixMediaSizeLimitError(err)) preflightMediaSizeLimitExceeded = true;
-			const errorText = formatErrorMessage(err);
-			logVerboseMessage(`matrix: media download failed room=${roomId} id=${event.event_id ?? "unknown"} type=${content.msgtype} error=${errorText}`);
-			logger.warn("matrix media download failed", {
-				roomId,
-				eventId: event.event_id,
-				msgtype: content.msgtype,
-				encrypted: Boolean(mediaContent.file),
-				error: errorText
-			});
-		}
+		preflightMedia = await downloadMedia(preflightAudioMediaUrl);
 		if (preflightMedia) preflightAudioTranscript = await resolveMatrixPreflightAudioTranscript({
 			mediaPath: preflightMedia.path,
 			mediaContentType: preflightMedia.contentType,
@@ -2975,32 +2941,8 @@ async function resolveMatrixIngressContent(config) {
 		mediaContent = resolveMatrixInboundMediaContent(content);
 	}
 	let media = preflightMedia;
-	let mediaDownloadFailed = preflightMediaDownloadFailed;
-	let mediaSizeLimitExceeded = preflightMediaSizeLimitExceeded;
 	const finalMediaUrl = mediaContent.url;
-	if (!media && !mediaDownloadFailed && finalMediaUrl?.startsWith("mxc://")) try {
-		media = await downloadMatrixMedia({
-			client,
-			mxcUrl: finalMediaUrl,
-			contentType: mediaContent.contentType,
-			sizeBytes: mediaContent.sizeBytes,
-			maxBytes: mediaMaxBytes,
-			file: mediaContent.file,
-			originalFilename: mediaContent.originalFilename
-		});
-	} catch (err) {
-		mediaDownloadFailed = true;
-		if (isMatrixMediaSizeLimitError(err)) mediaSizeLimitExceeded = true;
-		const errorText = formatErrorMessage(err);
-		logVerboseMessage(`matrix: media download failed room=${roomId} id=${event.event_id ?? "unknown"} type=${content.msgtype} error=${errorText}`);
-		logger.warn("matrix media download failed", {
-			roomId,
-			eventId: event.event_id,
-			msgtype: content.msgtype,
-			encrypted: Boolean(mediaContent.file),
-			error: errorText
-		});
-	}
+	if (!media && !mediaDownloadFailed && finalMediaUrl?.startsWith("mxc://")) media = await downloadMedia(finalMediaUrl);
 	let bodyText = resolveMatrixInboundBodyText({
 		rawBody: locationPayload?.text ?? mediaContent.body,
 		filename: typeof content.filename === "string" ? content.filename : void 0,
@@ -3320,6 +3262,19 @@ function createMatrixReplyDispatcher(config) {
 	const { cfg, prefixOptions, humanDelay, typingCallbacks, streaming, draftStream, draftController, client, roomId, runtime, replyToMode, threadTarget, replyToEventId, accountId, mediaLocalRoots, logVerboseMessage } = config;
 	const quietDraftStreaming = streaming === "quiet" || streaming === "progress";
 	const hasRepliedRef = { value: false };
+	const deliverPayload = (reply) => deliverMatrixReplies({
+		cfg,
+		replies: [reply],
+		roomId,
+		client,
+		runtime,
+		replyToMode,
+		hasRepliedRef,
+		threadId: threadTarget,
+		replyToId: threadTarget ?? replyToEventId ?? void 0,
+		accountId,
+		mediaLocalRoots
+	});
 	let finalReplyDeliveryFailed = false;
 	let nonFinalReplyDeliveryFailed = false;
 	const beginNextBlockDraft = () => {
@@ -3383,20 +3338,9 @@ function createMatrixReplyDispatcher(config) {
 				} : payload;
 				if (draftController.draftDisposition() !== "active") {
 					await draftStream.discardPending();
-					return await completeDelivery(await deliverMatrixReplies({
-						cfg,
-						replies: [fallbackPayload],
-						roomId,
-						client,
-						runtime,
-						replyToMode,
-						hasRepliedRef,
-						threadId: threadTarget,
-						replyToId: threadTarget ?? replyToEventId ?? void 0,
-						accountId,
-						mediaLocalRoots
-					}));
+					return await completeDelivery(await deliverPayload(fallbackPayload));
 				}
+				const deliverFallback = async () => await deliverPayload(fallbackPayload);
 				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) {
@@ -3466,19 +3410,7 @@ function createMatrixReplyDispatcher(config) {
 							fallbackResult = await settleDraftReplacement({
 								draftEventId,
 								draftContent: draftStream.content() ?? preparedFinalPreviewContent,
-								deliver: async () => await deliverMatrixReplies({
-									cfg,
-									replies: [fallbackPayload],
-									roomId,
-									client,
-									runtime,
-									replyToMode,
-									hasRepliedRef,
-									threadId: threadTarget,
-									replyToId: threadTarget ?? replyToEventId ?? void 0,
-									accountId,
-									mediaLocalRoots
-								})
+								deliver: deliverFallback
 							});
 							return fallbackResult.visibleReplySent;
 						}
@@ -3527,19 +3459,7 @@ function createMatrixReplyDispatcher(config) {
 					};
 					const providerDraftContent = finalizedDraftContent ?? preparedPayloadContent;
 					const previewDelivery = reusesDraftAsFinalText && providerDraftContent ? createDraftDeliveryResult(draftEventId, providerDraftContent) : draftContent ? createDraftDeliveryResult(draftEventId, draftContent) : mergeMatrixReplyDeliveryResults([]);
-					const deliverMedia = async () => await deliverMatrixReplies({
-						cfg,
-						replies: [mediaPayload],
-						roomId,
-						client,
-						runtime,
-						replyToMode,
-						hasRepliedRef,
-						threadId: threadTarget,
-						replyToId: threadTarget ?? replyToEventId ?? void 0,
-						accountId,
-						mediaLocalRoots
-					});
+					const deliverMedia = async () => await deliverPayload(mediaPayload);
 					if (reusesDraftAsFinalText) {
 						draftController.markDraftConsumed();
 						let mediaDelivery;
@@ -3558,19 +3478,6 @@ function createMatrixReplyDispatcher(config) {
 					return await completeDelivery(await deliverMedia());
 				}
 				const shouldRedactDraft = Boolean(draftEventId) && (payload.isError || payloadReplyMismatch || mustDeliverFinalNormally || draftFinalTextNeedsNormalMentionDelivery);
-				const deliverFallback = async () => await deliverMatrixReplies({
-					cfg,
-					replies: [fallbackPayload],
-					roomId,
-					client,
-					runtime,
-					replyToMode,
-					hasRepliedRef,
-					threadId: threadTarget,
-					replyToId: threadTarget ?? replyToEventId ?? void 0,
-					accountId,
-					mediaLocalRoots
-				});
 				const draftContent = draftStream.content();
 				if (shouldRedactDraft && draftEventId && draftContent) return await completeDelivery(await settleDraftReplacement({
 					draftEventId,
@@ -3579,19 +3486,7 @@ function createMatrixReplyDispatcher(config) {
 				}));
 				return await completeDelivery(await deliverFallback());
 			}
-			return await completeDelivery(await deliverMatrixReplies({
-				cfg,
-				replies: [payload],
-				roomId,
-				client,
-				runtime,
-				replyToMode,
-				hasRepliedRef,
-				threadId: threadTarget,
-				replyToId: threadTarget ?? replyToEventId ?? void 0,
-				accountId,
-				mediaLocalRoots
-			}));
+			return await completeDelivery(await deliverPayload(payload));
 		},
 		onError: (err, info) => {
 			if (info.kind === "final") finalReplyDeliveryFailed = true;
@@ -3718,7 +3613,7 @@ function createMatrixHandlerState(config) {
 const SESSION_RESTART_RECOVERY_TOMBSTONE_ERROR_CODE = "SESSION_RESTART_RECOVERY_TOMBSTONE";
 const RESTART_RECOVERY_TOMBSTONE_NOTICE = "This session ended during gateway restart recovery and cannot accept more messages. Send /new or /reset to start a replacement session.";
 function createMatrixRoomMessageHandler(params) {
-	const { client, core, cfg: startupConfig, accountId, runtime, logger, logVerboseMessage, allowFromResolvedEntries = [], groupAllowFromResolvedEntries = [], configuredBotUserIds = /* @__PURE__ */ new Set(), groupPolicy, replyToMode, dmSessionScope, streaming, previewToolProgressEnabled, blockStreamingEnabled, historyLimit, startupMs, startupGraceMs, dropPreStartupMessages, inboundDeduper, directTracker, getRoomInfo, getMemberDisplayName, resolveLiveUserAllowlist = resolveMatrixMonitorLiveUserAllowlist, resolveStorePath: resolveStorePathImpl = resolveStorePath, createChannelInboundEnvelopeBuilder: createChannelInboundEnvelopeBuilderImpl = createChannelInboundEnvelopeBuilder, finalizeInboundContext, resolveHumanDelayConfig: resolveHumanDelayConfigImpl = resolveHumanDelayConfig } = params;
+	const { client, core, cfg: startupConfig, accountId, runtime, logger, logVerboseMessage, allowFromResolvedEntries = [], groupAllowFromResolvedEntries = [], configuredBotUserIds = /* @__PURE__ */ new Set(), replyToMode, streaming, previewToolProgressEnabled, blockStreamingEnabled, historyLimit, startupMs, startupGraceMs, dropPreStartupMessages, inboundDeduper, directTracker, getMemberDisplayName, resolveLiveUserAllowlist = resolveMatrixMonitorLiveUserAllowlist, resolveStorePath: resolveStorePathImpl = resolveStorePath, createChannelInboundEnvelopeBuilder: createChannelInboundEnvelopeBuilderImpl = createChannelInboundEnvelopeBuilder, resolveHumanDelayConfig: resolveHumanDelayConfigImpl = resolveHumanDelayConfig } = params;
 	const handlerConfig = {
 		...params,
 		allowFromResolvedEntries,
@@ -3846,58 +3741,17 @@ function createMatrixRoomMessageHandler(params) {
 			})();
 			if (!resolvedIngressResult) return;
 			if ("deferredPrefix" in resolvedIngressResult) return;
-			const { cfg, liveDmAllowFrom, route: _route, hasExplicitSessionBinding, roomConfig, isDirectMessage, isRoom, shouldRequireMention, wasMentioned, effectiveWasMentioned, shouldBypassMention, canDetectMention, commandAuthorized, inboundHistory, senderName, bodyText, commandBodyText, media, preflightAudioTranscript, locationPayload, messageId, triggerSnapshot, threadRootId, thread, botLoopProtection, effectiveGroupAllowFrom, effectiveRoomUsers, resolveMessageIngress } = resolvedIngressResult;
-			const contextVisibilityMode = resolveChannelContextVisibilityMode({
-				cfg,
-				channel: "matrix",
-				accountId
-			});
+			const { cfg, liveDmAllowFrom, route: _route, roomConfig, isDirectMessage, isRoom, bodyText, messageId, triggerSnapshot, threadRootId, thread, botLoopProtection } = resolvedIngressResult;
 			const inboundContext = await resolveMatrixInboundContext({
-				resolveMessageIngress,
-				client,
-				core,
-				cfg,
-				accountId,
-				runtime,
-				logVerboseMessage,
+				handler: handlerConfig,
+				ingress: resolvedIngressResult,
 				roomId,
 				event,
 				eventTs: eventTs ?? void 0,
-				route: _route,
-				isDirectMessage,
-				isRoom,
-				effectiveRoomUsers,
-				groupPolicy,
-				effectiveGroupAllowFrom,
-				contextVisibilityMode,
 				resolveThreadContext,
 				resolveReplyContext,
-				threadRootId,
-				thread,
-				getRoomInfo,
 				senderId,
-				senderName,
-				bodyText,
-				commandBodyText,
-				roomConfig,
-				messageId,
-				inboundHistory,
-				wasMentioned,
-				effectiveWasMentioned,
-				shouldBypassMention,
-				canDetectMention,
-				shouldRequireMention,
-				commandAuthorized,
-				locationPayload,
-				media,
-				preflightAudioTranscript,
-				historyLimit,
-				hasExplicitSessionBinding,
-				dmSessionScope,
-				sharedDmContextNoticeRooms,
-				resolveStorePath: resolveStorePathImpl,
-				createChannelInboundEnvelopeBuilder: createChannelInboundEnvelopeBuilderImpl,
-				finalizeInboundContext
+				sharedDmContextNoticeRooms
 			});
 			if (!inboundContext) return;
 			const { replyToEventId, threadTarget, storePath, ctxPayload, replyTarget, sharedDmContextNotice } = inboundContext;
@@ -4161,10 +4015,10 @@ function shouldPromoteRecentInviteRoom(params) {
 //#endregion
 //#region extensions/matrix/src/matrix/monitor/startup.ts
 const loadMatrixStartupMaintenanceDeps = createLazyRuntimeModule(() => Promise.all([
-	import("./config-update-BnX26jCO.js").then((n) => n.t),
-	import("./device-health-B4-YXtJR.js").then((n) => n.t),
-	import("./profile-vmjsmhh4.js").then((n) => n.n),
-	import("./startup-verification-BTSf31hS.js")
+	import("./config-update-B_4qZ5bV.mjs").then((n) => n.t),
+	import("./device-health-CWOuIirq.mjs").then((n) => n.t),
+	import("./profile-ClrB3IgR.mjs").then((n) => n.n),
+	import("./startup-verification-Bq5qeEGn.mjs")
 ]).then(([configUpdateModule, deviceHealthModule, profileModule, startupVerificationModule]) => ({
 	updateMatrixAccountConfig: configUpdateModule.updateMatrixAccountConfig,
 	summarizeMatrixDeviceHealth: deviceHealthModule.summarizeMatrixDeviceHealth,

package/dist/{outbound-D91JinYa.js → .setup/outbound-DRWtSUe-.mjs}

@@ -1,4 +1,4 @@
-import { i as sendPollMatrix, r as sendMessageMatrix } from "./send-UWLIQ0bG.js";
+import { i as sendPollMatrix, r as sendMessageMatrix } from "./send-h0gZ_-qk.mjs";
 import { createMessageReceiptFromOutboundResults, createReplyToFanout, resolveOutboundSendDep } from "openclaw/plugin-sdk/channel-outbound";
 import { asOptionalRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { chunkTextForOutbound } from "openclaw/plugin-sdk/text-chunking";
@@ -100,7 +100,7 @@ const matrixOutbound = {
 		payload,
 		presentation
 	}),
-	sendPayload: async ({ cfg, to, payload, mediaLocalRoots, mediaReadFile, mediaAccess, deps, replyToId, replyToIdSource, replyToMode, threadId, accountId, audioAsVoice, deliveryQueueId, onPlatformSendDispatch, onDeliveryResult }) => {
+	sendPayload: async ({ cfg, to, payload, mediaLocalRoots, mediaReadFile, mediaAccess, deps, replyToId, replyToIdSource, replyToMode, threadId, accountId, audioAsVoice, deliveryQueueId, signal, assertDirectAdapterHandoff, onPlatformSendDispatch, onDeliveryResult }) => {
 		const send = resolveOutboundSendDep(deps, "matrix") ?? sendMessageMatrix;
 		const resolvedThreadId = threadId !== void 0 && threadId !== null ? String(threadId) : void 0;
 		const resolveReplyToId = createReplyToFanout({
@@ -128,6 +128,8 @@ const matrixOutbound = {
 					deliveryQueueId,
 					deliveryPartIndex: index,
 					deliveryPartCount: urls.length,
+					signal,
+					assertDirectAdapterHandoff,
 					onPlatformSendDispatch,
 					extraContent: isFirst ? resolveMatrixExtraContent(payload) : void 0,
 					onDeliveryResult: resolveMatrixDeliveryProgress(onDeliveryResult)
@@ -162,13 +164,15 @@ const matrixOutbound = {
 			deliveryQueueId,
 			deliveryPartIndex: 0,
 			deliveryPartCount: 1,
+			signal,
+			assertDirectAdapterHandoff,
 			onPlatformSendDispatch,
 			extraContent: resolveMatrixExtraContent(payload),
 			onDeliveryResult: resolveMatrixDeliveryProgress(onDeliveryResult)
 		});
 		return attachChannelToResult("matrix", toMatrixOutboundResult(result));
 	},
-	sendText: async ({ cfg, to, text, deps, replyToId, threadId, accountId, audioAsVoice, deliveryQueueId, deliveryPartIndex, deliveryPartCount, onPlatformSendDispatch, onDeliveryResult }) => {
+	sendText: async ({ cfg, to, text, deps, replyToId, threadId, accountId, audioAsVoice, deliveryQueueId, deliveryPartIndex, deliveryPartCount, signal, assertDirectAdapterHandoff, onPlatformSendDispatch, onDeliveryResult }) => {
 		const result = await (resolveOutboundSendDep(deps, "matrix") ?? sendMessageMatrix)(to, text, {
 			cfg,
 			replyToId: replyToId ?? void 0,
@@ -178,12 +182,14 @@ const matrixOutbound = {
 			deliveryQueueId,
 			deliveryPartIndex,
 			...deliveryQueueId !== void 0 ? { deliveryPartCount } : {},
+			signal,
+			assertDirectAdapterHandoff,
 			onPlatformSendDispatch,
 			onDeliveryResult: resolveMatrixDeliveryProgress(onDeliveryResult)
 		});
 		return attachChannelToResult("matrix", toMatrixOutboundResult(result));
 	},
-	sendMedia: async ({ cfg, to, text, mediaUrl, mediaLocalRoots, mediaReadFile, mediaAccess, deps, replyToId, threadId, accountId, audioAsVoice, deliveryQueueId, deliveryPartIndex, deliveryPartCount, onPlatformSendDispatch, onDeliveryResult }) => {
+	sendMedia: async ({ cfg, to, text, mediaUrl, mediaLocalRoots, mediaReadFile, mediaAccess, deps, replyToId, threadId, accountId, audioAsVoice, deliveryQueueId, deliveryPartIndex, deliveryPartCount, signal, assertDirectAdapterHandoff, onPlatformSendDispatch, onDeliveryResult }) => {
 		const result = await (resolveOutboundSendDep(deps, "matrix") ?? sendMessageMatrix)(to, text, {
 			cfg,
 			mediaUrl,
@@ -197,6 +203,8 @@ const matrixOutbound = {
 			deliveryQueueId,
 			deliveryPartIndex,
 			...deliveryQueueId !== void 0 ? { deliveryPartCount } : {},
+			signal,
+			assertDirectAdapterHandoff,
 			onPlatformSendDispatch,
 			onDeliveryResult: resolveMatrixDeliveryProgress(onDeliveryResult)
 		});