@openclaw/matrix 2026.7.2-beta.3 → 2026.7.2-beta.5

package/README.md

@@ -5,7 +5,7 @@ Official OpenClaw channel plugin for Matrix rooms and direct messages.
 Install from OpenClaw:
 
 ```bash
-openclaw plugin add @openclaw/matrix
+openclaw plugins install @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

@@ -1,11 +1,11 @@
 import { a as resolveMatrixDefaultOrOnlyAccountId, i as resolveMatrixChannelConfig, n as requiresExplicitMatrixDefaultAccount, r as resolveConfiguredMatrixAccountIds, t as findMatrixAccountEntry } from "./account-selection-kqquRzCf.js";
 import { n as listMatrixEnvAccountIds, r as resolveMatrixEnvAccountToken, t as getMatrixScopedEnvVarNames } from "./env-vars-B0NxQnPk.js";
 import { a as resolveMatrixCredentialsPath, i as resolveMatrixCredentialsFilename, n as resolveMatrixAccountStorageRoot, o as resolveMatrixHomeserverKey, r as resolveMatrixCredentialsDir, s as sanitizeMatrixPathSegment, t as hashMatrixAccessToken } from "./storage-paths-gUmSydsW.js";
-import { n as matrixSetupAdapter, t as createMatrixSetupWizardProxy } from "./setup-core-XCdAx1nY.js";
-import { t as matrixPlugin } from "./channel-j331Xd7b.js";
+import { n as matrixSetupAdapter, t as createMatrixSetupWizardProxy } from "./setup-core-a542Ernq.js";
+import { t as matrixPlugin } from "./channel-Cmi248PA.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-CzUiTe_k.js";
-import { t as createMatrixThreadBindingManager } from "./thread-bindings-Cw194yEn.js";
+import { n as matrixOnboardingAdapter } from "./setup-surface-BJrCI6KT.js";
+import { t as createMatrixThreadBindingManager } from "./thread-bindings-D3RfVgAF.js";
 //#region extensions/matrix/api.ts
 const matrixSessionBindingAdapterChannels = ["matrix"];
 //#endregion

package/dist/{approval-handler.runtime-BEa98wwG.js → approval-handler.runtime-D1ibJgSk.js}

@@ -1,9 +1,9 @@
-import { g as resolveMatrixAccount } from "./setup-core-XCdAx1nY.js";
-import { _ as shouldHandleMatrixApprovalRequest, g as isMatrixAnyApprovalClientEnabled } from "./channel-j331Xd7b.js";
+import { _ as resolveMatrixAccount } from "./setup-core-a542Ernq.js";
+import { _ as shouldHandleMatrixApprovalRequest, g as isMatrixAnyApprovalClientEnabled } from "./channel-Cmi248PA.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-BJbrdmNm.js";
+import { a as sendSingleTextMessageMatrix, d as repairMatrixDirectRooms, n as reactMatrixMessage, r as sendMessageMatrix } from "./send-C9Ssx-iV.js";
 import { a as unregisterMatrixApprovalReactionTarget, n as listMatrixApprovalReactionBindings, r as registerMatrixApprovalReactionTarget, t as buildMatrixApprovalReactionHint } from "./approval-reactions-D-BxBK_L.js";
-import { n as editMatrixMessage, t as deleteMatrixMessage } from "./messages-3UBHfZrN.js";
+import { n as editMatrixMessage, t as deleteMatrixMessage } from "./messages-Bf_s--M9.js";
 import { listMessageReceiptPlatformIds, resolveMessageReceiptPrimaryId } from "openclaw/plugin-sdk/channel-outbound";
 import { normalizeUniqueStringEntries } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { buildChannelApprovalNativeTargetKey } from "openclaw/plugin-sdk/approval-native-runtime";

package/dist/{approval-ids-Dfn7oQAm.js → approval-ids-2OQj32-K.js}

@@ -1,4 +1,4 @@
-import { a as normalizeMatrixUserId } from "./config-schema-B5GRV8wL.js";
+import { a as normalizeMatrixUserId } from "./config-schema-BShrVROw.js";
 //#region extensions/matrix/src/approval-ids.ts
 function normalizeMatrixApproverId(value) {
 	return normalizeMatrixUserId(String(value)) || void 0;

package/dist/{approval-reaction-auth-kXkCJBGi.js → approval-reaction-auth-CCAWWkbu.js}

@@ -1,5 +1,5 @@
-import { g as resolveMatrixAccount } from "./setup-core-XCdAx1nY.js";
-import { t as normalizeMatrixApproverId } from "./approval-ids-Dfn7oQAm.js";
+import { _ as resolveMatrixAccount } from "./setup-core-a542Ernq.js";
+import { t as normalizeMatrixApproverId } from "./approval-ids-2OQj32-K.js";
 import { resolveApprovalApprovers } from "openclaw/plugin-sdk/approval-auth-runtime";
 //#region extensions/matrix/src/approval-reaction-auth.ts
 function normalizeMatrixExecApproverId(value) {

package/dist/{channel-j331Xd7b.js → channel-Cmi248PA.js}

@@ -1,11 +1,11 @@
 import { n as requiresExplicitMatrixDefaultAccount } from "./account-selection-kqquRzCf.js";
 import { a as resolveMatrixAccountConfig } from "./account-config-BZWN9tGS.js";
-import { d as resolveSingleAccountPromotionTarget, f as singleAccountKeysToMove, g as resolveMatrixAccount, h as resolveDefaultMatrixAccountId, n as matrixSetupAdapter, p as listMatrixAccountIds, t as createMatrixSetupWizardProxy, u as namedAccountPromotionKeys } from "./setup-core-XCdAx1nY.js";
-import { a as normalizeMatrixUserId, n as DEFAULT_ACCOUNT_ID$2, r as matrixConfigAdapter, t as MatrixChannelConfigSchema } from "./config-schema-B5GRV8wL.js";
-import { t as normalizeMatrixApproverId } from "./approval-ids-Dfn7oQAm.js";
+import { _ as resolveMatrixAccount, d as namedAccountPromotionKeys, f as resolveSingleAccountPromotionTarget, g as resolveDefaultMatrixAccountId, m as listMatrixAccountIds, n as matrixSetupAdapter, p as singleAccountKeysToMove, r as matrixSetupContract, t as createMatrixSetupWizardProxy } from "./setup-core-a542Ernq.js";
+import { a as normalizeMatrixUserId, n as DEFAULT_ACCOUNT_ID$2, r as matrixConfigAdapter, t as MatrixChannelConfigSchema } from "./config-schema-BShrVROw.js";
+import { t as normalizeMatrixApproverId } from "./approval-ids-2OQj32-K.js";
 import { a as resolveMatrixTargetIdentity, i as resolveMatrixDirectUserId, n as normalizeMatrixMessagingTarget, r as normalizeMatrixResolvableTarget, t as isMatrixQualifiedUserId } from "./target-ids-B-5aQxwn.js";
 import { t as formatMatrixErrorMessage } from "./errors-C47hvAF8.js";
-import { n as normalizeCompatibilityConfig, t as legacyConfigRules } from "./doctor-contract-BA2Y6Crx.js";
+import { n as normalizeCompatibilityConfig, t as legacyConfigRules } from "./doctor-contract-BMSJkkAE.js";
 import { d as setMatrixThreadBindingIdleTimeoutBySessionKey, p as setMatrixThreadBindingMaxAgeBySessionKey } from "./thread-bindings-shared-CKnY4LSd.js";
 import { n as collectRuntimeConfigAssignments, r as secretTargetRegistryEntries } from "./secret-contract-M3hRmGO-.js";
 import { n as resolveMatrixInboundConversation, t as defaultTopLevelPlacement } from "./thread-binding-api-DRbBZlhS.js";
@@ -34,9 +34,9 @@ import { normalizeAccountId as normalizeAccountId$1, parseThreadSessionSuffix }
 import { createPairingPrefixStripper } from "openclaw/plugin-sdk/channel-pairing";
 import { PAIRING_APPROVED_MESSAGE } from "openclaw/plugin-sdk/channel-status";
 import { formatLocationText, logInboundDrop, toLocationContext } from "openclaw/plugin-sdk/channel-inbound";
-import { getAgentScopedMediaLocalRoots } from "openclaw/plugin-sdk/agent-media-payload";
+import { getAgentScopedMediaLocalRoots } from "openclaw/plugin-sdk/media-local-roots";
 import { buildChannelKeyCandidates } from "openclaw/plugin-sdk/channel-targets";
-import { getSessionEntry, resolveStorePath } from "openclaw/plugin-sdk/session-store-runtime";
+import { deliveryContextFromSession, getSessionEntry, resolveStorePath, sessionDeliveryOrigin } from "openclaw/plugin-sdk/session-store-runtime";
 //#region extensions/matrix/src/actions.ts
 const MATRIX_PLUGIN_HANDLED_ACTIONS = /* @__PURE__ */ new Set([
 	"send",
@@ -127,7 +127,7 @@ const matrixMessageActions = {
 		return extractToolSend(args, "sendMessage");
 	},
 	handleAction: async (ctx) => {
-		const { handleMatrixAction } = await import("./tool-actions.runtime-C0jgWYhX.js");
+		const { handleMatrixAction } = await import("./tool-actions.runtime-Dh5ow2EK.js");
 		const { action, params, cfg, accountId, mediaLocalRoots } = ctx;
 		const dispatch = async (actionParams) => await handleMatrixAction({
 			...actionParams,
@@ -601,7 +601,7 @@ const matrixNativeApprovalCapability = createApproverRestrictedNativeApprovalCap
 			approvalKind,
 			request
 		}),
-		load: async () => (await import("./approval-handler.runtime-BEa98wwG.js")).matrixApprovalNativeRuntime
+		load: async () => (await import("./approval-handler.runtime-D1ibJgSk.js")).matrixApprovalNativeRuntime
 	})
 });
 const splitMatrixApprovalCapability = splitChannelApprovalCapability(matrixNativeApprovalCapability);
@@ -780,7 +780,7 @@ function resolveMatrixGroupToolPolicy(params) {
 }
 //#endregion
 //#region extensions/matrix/src/resolver.ts
-const loadMatrixChannelRuntime$1 = createLazyRuntimeNamedExport(() => import("./resolver.runtime-CC0VVsAt.js"), "matrixResolverRuntime");
+const loadMatrixChannelRuntime$1 = createLazyRuntimeNamedExport(() => import("./resolver.runtime-BvaFlVLg.js"), "matrixResolverRuntime");
 const matrixResolverAdapter = { resolveTargets: async ({ cfg, accountId, inputs, kind, runtime }) => (await loadMatrixChannelRuntime$1()).resolveMatrixTargets({
 	cfg,
 	accountId,
@@ -790,38 +790,34 @@ const matrixResolverAdapter = { resolveTargets: async ({ cfg, accountId, inputs,
 }) };
 //#endregion
 //#region extensions/matrix/src/matrix/session-store-metadata.ts
-function trimMaybeString(value) {
-	if (typeof value !== "string") return;
-	const trimmed = value.trim();
-	return trimmed.length > 0 ? trimmed : void 0;
-}
 function resolveMatrixRoomTargetId(value) {
-	const trimmed = trimMaybeString(value);
+	const trimmed = normalizeOptionalString(value);
 	if (!trimmed) return;
 	const target = resolveMatrixTargetIdentity(trimmed);
 	return target?.kind === "room" && target.id.startsWith("!") ? target.id : void 0;
 }
 function resolveMatrixSessionAccountId(value) {
-	const trimmed = trimMaybeString(value);
+	const trimmed = normalizeOptionalString(value);
 	return trimmed ? normalizeAccountId(trimmed) : void 0;
 }
 function resolveMatrixStoredRoomId(params) {
-	return resolveMatrixRoomTargetId(params.deliveryTo) ?? resolveMatrixRoomTargetId(params.lastTo) ?? resolveMatrixRoomTargetId(params.originNativeChannelId) ?? resolveMatrixRoomTargetId(params.originTo);
+	return resolveMatrixRoomTargetId(params.deliveryTo) ?? resolveMatrixRoomTargetId(params.originNativeChannelId) ?? resolveMatrixRoomTargetId(params.originTo);
 }
 function resolveMatrixStoredSessionMeta(entry) {
 	if (!entry) return null;
-	const channel = trimMaybeString(entry.deliveryContext?.channel) ?? trimMaybeString(entry.lastChannel) ?? trimMaybeString(entry.origin?.provider);
-	const accountId = resolveMatrixSessionAccountId(entry.deliveryContext?.accountId ?? entry.lastAccountId ?? entry.origin?.accountId) ?? void 0;
+	const deliveryContext = deliveryContextFromSession(entry);
+	const origin = sessionDeliveryOrigin(entry);
+	const channel = normalizeOptionalString(deliveryContext?.channel) ?? normalizeOptionalString(origin?.provider);
+	const accountId = resolveMatrixSessionAccountId(deliveryContext?.accountId ?? origin?.accountId) ?? void 0;
 	const roomId = resolveMatrixStoredRoomId({
-		deliveryTo: entry.deliveryContext?.to,
-		lastTo: entry.lastTo,
-		originNativeChannelId: entry.origin?.nativeChannelId,
-		originTo: entry.origin?.to
+		deliveryTo: deliveryContext?.to,
+		originNativeChannelId: origin?.nativeChannelId,
+		originTo: origin?.to
 	});
-	const chatType = trimMaybeString(entry.origin?.chatType) ?? trimMaybeString(entry.chatType) ?? void 0;
-	const directUserId = chatType === "direct" ? trimMaybeString(entry.origin?.nativeDirectUserId) ?? resolveMatrixDirectUserId({
-		from: trimMaybeString(entry.origin?.from),
-		to: (roomId ? `room:${roomId}` : void 0) ?? trimMaybeString(entry.deliveryContext?.to) ?? trimMaybeString(entry.lastTo) ?? trimMaybeString(entry.origin?.to),
+	const chatType = normalizeOptionalString(origin?.chatType) ?? normalizeOptionalString(entry.chatType);
+	const directUserId = chatType === "direct" ? normalizeOptionalString(origin?.nativeDirectUserId) ?? resolveMatrixDirectUserId({
+		from: normalizeOptionalString(origin?.from),
+		to: (roomId ? `room:${roomId}` : void 0) ?? normalizeOptionalString(deliveryContext?.to) ?? normalizeOptionalString(origin?.to),
 		chatType
 	}) : void 0;
 	if (!channel && !accountId && !roomId && !directUserId) return null;
@@ -906,9 +902,9 @@ function resolveMatrixOutboundSessionRoute(params) {
 //#endregion
 //#region extensions/matrix/src/channel.ts
 let matrixStartupLock = Promise.resolve();
-const loadMatrixSetupWizard = createLazyRuntimeNamedExport(() => import("./setup-surface-CzUiTe_k.js").then((n) => n.t), "matrixSetupWizard");
-const loadMatrixChannelRuntime = createLazyRuntimeNamedExport(() => import("./channel.runtime-BIwlVfQw.js"), "matrixChannelRuntime");
-const loadMatrixDoctorModule = createLazyRuntimeModule(() => import("./doctor-DwUVm5Lw.js"));
+const loadMatrixSetupWizard = createLazyRuntimeNamedExport(() => import("./setup-surface-BJrCI6KT.js").then((n) => n.t), "matrixSetupWizard");
+const loadMatrixChannelRuntime = createLazyRuntimeNamedExport(() => import("./channel.runtime-BaPXFRgT.js"), "matrixChannelRuntime");
+const loadMatrixDoctorModule = createLazyRuntimeModule(() => import("./doctor-CM8ijNpW.js"));
 const meta = {
 	id: "matrix",
 	label: "Matrix",
@@ -1174,7 +1170,7 @@ const matrixPlugin = createChatChannelPlugin({
 			}).map(projectMatrixConversationBinding)
 		},
 		messaging: {
-			defaultMarkdownTableMode: "bullets",
+			defaultMarkdownTableMode: "block",
 			targetPrefixes: ["matrix"],
 			targetIdComparison: "case-sensitive",
 			normalizeTarget: normalizeMatrixMessagingTarget,
@@ -1225,6 +1221,12 @@ const matrixPlugin = createChatChannelPlugin({
 			namedAccountPromotionKeys,
 			resolveSingleAccountPromotionTarget
 		},
+		setupContract: {
+			...matrixSetupContract,
+			singleAccountKeysToMove,
+			namedAccountPromotionKeys,
+			resolveSingleAccountPromotionTarget
+		},
 		bindings: {
 			compileConfiguredBinding: ({ conversationId }) => normalizeMatrixAcpConversationId(conversationId),
 			matchInboundConversation: ({ compiledBinding, conversationId, parentConversationId }) => matchMatrixAcpConversation({
@@ -1281,7 +1283,7 @@ const matrixPlugin = createChatChannelPlugin({
 			await previousLock;
 			let monitorMatrixProvider;
 			try {
-				monitorMatrixProvider = (await import("./monitor-BtUIds8T.js")).monitorMatrixProvider;
+				monitorMatrixProvider = (await import("./monitor-s--XqoxF.js")).monitorMatrixProvider;
 			} finally {
 				releaseLock();
 			}

package/dist/channel-plugin-api.js

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

package/dist/{channel.runtime-BIwlVfQw.js → channel.runtime-BaPXFRgT.js}

@@ -1,45 +1,41 @@
-import { a as sendMessageMatrix, c as sendTypingMatrix, o as sendPollMatrix } from "./send-BJbrdmNm.js";
+import { i as sendPollMatrix, o as sendTypingMatrix, r as sendMessageMatrix } from "./send-C9Ssx-iV.js";
 import { t as isBunRuntime } from "./runtime-BefyhPWv.js";
-import { f as resolveMatrixAuth } from "./shared-DquM1oz6.js";
-import "./client-CA0PULls.js";
-import { n as listMatrixDirectoryGroupsLive, r as listMatrixDirectoryPeersLive } from "./directory-live-DiC-0XBC.js";
+import { f as resolveMatrixAuth } from "./shared-CUH5otj8.js";
+import "./client-BFRg0kd4.js";
+import { n as listMatrixDirectoryGroupsLive, r as listMatrixDirectoryPeersLive } from "./directory-live-YRgYDx2w.js";
 import { p as resolveOutboundSendDep, r as chunkTextForOutbound } from "./runtime-api-D1xI_cvh.js";
-import { t as resolveMatrixTargets } from "./resolve-targets-DVoj-YxB.js";
+import { t as resolveMatrixTargets } from "./resolve-targets-nNMcrV3W.js";
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 import { createReplyToFanout } from "openclaw/plugin-sdk/channel-outbound";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
+import { runChannelProbe } from "openclaw/plugin-sdk/text-utility-runtime";
 import { renderMessagePresentationFallbackText } from "openclaw/plugin-sdk/interactive-runtime";
 import { resolvePayloadMediaUrls, sendPayloadMediaSequence } from "openclaw/plugin-sdk/reply-payload";
 //#region extensions/matrix/src/matrix/probe.ts
-const loadMatrixProbeRuntimeDeps = createLazyRuntimeModule(() => import("./probe.runtime-sBV-Govx.js").then((runtimeModule) => ({ createMatrixClient: runtimeModule.createMatrixClient })));
+const loadMatrixProbeRuntimeDeps = createLazyRuntimeModule(() => import("./probe.runtime-BJOvCHnZ.js").then((runtimeModule) => ({ createMatrixClient: runtimeModule.createMatrixClient })));
 async function probeMatrix(params) {
-	const started = Date.now();
-	const result = {
-		ok: false,
-		status: null,
-		error: null,
-		elapsedMs: 0
-	};
-	if (isBunRuntime()) return {
-		...result,
-		error: "Matrix probe requires Node (bun runtime not supported)",
-		elapsedMs: Date.now() - started
-	};
-	if (!params.homeserver?.trim()) return {
-		...result,
-		error: "missing homeserver",
-		elapsedMs: Date.now() - started
-	};
-	if (!params.accessToken?.trim()) return {
-		...result,
-		error: "missing access token",
-		elapsedMs: Date.now() - started
-	};
-	try {
+	return await runChannelProbe(void 0, async () => {
+		const result = {
+			ok: false,
+			status: null,
+			error: null
+		};
+		if (isBunRuntime()) return {
+			...result,
+			error: "Matrix probe requires Node (bun runtime not supported)"
+		};
+		if (!params.homeserver?.trim()) return {
+			...result,
+			error: "missing homeserver"
+		};
+		if (!params.accessToken?.trim()) return {
+			...result,
+			error: "missing access token"
+		};
 		const { createMatrixClient } = await loadMatrixProbeRuntimeDeps();
 		const inputUserId = normalizeOptionalString(params.userId);
-		const userId = await (await createMatrixClient({
+		const client = await createMatrixClient({
 			homeserver: params.homeserver,
 			userId: inputUserId,
 			accessToken: params.accessToken,
@@ -50,19 +46,17 @@ async function probeMatrix(params) {
 			allowPrivateNetwork: params.allowPrivateNetwork,
 			ssrfPolicy: params.ssrfPolicy,
 			dispatcherPolicy: params.dispatcherPolicy
-		})).getUserId();
-		result.ok = true;
-		result.userId = userId ?? null;
-		result.elapsedMs = Date.now() - started;
-		return result;
-	} catch (err) {
+		});
 		return {
 			...result,
-			status: typeof err === "object" && err && "statusCode" in err ? Number(err.statusCode) : result.status,
-			error: formatErrorMessage(err),
-			elapsedMs: Date.now() - started
+			ok: true,
+			userId: await client.getUserId() ?? null
 		};
-	}
+	}, (error) => ({
+		ok: false,
+		status: typeof error === "object" && error && "statusCode" in error ? Number(error.statusCode) : null,
+		error: formatErrorMessage(error)
+	}));
 }
 //#endregion
 //#region extensions/matrix/src/outbound.ts