@openclaw/matrix 2026.5.31-beta.1 → 2026.5.31-beta.3

package/README.md

@@ -0,0 +1,11 @@
+# OpenClaw Matrix
+
+Official OpenClaw channel plugin for Matrix rooms and direct messages.
+
+Install from OpenClaw:
+
+```bash
+openclaw plugin add @openclaw/matrix
+```
+
+Configure the Matrix homeserver and bot credentials in OpenClaw. The plugin lets agents join configured rooms, receive messages, and reply through Matrix.

package/dist/api.js

@@ -2,7 +2,7 @@ import { a as resolveMatrixDefaultOrOnlyAccountId, i as resolveMatrixChannelConf
 import { n as listMatrixEnvAccountIds, r as resolveMatrixEnvAccountToken, t as getMatrixScopedEnvVarNames } from "./env-vars-KzaYveuy.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-BWo_ZEMC.js";
 import { n as matrixSetupAdapter, t as createMatrixSetupWizardProxy } from "./setup-core-DRg3cgB8.js";
-import { t as matrixPlugin } from "./channel-BwpVY2Ne.js";
+import { t as matrixPlugin } from "./channel--XqVgFZK.js";
 import { d as setMatrixThreadBindingIdleTimeoutBySessionKey, n as getMatrixThreadBindingManager, p as setMatrixThreadBindingMaxAgeBySessionKey, s as resetMatrixThreadBindingsForTests } from "./thread-bindings-shared-CKnY4LSd.js";
 import { n as matrixOnboardingAdapter } from "./setup-surface-soZQLgfu.js";
 import { t as createMatrixThreadBindingManager } from "./thread-bindings-DehFUArg.js";

package/dist/{approval-handler.runtime-Dzh_2MS1.js → approval-handler.runtime-SX-BFhX_.js}

@@ -1,5 +1,5 @@
 import { g as resolveMatrixAccount } from "./setup-core-DRg3cgB8.js";
-import { _ as shouldHandleMatrixApprovalRequest, g as isMatrixAnyApprovalClientEnabled } from "./channel-BwpVY2Ne.js";
+import { _ as shouldHandleMatrixApprovalRequest, g as isMatrixAnyApprovalClientEnabled } from "./channel--XqVgFZK.js";
 import { a as resolveMatrixTargetIdentity } from "./target-ids-B-5aQxwn.js";
 import { a as sendMessageMatrix, i as reactMatrixMessage, p as repairMatrixDirectRooms, s as sendSingleTextMessageMatrix } from "./send-DHj1E9ji.js";
 import { a as unregisterMatrixApprovalReactionTarget, n as listMatrixApprovalReactionBindings, r as registerMatrixApprovalReactionTarget, t as buildMatrixApprovalReactionHint } from "./approval-reactions-BRGQgOu2.js";

package/dist/{channel-BwpVY2Ne.js → channel--XqVgFZK.js}

@@ -593,7 +593,7 @@ const matrixNativeApprovalCapability = createApproverRestrictedNativeApprovalCap
 			accountId,
 			request
 		}),
-		load: async () => (await import("./approval-handler.runtime-Dzh_2MS1.js")).matrixApprovalNativeRuntime
+		load: async () => (await import("./approval-handler.runtime-SX-BFhX_.js")).matrixApprovalNativeRuntime
 	})
 });
 const splitMatrixApprovalCapability = splitChannelApprovalCapability(matrixNativeApprovalCapability);
