@openclaw/matrix 2026.5.12 → 2026.5.14-beta.1

package/dist/{monitor-C8cEvvTe.js → monitor-COvHRaUQ.js}

@@ -1,28 +1,28 @@
 import { t as isMatrixQualifiedUserId } from "./target-ids-80nQ2gql.js";
-import { a as resolveMatrixAccountConfig, i as resolveMatrixAccountAllowlistConfig } from "./account-config-D2W-V1eQ.js";
+import { a as resolveMatrixAccountConfig, i as resolveMatrixAccountAllowlistConfig } from "./account-config-LVxGiX7e.js";
 import { t as getMatrixRuntime } from "./runtime-Dog86njy.js";
-import { n as resolveConfiguredMatrixBotUserIds } from "./accounts-Bm90Rzvp.js";
+import { n as resolveConfiguredMatrixBotUserIds } from "./accounts--0L_EuMK.js";
 import { n as normalizeMatrixUserId, r as resolveMatrixAllowListMatch, t as normalizeMatrixAllowList } from "./allowlist-sTzpCn5d.js";
 import { r as isMatrixNotFoundError, t as formatMatrixErrorMessage } from "./errors-CTcpEDq-.js";
 import { a as canonicalizeAllowlistWithResolvedIds, c as formatLocationText, d as logTypingFailure, f as patchAllowlistUsersInConfigEntries, i as buildAllowlistResolutionSummary, l as getAgentScopedMediaLocalRoots, m as toLocationContext, n as resolveMatrixRoomConfig, o as createReplyPrefixOptions, p as summarizeMapping, r as addAllowlistUserEntriesFromConfigEntry, s as createTypingCallbacks, t as resolveMatrixStoredSessionMeta, u as logInboundDrop } from "./session-store-metadata-DQXjgNLt.js";
 import { i as resolveMatrixStateFilePath } from "./storage-tC3ujLiW.js";
-import { a as sendMessageMatrix, g as isPollStartType, h as isPollEventType, p as formatPollAsText, t as chunkMatrixText, v as parsePollStartContent } from "./send-Df-pDuG6.js";
+import { a as sendMessageMatrix, g as isPollStartType, h as isPollEventType, p as formatPollAsText, t as chunkMatrixText, v as parsePollStartContent } from "./send-D651usmb.js";
 import { i as promoteMatrixDirectRoomCandidate, s as MATRIX_OPENCLAW_FINALIZED_PREVIEW_KEY } from "./direct-management--Y8ypgLv.js";
 import { i as isStrictDirectMembership, n as hasDirectMatrixMemberFlag, o as readJoinedMatrixMembers } from "./direct-room-XkutHjES.js";
-import { t as createMatrixThreadBindingManager } from "./thread-bindings--P1UYe7t.js";
+import { t as createMatrixThreadBindingManager } from "./thread-bindings-DHUszTA0.js";
 import { t as createAsyncLock } from "./async-lock-uQfhfQIY.js";
 import { n as LogService } from "./logger-CnZRVrux.js";
 import { i as isMatrixMediaSizeLimitError, r as MatrixMediaSizeLimitError } from "./http-client-C7AeVJay.js";
 import { i as throwIfMatrixStartupAborted, r as isMatrixStartupAbortError } from "./startup-abort-56edvmbM.js";
 import { n as isMatrixReadySyncState, r as isMatrixTerminalSyncState, t as isMatrixDisconnectedSyncState } from "./sync-state-C_beeevA.js";
-import { a as resolveMatrixMessageBody, i as resolveMatrixMessageAttachment, n as formatMatrixMediaUnavailableText, r as formatMatrixMessageText, s as fetchMatrixPollSnapshot, t as formatMatrixMediaTooLargeText } from "./media-text-psyGloYl.js";
+import { a as resolveMatrixMessageBody, i as resolveMatrixMessageAttachment, n as formatMatrixMediaUnavailableText, r as formatMatrixMessageText, s as fetchMatrixPollSnapshot, t as formatMatrixMediaTooLargeText } from "./media-text-BLL8-Dr3.js";
 import { n as setActiveMatrixClient } from "./active-client-uhlxdhEy.js";
 import { t as isBunRuntime } from "./runtime-C6X4h_SJ.js";
-import { n as resolveMatrixAuth, r as resolveMatrixAuthContext, t as backfillMatrixAuthDeviceIdAfterStartup } from "./config-BR4uLzNs.js";
-import { i as resolveSharedMatrixClient, n as releaseSharedClientInstance } from "./shared-CkbpEI5j.js";
-import "./client-CyxIx4Fv.js";
+import { n as resolveMatrixAuth, r as resolveMatrixAuthContext, t as backfillMatrixAuthDeviceIdAfterStartup } from "./config-xD5Y8nFT.js";
+import { i as resolveSharedMatrixClient, n as releaseSharedClientInstance } from "./shared-DarXfhzC.js";
+import "./client-DBDvsx0D.js";
 import { d as resolveDefaultGroupPolicy, h as warnMissingProviderGroupPolicyFallbackOnce, m as resolveThreadBindingMaxAgeMsForChannel, p as resolveThreadBindingIdleTimeoutMsForChannel, t as GROUP_POLICY_BLOCKED_LABEL, u as resolveAllowlistProviderRuntimeGroupPolicy } from "./runtime-api-DTKcXOhp.js";
-import { t as resolveMatrixTargets } from "./resolve-targets-BbzYe9Qi.js";
+import { t as resolveMatrixTargets } from "./resolve-targets-ZSM4KKln.js";
 import { t as formatMatrixEncryptedEventDisabledWarning } from "./encryption-guidance-BPi3A_m3.js";
 import { a as EventType, i as resolveMatrixThreadRouting, n as resolveMatrixReplyToEventId, o as RelationType, r as resolveMatrixThreadRootId, t as resolveMatrixInboundRoute } from "./route-D6rg-iXN.js";
 import { normalizeLowercaseStringOrEmpty, normalizeOptionalString, normalizeStringifiedOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
@@ -37,8 +37,9 @@ import { waitUntilAbort } from "openclaw/plugin-sdk/channel-lifecycle";
 import { registerChannelRuntimeContext } from "openclaw/plugin-sdk/channel-runtime-context";
 import { isDangerousNameMatchingEnabled } from "openclaw/plugin-sdk/dangerous-name-runtime";
 import { createChannelIngressResolver, defineStableChannelIngressIdentity } from "openclaw/plugin-sdk/channel-ingress-runtime";
-import { createChannelProgressDraftGate, formatChannelProgressDraftLine, formatChannelProgressDraftLineForEntry, formatChannelProgressDraftText, isChannelProgressDraftWorkToolName, resolveChannelProgressDraftMaxLines } from "openclaw/plugin-sdk/channel-streaming";
+import { buildChannelProgressDraftLineForEntry, createChannelProgressDraftGate, formatChannelProgressDraftLine, formatChannelProgressDraftLineForEntry, formatChannelProgressDraftText, isChannelProgressDraftWorkToolName, mergeChannelProgressDraftLine, normalizeChannelProgressDraftLineIdentity, resolveChannelProgressDraftMaxLines } from "openclaw/plugin-sdk/channel-streaming";
 import { evaluateSupplementalContextVisibility, resolveChannelContextVisibilityMode } from "openclaw/plugin-sdk/context-visibility-runtime";
+import { mergePairLoopGuardConfig } from "openclaw/plugin-sdk/pair-loop-guard-runtime";
 import { resolvePinnedMainDmOwnerFromAllowlist } from "openclaw/plugin-sdk/security-runtime";
 import { escapeRegExp } from "openclaw/plugin-sdk/text-utility-runtime";
 import { createConnectedChannelStatusPatch, createTransportActivityStatusPatch } from "openclaw/plugin-sdk/gateway-runtime";
@@ -1387,6 +1388,13 @@ function resolveMatrixAckReactionConfig(params) {
 }
 //#endregion
 //#region extensions/matrix/src/matrix/monitor/location.ts
+function decodeGeoUriParamValue(value) {
+	try {
+		return decodeURIComponent(value);
+	} catch {
+		return value;
+	}
+}
 function parseGeoUri(value) {
 	const trimmed = value.trim();
 	if (!trimmed) return null;
@@ -1407,7 +1415,7 @@ function parseGeoUri(value) {
 		const key = normalizeLowercaseStringOrEmpty(rawKey);
 		if (!key) continue;
 		const valuePart = rawValue.trim();
-		params.set(key, valuePart ? decodeURIComponent(valuePart) : "");
+		params.set(key, valuePart ? decodeGeoUriParamValue(valuePart) : "");
 	}
 	const accuracyRaw = params.get("u");
 	const accuracy = accuracyRaw ? Number.parseFloat(accuracyRaw) : void 0;
@@ -2001,7 +2009,7 @@ let sessionBindingRuntimePromise;
 let matrixReactionEventsPromise;
 let matrixDraftStreamPromise;
 function loadMatrixSendModule() {
-	matrixSendModulePromise ??= import("./send-Df-pDuG6.js").then((n) => n.l);
+	matrixSendModulePromise ??= import("./send-D651usmb.js").then((n) => n.l);
 	return matrixSendModulePromise;
 }
 function loadAcpBindingRuntime() {
@@ -2013,11 +2021,11 @@ function loadSessionBindingRuntime() {
 	return sessionBindingRuntimePromise;
 }
 function loadMatrixReactionEvents() {
-	matrixReactionEventsPromise ??= import("./reaction-events-CiARZfjk.js");
+	matrixReactionEventsPromise ??= import("./reaction-events-Cfvkp-A-.js");
 	return matrixReactionEventsPromise;
 }
 function loadMatrixDraftStream() {
-	matrixDraftStreamPromise ??= import("./draft-stream-D_FlbmCh.js");
+	matrixDraftStreamPromise ??= import("./draft-stream-B-hyLmMw.js");
 	return matrixDraftStreamPromise;
 }
 const MAX_TRACKED_PAIRING_REPLY_SENDERS = 512;
@@ -2122,7 +2130,7 @@ function formatMatrixToolProgressMarkdownCode(text) {
 	return `\`${(text.length <= MATRIX_TOOL_PROGRESS_MAX_CHARS ? text : `${text.slice(0, MATRIX_TOOL_PROGRESS_MAX_CHARS - 1).trimEnd()}...`).replaceAll("`", "'")}\``;
 }
 function createMatrixRoomMessageHandler(params) {
-	const { client, core, cfg, accountId, runtime, logger, logVerboseMessage, allowFromResolvedEntries = [], groupAllowFromResolvedEntries = [], roomsConfig, accountAllowBots, configuredBotUserIds = /* @__PURE__ */ new Set(), groupPolicy, replyToMode, threadReplies, dmThreadReplies, dmSessionScope, streaming, previewToolProgressEnabled, blockStreamingEnabled, dmEnabled, dmPolicy, textLimit, mediaMaxBytes, historyLimit, startupMs, startupGraceMs, dropPreStartupMessages, inboundDeduper, directTracker, getRoomInfo, getMemberDisplayName, needsRoomAliasesForConfig, resolveLiveUserAllowlist = resolveMatrixMonitorLiveUserAllowlist } = params;
+	const { client, core, cfg, accountId, accountConfig, runtime, logger, logVerboseMessage, allowFromResolvedEntries = [], groupAllowFromResolvedEntries = [], roomsConfig, accountAllowBots, configuredBotUserIds = /* @__PURE__ */ new Set(), groupPolicy, replyToMode, threadReplies, dmThreadReplies, dmSessionScope, streaming, previewToolProgressEnabled, blockStreamingEnabled, dmEnabled, dmPolicy, textLimit, mediaMaxBytes, historyLimit, startupMs, startupGraceMs, dropPreStartupMessages, inboundDeduper, directTracker, getRoomInfo, getMemberDisplayName, needsRoomAliasesForConfig, resolveLiveUserAllowlist = resolveMatrixMonitorLiveUserAllowlist } = params;
 	const contextVisibilityMode = resolveChannelContextVisibilityMode({
 		cfg,
 		channel: "matrix",
@@ -2311,6 +2319,16 @@ function createMatrixRoomMessageHandler(params) {
 					await commitInboundEventIfClaimed();
 					return;
 				}
+				const botLoopProtection = isConfiguredBotSender && senderId !== selfUserId ? {
+					scopeId: accountId,
+					conversationId: roomId,
+					senderId,
+					receiverId: selfUserId,
+					config: mergePairLoopGuardConfig(accountConfig?.botLoopProtection, roomConfig?.botLoopProtection),
+					defaultsConfig: cfg.channels?.defaults?.botLoopProtection,
+					defaultEnabled: true,
+					nowMs: eventTs ?? void 0
+				} : void 0;
 				if (isRoom && roomConfig && !roomConfigInfo?.allowed) {
 					logVerboseMessage(`matrix: room disabled room=${roomId} (${roomMatchMeta})`);
 					await commitInboundEventIfClaimed();
@@ -2659,6 +2677,7 @@ function createMatrixRoomMessageHandler(params) {
 					triggerSnapshot: preparedTrigger,
 					threadRootId,
 					thread,
+					botLoopProtection,
 					effectiveGroupAllowFrom,
 					effectiveRoomUsers
 				};
@@ -2675,7 +2694,7 @@ function createMatrixRoomMessageHandler(params) {
 				return await continueIngress(prefix);
 			})();
 			if (!resolvedIngressResult) return;
-			const { route: _route, hasExplicitSessionBinding, roomConfig, isDirectMessage, isRoom, shouldRequireMention, wasMentioned, shouldBypassMention, canDetectMention, commandAuthorized, inboundHistory, senderName, bodyText, commandBodyText, media, locationPayload, messageId, triggerSnapshot, threadRootId, thread, effectiveGroupAllowFrom, effectiveRoomUsers } = resolvedIngressResult;
+			const { route: _route, hasExplicitSessionBinding, roomConfig, isDirectMessage, isRoom, shouldRequireMention, wasMentioned, shouldBypassMention, canDetectMention, commandAuthorized, inboundHistory, senderName, bodyText, commandBodyText, media, locationPayload, messageId, triggerSnapshot, threadRootId, thread, botLoopProtection, effectiveGroupAllowFrom, effectiveRoomUsers } = resolvedIngressResult;
 			const replyToEventId = resolveMatrixReplyToEventId(event.content);
 			const threadTarget = thread.threadId;
 			const isRoomContextSenderAllowed = (contextSenderId) => {
@@ -2906,11 +2925,13 @@ function createMatrixRoomMessageHandler(params) {
 			const pushPreviewToolProgress = async (line, options) => {
 				if (!draftStream) return;
 				if (options?.toolName !== void 0 && !isChannelProgressDraftWorkToolName(options.toolName)) return;
-				const normalized = line?.replace(/\s+/g, " ").trim();
+				const normalized = normalizeChannelProgressDraftLineIdentity(line);
+				const progressLine = typeof line === "object" && line !== void 0 ? line : normalized;
 				if (!progressDraftStreaming) {
 					if (!shouldStreamPreviewToolProgress || previewToolProgressSuppressed || !normalized) return;
-					if (previewToolProgressLines.at(-1) === normalized) return;
-					previewToolProgressLines = [...previewToolProgressLines, normalized].slice(-resolveChannelProgressDraftMaxLines(progressConfigEntry));
+					const nextLines = mergeChannelProgressDraftLine(previewToolProgressLines, progressLine, { maxLines: resolveChannelProgressDraftMaxLines(progressConfigEntry) });
+					if (nextLines === previewToolProgressLines) return;
+					previewToolProgressLines = nextLines;
 					draftStream.update(formatChannelProgressDraftText({
 						entry: progressConfigEntry,
 						lines: previewToolProgressLines,
@@ -2920,9 +2941,7 @@ function createMatrixRoomMessageHandler(params) {
 					}));
 					return;
 				}
-				if (shouldStreamPreviewToolProgress && !previewToolProgressSuppressed && normalized) {
-					if (previewToolProgressLines.at(-1) !== normalized) previewToolProgressLines = [...previewToolProgressLines, normalized].slice(-resolveChannelProgressDraftMaxLines(progressConfigEntry));
-				}
+				if (shouldStreamPreviewToolProgress && !previewToolProgressSuppressed && normalized) previewToolProgressLines = mergeChannelProgressDraftLine(previewToolProgressLines, progressLine, { maxLines: resolveChannelProgressDraftMaxLines(progressConfigEntry) });
 				const alreadyStarted = progressDraftGate.hasStarted;
 				await progressDraftGate.noteWork();
 				if (alreadyStarted && progressDraftGate.hasStarted) renderProgressDraft();
@@ -2952,8 +2971,9 @@ function createMatrixRoomMessageHandler(params) {
 						}, payload.detailMode ? { detailMode: payload.detailMode } : void 0), { toolName });
 					},
 					onItemEvent: async (payload) => {
-						await pushPreviewToolProgress(formatChannelProgressDraftLineForEntry(progressConfigEntry, {
+						await pushPreviewToolProgress(buildChannelProgressDraftLineForEntry(progressConfigEntry, {
 							event: "item",
+							itemId: payload.itemId,
 							itemKind: payload.kind,
 							title: payload.title,
 							name: payload.name,
@@ -3257,6 +3277,7 @@ function createMatrixRoomMessageHandler(params) {
 						storePath,
 						ctxPayload,
 						recordInboundSession: core.channel.session.recordInboundSession,
+						botLoopProtection,
 						record: {
 							updateLastRoute: isDirectMessage ? {
 								sessionKey: _route.mainSessionKey,
@@ -3336,7 +3357,10 @@ function createMatrixRoomMessageHandler(params) {
 					})
 				}
 			});
-			if (!turnResult.dispatched) return;
+			if (!turnResult.dispatched) {
+				if (turnResult.admission.kind === "drop" && turnResult.admission.reason === "bot-loop-protection") await commitInboundEventIfClaimed();
+				return;
+			}
 			const { dispatchResult } = turnResult;
 			const { queuedFinal, counts } = dispatchResult;
 			if (finalReplyDeliveryFailed) {
@@ -3668,7 +3692,7 @@ function createMatrixRoomInfoResolver(client) {
 let matrixStartupMaintenanceDepsPromise;
 async function loadMatrixStartupMaintenanceDeps() {
 	matrixStartupMaintenanceDepsPromise ??= Promise.all([
-		import("./config-update-wZX-HLMn.js").then((n) => n.t),
+		import("./config-update-BBkpLB9o.js").then((n) => n.t),
 		import("./device-health-UVYpbA_W.js"),
 		import("./profile-BlHu0wDX.js").then((n) => n.n),
 		import("./legacy-crypto-restore-Biw-w2ng.js"),

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

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

package/dist/probe.runtime-sh9piX22.js

@@ -0,0 +1,3 @@
+import { t as createMatrixClient } from "./create-client-ChlpNpAA.js";
+import "./client-DBDvsx0D.js";
+export { createMatrixClient };

package/dist/{profile-update-DleMeUHj.js → profile-update-DK5rfmA-.js}

@@ -1,7 +1,7 @@
 import { t as getMatrixRuntime } from "./runtime-Dog86njy.js";
-import { n as resolveMatrixConfigPath, r as updateMatrixAccountConfig } from "./config-update-wZX-HLMn.js";
+import { n as resolveMatrixConfigPath, r as updateMatrixAccountConfig } from "./config-update-BBkpLB9o.js";
 import { r as syncMatrixOwnProfile } from "./profile-BlHu0wDX.js";
-import { n as withResolvedActionClient } from "./client-DzjShjVN.js";
+import { n as withResolvedActionClient } from "./client-DrmLRQnw.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-CiARZfjk.js → reaction-events-Cfvkp-A-.js}

@@ -1,4 +1,4 @@
-import { a as resolveMatrixAccountConfig } from "./account-config-D2W-V1eQ.js";
+import { a as resolveMatrixAccountConfig } from "./account-config-LVxGiX7e.js";
 import { a as extractMatrixReactionAnnotation } from "./reaction-common-ejrL19w-.js";
 import { a as unregisterMatrixApprovalReactionTarget, i as resolveMatrixApprovalReactionTargetWithPersistence } from "./approval-reactions-o2_tuH8D.js";
 import { i as resolveMatrixThreadRouting, r as resolveMatrixThreadRootId, t as resolveMatrixInboundRoute } from "./route-D6rg-iXN.js";
@@ -7,7 +7,7 @@ import { getSessionBindingService } from "openclaw/plugin-sdk/session-binding-ru
 let approvalReactionAuthPromise;
 let execApprovalResolverPromise;
 function loadApprovalReactionAuth() {
-	approvalReactionAuthPromise ??= import("./approval-reaction-auth-DbcA1gGd.js");
+	approvalReactionAuthPromise ??= import("./approval-reaction-auth-BY5VFY-q.js");
 	return approvalReactionAuthPromise;
 }
 function loadExecApprovalResolver() {

package/dist/{resolve-targets-BbzYe9Qi.js → resolve-targets-ZSM4KKln.js}

@@ -1,6 +1,6 @@
 import { t as __exportAll } from "./rolldown-runtime-DUslC3ob.js";
 import { n as normalizeMatrixMessagingTarget, t as isMatrixQualifiedUserId } from "./target-ids-80nQ2gql.js";
-import { n as listMatrixDirectoryGroupsLive, r as listMatrixDirectoryPeersLive } from "./directory-live-Bn66SRSD.js";
+import { n as listMatrixDirectoryGroupsLive, r as listMatrixDirectoryPeersLive } from "./directory-live-Btsr0yok.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-BWFMWEsg.js → resolver.runtime-m_D8JSm3.js}

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

package/dist/runtime-api.js

@@ -3,7 +3,7 @@ import { a as resolveMatrixDefaultOrOnlyAccountId, i as resolveMatrixChannelConf
 import { n as listMatrixEnvAccountIds, r as resolveMatrixEnvAccountToken, t as getMatrixScopedEnvVarNames } from "./env-vars-C7uQCTKn.js";
 import { r as setMatrixRuntime } from "./runtime-Dog86njy.js";
 import { a as resolveMatrixCredentialsPath, c as resolveMatrixLegacyFlatStoreRoot, i as resolveMatrixCredentialsFilename, l as sanitizeMatrixPathSegment, n as resolveMatrixAccountStorageRoot, o as resolveMatrixHomeserverKey, r as resolveMatrixCredentialsDir, s as resolveMatrixLegacyFlatStoragePaths, t as hashMatrixAccessToken } from "./storage-paths-BJLdnCjV.js";
-import { n as ensureMatrixSdkInstalled, r as isMatrixSdkAvailable } from "./deps-CU5W9Ixu.js";
+import { n as ensureMatrixSdkInstalled, r as isMatrixSdkAvailable } from "./deps-DR0MIYrW.js";
 import { assertHttpUrlTargetsPrivateNetwork, closeDispatcher, createPinnedDispatcher, resolvePinnedHostnameWithPolicy, ssrfPolicyFromAllowPrivateNetwork, ssrfPolicyFromDangerouslyAllowPrivateNetwork } from "openclaw/plugin-sdk/ssrf-runtime";
 import { writeJsonFileAtomically } from "openclaw/plugin-sdk/json-store";
 import { formatZonedTimestamp } from "openclaw/plugin-sdk/time-runtime";

package/dist/runtime-heavy-api.js

@@ -1,3 +1,3 @@
-import { a as detectLegacyMatrixCrypto, i as autoPrepareLegacyMatrixCrypto, n as hasPendingMatrixMigration, o as autoMigrateLegacyMatrixState, r as resolveMatrixMigrationStatus, s as detectLegacyMatrixState, t as hasActionableMatrixMigration } from "./matrix-migration.runtime-DfjNMeoX.js";
+import { a as detectLegacyMatrixCrypto, i as autoPrepareLegacyMatrixCrypto, n as hasPendingMatrixMigration, o as autoMigrateLegacyMatrixState, r as resolveMatrixMigrationStatus, s as detectLegacyMatrixState, t as hasActionableMatrixMigration } from "./matrix-migration.runtime-CDasos7a.js";
 import { t as maybeCreateMatrixMigrationSnapshot } from "./migration-snapshot-backup-DaCHTp8C.js";
 export { autoMigrateLegacyMatrixState, autoPrepareLegacyMatrixCrypto, detectLegacyMatrixCrypto, detectLegacyMatrixState, hasActionableMatrixMigration, hasPendingMatrixMigration, maybeCreateMatrixMigrationSnapshot, resolveMatrixMigrationStatus };

package/dist/{sdk-DXWmb94u.js → sdk-BLBGvKEe.js}

@@ -290,7 +290,7 @@ function createMatrixExplicitBootstrapOptions(params) {
 let loadedMatrixCryptoRuntime = null;
 let matrixCryptoRuntimePromise = null;
 async function loadMatrixCryptoRuntime() {
-	matrixCryptoRuntimePromise ??= import("./crypto-runtime-DS6R8y_n.js").then((runtime) => {
+	matrixCryptoRuntimePromise ??= import("./crypto-runtime-BevaUxax.js").then((runtime) => {
 		loadedMatrixCryptoRuntime = runtime;
 		return runtime;
 	});

package/dist/{send-Df-pDuG6.js → send-D651usmb.js}

@@ -1,6 +1,6 @@
 import { t as __exportAll } from "./rolldown-runtime-DUslC3ob.js";
 import { r as normalizeMatrixResolvableTarget, t as isMatrixQualifiedUserId } from "./target-ids-80nQ2gql.js";
-import { a as resolveMatrixAccountConfig } from "./account-config-D2W-V1eQ.js";
+import { a as resolveMatrixAccountConfig } from "./account-config-LVxGiX7e.js";
 import { t as getMatrixRuntime } from "./runtime-Dog86njy.js";
 import { r as buildMatrixReactionContent } from "./reaction-common-ejrL19w-.js";
 import { c as MSC4357_LIVE_KEY, l as MsgType, n as inspectMatrixDirectRooms, o as EventType, r as persistMatrixDirectRoomMapping, u as RelationType } from "./direct-management--Y8ypgLv.js";
@@ -230,7 +230,7 @@ function buildPollResponseContent(pollEventId, answerIds) {
 //#region extensions/matrix/src/matrix/send/client.ts
 let matrixSendClientRuntimePromise = null;
 async function loadMatrixSendClientRuntime() {
-	matrixSendClientRuntimePromise ??= import("./client-bootstrap-Am_ZEH3x.js").then((n) => n.t);
+	matrixSendClientRuntimePromise ??= import("./client-bootstrap-Ba68NvZB.js").then((n) => n.t);
 	return await matrixSendClientRuntimePromise;
 }
 function resolveMediaMaxBytes(accountId, cfg) {

package/dist/{setup-bootstrap-DXWxzR7A.js → setup-bootstrap-DT2Gj9hX.js}

@@ -1,7 +1,7 @@
-import { a as resolveMatrixAccountConfig, n as hasExplicitMatrixAccountConfig } from "./account-config-D2W-V1eQ.js";
-import "./accounts-Bm90Rzvp.js";
+import { a as resolveMatrixAccountConfig, n as hasExplicitMatrixAccountConfig } from "./account-config-LVxGiX7e.js";
+import "./accounts--0L_EuMK.js";
 import { t as formatMatrixErrorMessage } from "./errors-CTcpEDq-.js";
-import { n as bootstrapMatrixVerification } from "./verification-BbGdzYQl.js";
+import { n as bootstrapMatrixVerification } from "./verification-BJT2k9TI.js";
 //#region extensions/matrix/src/setup-bootstrap.ts
 async function maybeBootstrapNewEncryptedMatrixAccount(params) {
 	const accountConfig = resolveMatrixAccountConfig({

package/dist/{setup-core-B5X7HxAP.js → setup-core-C-uKN68n.js}

@@ -1,8 +1,8 @@
-import { a as resolveMatrixAccountConfig } from "./account-config-D2W-V1eQ.js";
-import { r as resolveDefaultMatrixAccountId } from "./accounts-Bm90Rzvp.js";
-import { i as validateMatrixSetupInput, n as applyMatrixSetupAccountConfig, t as resolveMatrixSetupDmAllowFrom } from "./setup-dm-policy-Ca3jA4YW.js";
+import { a as resolveMatrixAccountConfig } from "./account-config-LVxGiX7e.js";
+import { r as resolveDefaultMatrixAccountId } from "./accounts--0L_EuMK.js";
+import { i as validateMatrixSetupInput, n as applyMatrixSetupAccountConfig, t as resolveMatrixSetupDmAllowFrom } from "./setup-dm-policy-0_kFUfW4.js";
 import { t as resolveMatrixConfigFieldPath } from "./config-paths-nsVaysCu.js";
-import { r as updateMatrixAccountConfig } from "./config-update-wZX-HLMn.js";
+import { r as updateMatrixAccountConfig } from "./config-update-BBkpLB9o.js";
 import { DEFAULT_ACCOUNT_ID, normalizeAccountId, prepareScopedSetupConfig } from "openclaw/plugin-sdk/setup";
 //#region extensions/matrix/src/setup-core.ts
 const channel = "matrix";
@@ -103,7 +103,7 @@ const matrixSetupAdapter = {
 		input
 	}),
 	afterAccountConfigWritten: async ({ previousCfg, cfg, accountId, runtime }) => {
-		const { runMatrixSetupBootstrapAfterConfigWrite } = await import("./setup-bootstrap-DXWxzR7A.js");
+		const { runMatrixSetupBootstrapAfterConfigWrite } = await import("./setup-bootstrap-DT2Gj9hX.js");
 		await runMatrixSetupBootstrapAfterConfigWrite({
 			previousCfg,
 			cfg,

package/dist/{setup-dm-policy-Ca3jA4YW.js → setup-dm-policy-0_kFUfW4.js}

@@ -1,5 +1,5 @@
 import { r as resolveMatrixEnvAuthReadiness } from "./env-auth-BJqGI8M6.js";
-import { r as updateMatrixAccountConfig } from "./config-update-wZX-HLMn.js";
+import { r as updateMatrixAccountConfig } from "./config-update-BBkpLB9o.js";
 import { t as isSupportedMatrixAvatarSource } from "./profile-BlHu0wDX.js";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/routing";

package/dist/setup-plugin-api.js

@@ -1,6 +1,6 @@
-import { i as resolveMatrixAccount } from "./accounts-Bm90Rzvp.js";
-import { r as matrixConfigAdapter, t as MatrixChannelConfigSchema } from "./config-schema-B975BYl0.js";
-import { n as matrixSetupAdapter, t as createMatrixSetupWizardProxy } from "./setup-core-B5X7HxAP.js";
+import { i as resolveMatrixAccount } from "./accounts--0L_EuMK.js";
+import { r as matrixConfigAdapter, t as MatrixChannelConfigSchema } from "./config-schema-DOKrNEs_.js";
+import { n as matrixSetupAdapter, t as createMatrixSetupWizardProxy } from "./setup-core-C-uKN68n.js";
 import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 const matrixSetupPlugin = {
 	id: "matrix",
@@ -14,7 +14,7 @@ const matrixSetupPlugin = {
 		order: 70,
 		quickstartAllowFrom: true
 	},
-	setupWizard: createMatrixSetupWizardProxy(async () => ({ matrixSetupWizard: (await import("./setup-surface-DuRQrrpU.js").then((n) => n.t)).matrixSetupWizard })),
+	setupWizard: createMatrixSetupWizardProxy(async () => ({ matrixSetupWizard: (await import("./setup-surface-KzA9__US.js").then((n) => n.t)).matrixSetupWizard })),
 	setup: matrixSetupAdapter,
 	capabilities: {
 		chatTypes: [

package/dist/{setup-surface-DuRQrrpU.js → setup-surface-KzA9__US.js}

@@ -1,13 +1,13 @@
 import { t as __exportAll } from "./rolldown-runtime-DUslC3ob.js";
 import { n as requiresExplicitMatrixDefaultAccount } from "./account-selection-BWwIruri.js";
-import { a as resolveMatrixAccountConfig } from "./account-config-D2W-V1eQ.js";
+import { a as resolveMatrixAccountConfig } from "./account-config-LVxGiX7e.js";
 import { r as resolveMatrixEnvAuthReadiness } from "./env-auth-BJqGI8M6.js";
-import { i as resolveMatrixAccount, r as resolveDefaultMatrixAccountId, t as listMatrixAccountIds } from "./accounts-Bm90Rzvp.js";
-import { r as moveSingleMatrixAccountConfigToNamedAccount, t as resolveMatrixSetupDmAllowFrom } from "./setup-dm-policy-Ca3jA4YW.js";
+import { i as resolveMatrixAccount, r as resolveDefaultMatrixAccountId, t as listMatrixAccountIds } from "./accounts--0L_EuMK.js";
+import { r as moveSingleMatrixAccountConfigToNamedAccount, t as resolveMatrixSetupDmAllowFrom } from "./setup-dm-policy-0_kFUfW4.js";
 import { t as resolveMatrixConfigFieldPath } from "./config-paths-nsVaysCu.js";
-import { r as updateMatrixAccountConfig } from "./config-update-wZX-HLMn.js";
+import { r as updateMatrixAccountConfig } from "./config-update-BBkpLB9o.js";
 import { n as validateMatrixHomeserverUrl, r as isPrivateOrLoopbackHost, t as resolveValidatedMatrixHomeserverUrl } from "./url-validation-DiK9j7jz.js";
-import { n as ensureMatrixSdkInstalled, r as isMatrixSdkAvailable } from "./deps-CU5W9Ixu.js";
+import { n as ensureMatrixSdkInstalled, r as isMatrixSdkAvailable } from "./deps-DR0MIYrW.js";
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/account-id";
 import { normalizeLowercaseStringOrEmpty, normalizeOptionalString, normalizeStringifiedOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { formatDocsLink, hasConfiguredSecretInput, mergeAllowFromEntries, normalizeAccountId as normalizeAccountId$1, promptAccountId, promptChannelAccessConfig, splitSetupEntries } from "openclaw/plugin-sdk/setup";
@@ -107,7 +107,7 @@ async function promptMatrixAllowFrom(params) {
 			pending.push(part);
 		}
 		if (pending.length > 0) {
-			const { resolveMatrixTargets } = await import("./resolve-targets-BbzYe9Qi.js").then((n) => n.n);
+			const { resolveMatrixTargets } = await import("./resolve-targets-ZSM4KKln.js").then((n) => n.n);
 			const results = await resolveMatrixTargets({
 				cfg,
 				accountId,
@@ -235,7 +235,7 @@ async function configureMatrixAccessPrompts(params) {
 					resolvedIds.push(cleaned);
 					continue;
 				}
-				const { listMatrixDirectoryGroupsLive } = await import("./directory-live-Bn66SRSD.js").then((n) => n.t);
+				const { listMatrixDirectoryGroupsLive } = await import("./directory-live-Btsr0yok.js").then((n) => n.t);
 				const matches = await listMatrixDirectoryGroupsLive({
 					cfg: next,
 					accountId: params.accountId,
@@ -510,7 +510,7 @@ const matrixOnboardingAdapter = {
 		});
 	},
 	afterConfigWritten: async ({ previousCfg, cfg, accountId, runtime }) => {
-		const { runMatrixSetupBootstrapAfterConfigWrite } = await import("./setup-bootstrap-DXWxzR7A.js");
+		const { runMatrixSetupBootstrapAfterConfigWrite } = await import("./setup-bootstrap-DT2Gj9hX.js");
 		await runMatrixSetupBootstrapAfterConfigWrite({
 			previousCfg,
 			cfg,

package/dist/{shared-CkbpEI5j.js → shared-DarXfhzC.js}

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-DUslC3ob.js";
 import { n as LogService } from "./logger-CnZRVrux.js";
 import { t as awaitMatrixStartupWithAbort } from "./startup-abort-56edvmbM.js";
-import { n as resolveMatrixAuth, r as resolveMatrixAuthContext } from "./config-BR4uLzNs.js";
+import { n as resolveMatrixAuth, r as resolveMatrixAuthContext } from "./config-xD5Y8nFT.js";
 import { normalizeOptionalAccountId } from "openclaw/plugin-sdk/account-id";
 //#region extensions/matrix/src/matrix/client/shared.ts
 var shared_exports = /* @__PURE__ */ __exportAll({
@@ -15,7 +15,7 @@ var shared_exports = /* @__PURE__ */ __exportAll({
 });
 let matrixCreateClientDepsPromise;
 async function loadMatrixCreateClientDeps() {
-	matrixCreateClientDepsPromise ??= import("./create-client-DpoW106T.js").then((n) => n.n).then((runtime) => ({ createMatrixClient: runtime.createMatrixClient }));
+	matrixCreateClientDepsPromise ??= import("./create-client-ChlpNpAA.js").then((n) => n.n).then((runtime) => ({ createMatrixClient: runtime.createMatrixClient }));
 	return await matrixCreateClientDepsPromise;
 }
 const sharedClientStates = /* @__PURE__ */ new Map();

package/dist/test-api.js

@@ -1,4 +1,4 @@
 import { r as setMatrixRuntime } from "./runtime-Dog86njy.js";
-import { t as matrixPlugin } from "./channel-B-R2dceO.js";
-import { t as MatrixClient } from "./sdk-DXWmb94u.js";
+import { t as matrixPlugin } from "./channel-eRrwLDE9.js";
+import { t as MatrixClient } from "./sdk-BLBGvKEe.js";
 export { MatrixClient, matrixPlugin, setMatrixRuntime };

package/dist/{thread-bindings--P1UYe7t.js → thread-bindings-DHUszTA0.js}

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

package/dist/{tool-actions.runtime-AFGhzK--.js → tool-actions.runtime-Bn8bvkQN.js}

@@ -1,12 +1,12 @@
-import { a as resolveMatrixAccountConfig } from "./account-config-D2W-V1eQ.js";
-import "./accounts-Bm90Rzvp.js";
-import { _ as parsePollStart, d as buildPollResponseContent, g as isPollStartType, i as reactMatrixMessage, u as resolveMatrixRoomId } from "./send-Df-pDuG6.js";
+import { a as resolveMatrixAccountConfig } from "./account-config-LVxGiX7e.js";
+import "./accounts--0L_EuMK.js";
+import { _ as parsePollStart, d as buildPollResponseContent, g as isPollStartType, i as reactMatrixMessage, u as resolveMatrixRoomId } from "./send-D651usmb.js";
 import { i as buildMatrixReactionRelationsPath, o as selectOwnMatrixReactionEventIds, s as summarizeMatrixReactionEvents } from "./reaction-common-ejrL19w-.js";
-import { n as withResolvedActionClient, r as withResolvedRoomAction } from "./client-DzjShjVN.js";
-import { a as fetchEventSummary, c as resolveMatrixActionLimit, i as sendMatrixMessage, n as editMatrixMessage, o as readPinnedEvents, r as readMatrixMessages, s as EventType, t as deleteMatrixMessage } from "./messages-DQ8xXWiP.js";
+import { n as withResolvedActionClient, r as withResolvedRoomAction } from "./client-DrmLRQnw.js";
+import { a as fetchEventSummary, c as resolveMatrixActionLimit, i as sendMatrixMessage, n as editMatrixMessage, o as readPinnedEvents, r as readMatrixMessages, s as EventType, t as deleteMatrixMessage } from "./messages-BJi_jdEA.js";
 import { a as jsonResult, c as readStringArrayParam, l as readStringParam, o as readNumberParam, r as createActionGate, s as readReactionParams } from "./runtime-api-DTKcXOhp.js";
-import { t as applyMatrixProfileUpdate } from "./profile-update-DleMeUHj.js";
-import { _ as scanMatrixVerificationQr, a as confirmMatrixVerificationSas, b as verifyMatrixRecoveryKey, c as getMatrixRoomKeyBackupStatus, d as listMatrixVerifications, f as mismatchMatrixVerificationSas, h as restoreMatrixRoomKeyBackup, i as confirmMatrixVerificationReciprocateQr, l as getMatrixVerificationSas, n as bootstrapMatrixVerification, o as generateMatrixVerificationQr, p as requestMatrixVerification, r as cancelMatrixVerification, s as getMatrixEncryptionStatus, t as acceptMatrixVerification, u as getMatrixVerificationStatus, v as startMatrixVerification } from "./verification-BbGdzYQl.js";
+import { t as applyMatrixProfileUpdate } from "./profile-update-DK5rfmA-.js";
+import { _ as scanMatrixVerificationQr, a as confirmMatrixVerificationSas, b as verifyMatrixRecoveryKey, c as getMatrixRoomKeyBackupStatus, d as listMatrixVerifications, f as mismatchMatrixVerificationSas, h as restoreMatrixRoomKeyBackup, i as confirmMatrixVerificationReciprocateQr, l as getMatrixVerificationSas, n as bootstrapMatrixVerification, o as generateMatrixVerificationQr, p as requestMatrixVerification, r as cancelMatrixVerification, s as getMatrixEncryptionStatus, t as acceptMatrixVerification, u as getMatrixVerificationStatus, v as startMatrixVerification } from "./verification-BJT2k9TI.js";
 import { normalizeOptionalLowercaseString } from "openclaw/plugin-sdk/string-coerce-runtime";
 //#region extensions/matrix/src/matrix/actions/polls.ts
 function normalizeOptionIndexes(indexes) {

package/dist/{verification-BbGdzYQl.js → verification-BJT2k9TI.js}

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-DUslC3ob.js";
-import { i as withStartedActionClient, n as withResolvedActionClient } from "./client-DzjShjVN.js";
+import { i as withStartedActionClient, n as withResolvedActionClient } from "./client-DrmLRQnw.js";
 import { n as formatMatrixEncryptionUnavailableError } from "./encryption-guidance-BPi3A_m3.js";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { requireRuntimeConfig } from "openclaw/plugin-sdk/plugin-config-runtime";

package/openclaw.plugin.json

@@ -276,6 +276,30 @@
               }
             ]
           },
+          "botLoopProtection": {
+            "type": "object",
+            "properties": {
+              "enabled": {
+                "type": "boolean"
+              },
+              "maxEventsPerWindow": {
+                "type": "integer",
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991
+              },
+              "windowSeconds": {
+                "type": "integer",
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991
+              },
+              "cooldownSeconds": {
+                "type": "integer",
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991
+              }
+            },
+            "additionalProperties": false
+          },
           "groupPolicy": {
             "type": "string",
             "enum": [
@@ -616,6 +640,30 @@
                     }
                   ]
                 },
+                "botLoopProtection": {
+                  "type": "object",
+                  "properties": {
+                    "enabled": {
+                      "type": "boolean"
+                    },
+                    "maxEventsPerWindow": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "windowSeconds": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "cooldownSeconds": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
+                    }
+                  },
+                  "additionalProperties": false
+                },
                 "tools": {
                   "type": "object",
                   "properties": {
@@ -695,6 +743,30 @@
                     }
                   ]
                 },
+                "botLoopProtection": {
+                  "type": "object",
+                  "properties": {
+                    "enabled": {
+                      "type": "boolean"
+                    },
+                    "maxEventsPerWindow": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "windowSeconds": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "cooldownSeconds": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
+                    }
+                  },
+                  "additionalProperties": false
+                },
                 "tools": {
                   "type": "object",
                   "properties": {
@@ -781,6 +853,30 @@
       "label": "Matrix",
       "description": "open protocol; install the plugin to enable.",
       "uiHints": {
+        "allowBots": {
+          "label": "Matrix Allow Bot Messages",
+          "help": "Allow messages from other configured Matrix bot accounts to trigger replies (default: false). Set \"mentions\" to require a visible room mention."
+        },
+        "botLoopProtection": {
+          "label": "Matrix Bot Loop Protection",
+          "help": "Sliding-window guard for accepted Matrix configured-bot loops. Default is enabled whenever allowBots lets configured bot messages reach dispatch."
+        },
+        "botLoopProtection.enabled": {
+          "label": "Matrix Bot Loop Protection Enabled",
+          "help": "Enable the bot-pair loop guard. Defaults to true when allowBots is true or \"mentions\", and false when configured bot messages are ignored."
+        },
+        "botLoopProtection.maxEventsPerWindow": {
+          "label": "Matrix Bot Loop Events per Window",
+          "help": "Maximum accepted bot-pair messages within the sliding window before suppression starts. Default: 20."
+        },
+        "botLoopProtection.windowSeconds": {
+          "label": "Matrix Bot Loop Window Seconds",
+          "help": "Sliding window length for counting bot-pair messages. Default: 60."
+        },
+        "botLoopProtection.cooldownSeconds": {
+          "label": "Matrix Bot Loop Cooldown Seconds",
+          "help": "How long to suppress the bot pair after it exceeds the budget. Default: 60."
+        },
         "dangerouslyAllowNameMatching": {
           "label": "Matrix Display Name Matching",
           "help": "Compatibility opt-in for resolving Matrix display names and joined room names in allowlists. Prefer full @user:server IDs and room IDs or aliases because names are mutable."