@@ -1284,8 +1284,8 @@ const matrixPlugin = createChatChannelPlugin({
 			collectStatusIssues: (accounts) => collectStatusIssuesFromLastError("matrix", accounts),
 			buildChannelSummary: ({ snapshot }) => buildProbeChannelStatusSummary(snapshot, { baseUrl: snapshot.baseUrl ?? null }),
 			probeAccount: async ({ account, timeoutMs, cfg }) => await createMatrixProbeAccount({
-				resolveMatrixAuth: async ({ cfg, accountId }) => (await loadMatrixChannelRuntime()).resolveMatrixAuth({
-					cfg,
+				resolveMatrixAuth: async ({ cfg: cfgLocal, accountId }) => (await loadMatrixChannelRuntime()).resolveMatrixAuth({
+					cfg: cfgLocal,
 					accountId
 				}),
 				probeMatrix: async (params) => await (await loadMatrixChannelRuntime()).probeMatrix(params)
@@ -1321,7 +1321,7 @@ const matrixPlugin = createChatChannelPlugin({
 			await previousLock;
 			let monitorMatrixProvider;
 			try {
-				monitorMatrixProvider = (await import("./monitor-gDaABWfA.js")).monitorMatrixProvider;
+				monitorMatrixProvider = (await import("./monitor-BMksz3hx.js")).monitorMatrixProvider;
 			} finally {
 				releaseLock();
 			}

package/dist/channel-plugin-api.js

@@ -1,2 +1,2 @@
-import { t as matrixPlugin } from "./channel-BwpVY2Ne.js";
+import { t as matrixPlugin } from "./channel--XqVgFZK.js";
 export { matrixPlugin };

package/dist/{monitor-gDaABWfA.js → monitor-BMksz3hx.js}

@@ -1,7 +1,7 @@
 import { c as resolveMatrixAccountConfig, s as resolveMatrixAccountAllowlistConfig } from "./config-paths-ZBCMwSos.js";
 import { t as getMatrixRuntime } from "./runtime-6S3DNFNv.js";
 import { m as resolveConfiguredMatrixBotUserIds } from "./setup-core-DRg3cgB8.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-BwpVY2Ne.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--XqVgFZK.js";
 import { a as normalizeMatrixUserId, i as normalizeMatrixAllowList, o as resolveMatrixAllowListMatch } from "./config-schema-DfjBrYch.js";
 import { t as isMatrixQualifiedUserId } from "./target-ids-B-5aQxwn.js";
 import { r as isMatrixNotFoundError, t as formatMatrixErrorMessage } from "./errors-C47hvAF8.js";
@@ -2157,30 +2157,30 @@ function createMatrixRoomMessageHandler(params) {
 	let cachedStoreAllowFrom = null;
 	let liveDmAllowlistCache = null;
 	let liveGroupAllowlistCache = null;
-	const resolveCachedLiveAllowlist = async (params) => {
-		const accountConfig = resolveMatrixAccountConfig({
-			cfg: params.cfg,
+	const resolveCachedLiveAllowlist = async (paramsValue) => {
+		const accountConfigLocal = resolveMatrixAccountConfig({
+			cfg: paramsValue.cfg,
 			accountId
 		});
 		const signature = JSON.stringify({
-			entries: (params.entries ?? []).map((entry) => String(entry).trim()),
-			failClosedOnUnresolved: params.failClosedOnUnresolved === true,
-			dangerouslyAllowNameMatching: isDangerousNameMatchingEnabled(accountConfig)
+			entries: (paramsValue.entries ?? []).map((entry) => String(entry).trim()),
+			failClosedOnUnresolved: paramsValue.failClosedOnUnresolved === true,
+			dangerouslyAllowNameMatching: isDangerousNameMatchingEnabled(accountConfigLocal)
 		});
-		if (params.cache?.signature === signature) return params.cache.entries;
+		if (paramsValue.cache?.signature === signature) return paramsValue.cache.entries;
 		const entries = await resolveLiveUserAllowlist({
-			cfg: params.cfg,
+			cfg: paramsValue.cfg,
 			accountId,
-			entries: params.entries,
-			failClosedOnUnresolved: params.failClosedOnUnresolved,
-			startupResolvedEntries: params.startupResolvedEntries,
+			entries: paramsValue.entries,
+			failClosedOnUnresolved: paramsValue.failClosedOnUnresolved,
+			startupResolvedEntries: paramsValue.startupResolvedEntries,
 			runtime
 		});
 		const next = {
 			signature,
 			entries
 		};
-		params.updateCache(next);
+		paramsValue.updateCache(next);
 		return entries;
 	};
 	const pairingReplySentAtMsBySender = /* @__PURE__ */ new Map();
@@ -2314,11 +2314,11 @@ function createMatrixRoomMessageHandler(params) {
 					selfUserId
 				};
 			};
-			const continueIngress = async (params) => {
-				let content = params.content;
-				const isDirectMessage = params.isDirectMessage;
+			const continueIngress = async (paramsLocal) => {
+				let content = paramsLocal.content;
+				const isDirectMessage = paramsLocal.isDirectMessage;
 				const isRoom = !isDirectMessage;
-				const { locationPayload, selfUserId } = params;
+				const { locationPayload, selfUserId } = paramsLocal;
 				if (isRoom && groupPolicy === "disabled") {
 					await commitInboundEventIfClaimed();
 					return;
@@ -3003,8 +3003,8 @@ function createMatrixRoomMessageHandler(params) {
 				}
 				if (shouldStreamPreviewToolProgress && !previewToolProgressSuppressed && normalized) previewToolProgressLines = mergeChannelProgressDraftLine(previewToolProgressLines, progressLine, { maxLines: resolveChannelProgressDraftMaxLines(progressConfigEntry) });
 				const alreadyStarted = progressDraftGate.hasStarted;
-				await progressDraftGate.noteWork();
-				if (alreadyStarted && progressDraftGate.hasStarted) renderProgressDraft();
+				const progressActive = await progressDraftGate.noteWork();
+				if ((alreadyStarted || progressActive) && progressDraftGate.hasStarted) renderProgressDraft();
 			};
 			const suppressPreviewToolProgressForAnswerText = (text) => {
 				if (!text?.trim()) return;
@@ -3916,9 +3916,9 @@ function createMatrixMonitorStatusController(params) {
 		status.healthState = "healthy";
 		emit();
 	};
-	const noteDisconnected = (params) => {
-		const at = params.at ?? Date.now();
-		const error = formatSyncError(params.error);
+	const noteDisconnected = (paramsLocal) => {
+		const at = paramsLocal.at ?? Date.now();
+		const error = formatSyncError(paramsLocal.error);
 		status.connected = false;
 		status.lastEventAt = at;
 		status.lastDisconnect = {
@@ -3926,7 +3926,7 @@ function createMatrixMonitorStatusController(params) {
 			...error ? { error } : {}
 		};
 		status.lastError = error;
-		status.healthState = params.state.toLowerCase();
+		status.healthState = paramsLocal.state.toLowerCase();
 		emit();
 	};
 	emit();
@@ -3985,9 +3985,9 @@ function createMatrixMonitorSyncLifecycle(params) {
 	};
 	const onSyncState = (state, _prevState, error) => {
 		if (isMatrixTerminalSyncState(state) && !params.isStopping?.()) {
-			const fatalError = formatSyncLifecycleError(state, error);
-			params.statusController.noteUnexpectedError(fatalError);
-			settleFatal(fatalError);
+			const fatalErrorLocal = formatSyncLifecycleError(state, error);
+			params.statusController.noteUnexpectedError(fatalErrorLocal);
+			settleFatal(fatalErrorLocal);
 			return;
 		}
 		if (fatalError) return;

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@openclaw/matrix",
-  "version": "2026.5.31-beta.1",
+  "version": "2026.5.31-beta.3",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@openclaw/matrix",
-      "version": "2026.5.31-beta.1",
+      "version": "2026.5.31-beta.3",
       "dependencies": {
         "@matrix-org/matrix-sdk-crypto-nodejs": "0.6.0",
         "@matrix-org/matrix-sdk-crypto-wasm": "18.3.0",
@@ -18,7 +18,7 @@
         "zod": "4.4.3"
       },
       "peerDependencies": {
-        "openclaw": ">=2026.5.31-beta.1"
+        "openclaw": ">=2026.5.31-beta.3"
       },
       "peerDependenciesMeta": {
         "openclaw": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/matrix",
-  "version": "2026.5.31-beta.1",
+  "version": "2026.5.31-beta.3",
   "description": "OpenClaw Matrix channel plugin for rooms and direct messages.",
   "repository": {
     "type": "git",
@@ -18,7 +18,7 @@
     "zod": "4.4.3"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.5.31-beta.1"
+    "openclaw": ">=2026.5.31-beta.3"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -84,10 +84,10 @@
       "allowInvalidConfigRecovery": true
     },
     "compat": {
-      "pluginApi": ">=2026.5.31-beta.1"
+      "pluginApi": ">=2026.5.31-beta.3"
     },
     "build": {
-      "openclawVersion": "2026.5.31-beta.1"
+      "openclawVersion": "2026.5.31-beta.3"
     },
     "release": {
       "publishToClawHub": true,
@@ -101,7 +101,8 @@
   "files": [
     "dist/**",
     "openclaw.plugin.json",
-    "npm-shrinkwrap.json"
+    "npm-shrinkwrap.json",
+    "README.md"
   ],
   "bundledDependencies": [
     "@matrix-org/matrix-sdk-crypto-nodejs",