@openclaw/matrix 2026.9.1-beta.1 → 2026.9.2

package/dist/outbound-Co_tJyE6.js

@@ -0,0 +1,220 @@
+import { i as sendPollMatrix, r as sendMessageMatrix } from "./send-B5XChnvB.js";
+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";
+import { attachChannelToResult } from "openclaw/plugin-sdk/channel-send-result";
+import { renderMessagePresentationFallbackText, renderPresentationForDelivery } from "openclaw/plugin-sdk/interactive-runtime";
+import { resolveSendableOutboundReplyParts, sendPayloadMediaSequence } from "openclaw/plugin-sdk/reply-payload";
+//#region extensions/matrix/src/outbound.ts
+const MATRIX_OPENCLAW_PRESENTATION_KEY = "com.openclaw.presentation";
+const MATRIX_OPENCLAW_PRESENTATION_TYPE = "message.presentation";
+const MATRIX_EMPTY_PRESENTATION_FALLBACK_TEXT = "---";
+const MATRIX_PRESENTATION_CAPABILITIES = {
+	supported: true,
+	buttons: true,
+	selects: true,
+	context: true,
+	divider: true,
+	limits: { text: {
+		markdownDialect: "markdown",
+		supportsEdit: true
+	} }
+};
+function toMatrixOutboundResult(result) {
+	const { roomId, ...delivery } = result;
+	return {
+		...delivery,
+		target: {
+			kind: "room",
+			id: roomId
+		}
+	};
+}
+function resolveMatrixChannelData(payload) {
+	const raw = asOptionalRecord(payload.channelData)?.matrix;
+	return asOptionalRecord(raw) ?? {};
+}
+function buildMatrixPresentationContent(presentation) {
+	return {
+		...presentation,
+		version: 1,
+		type: MATRIX_OPENCLAW_PRESENTATION_TYPE
+	};
+}
+function resolveMatrixPresentationContent(payload) {
+	const extraContent = asOptionalRecord(resolveMatrixChannelData(payload).extraContent);
+	const presentation = asOptionalRecord(extraContent?.[MATRIX_OPENCLAW_PRESENTATION_KEY]);
+	if (!presentation || presentation.version !== 1 || presentation.type !== MATRIX_OPENCLAW_PRESENTATION_TYPE) return;
+	return presentation;
+}
+function renderMatrixPresentationPayload(params) {
+	const matrixData = resolveMatrixChannelData(params.payload);
+	const fallbackText = renderMessagePresentationFallbackText({
+		text: params.payload.text,
+		presentation: params.presentation,
+		emptyFallback: MATRIX_EMPTY_PRESENTATION_FALLBACK_TEXT
+	});
+	return {
+		...params.payload,
+		text: fallbackText,
+		channelData: {
+			...params.payload.channelData,
+			matrix: {
+				...matrixData,
+				extraContent: { [MATRIX_OPENCLAW_PRESENTATION_KEY]: buildMatrixPresentationContent(params.presentation) }
+			}
+		}
+	};
+}
+function prepareMatrixReplyPayload(payload) {
+	return renderPresentationForDelivery({
+		presentationCapabilities: MATRIX_PRESENTATION_CAPABILITIES,
+		renderPresentation: (prepared) => renderMatrixPresentationPayload({
+			payload: prepared,
+			presentation: prepared.presentation
+		})
+	}, payload);
+}
+function resolveMatrixPayloadText(payload) {
+	const text = payload.text ?? "";
+	if (text.trim() || !resolveMatrixPresentationContent(payload)) return text;
+	return MATRIX_EMPTY_PRESENTATION_FALLBACK_TEXT;
+}
+/** Matrix event fields a reply carries beyond its body, currently its presentation. */
+function resolveMatrixExtraContent(payload) {
+	const presentation = resolveMatrixPresentationContent(payload);
+	return presentation ? { [MATRIX_OPENCLAW_PRESENTATION_KEY]: presentation } : void 0;
+}
+function resolveMatrixDeliveryProgress(onDeliveryResult) {
+	return onDeliveryResult ? async (result) => {
+		await onDeliveryResult(attachChannelToResult("matrix", toMatrixOutboundResult(result)));
+	} : void 0;
+}
+const matrixOutbound = {
+	deliveryMode: "direct",
+	chunker: chunkTextForOutbound,
+	chunkerMode: "markdown",
+	textChunkLimit: 4e3,
+	presentationCapabilities: MATRIX_PRESENTATION_CAPABILITIES,
+	renderPresentation: ({ payload, presentation }) => renderMatrixPresentationPayload({
+		payload,
+		presentation
+	}),
+	sendPayload: async ({ cfg, to, payload, mediaLocalRoots, mediaReadFile, mediaAccess, deps, replyToId, replyToIdSource, replyToMode, threadId, accountId, audioAsVoice, deliveryQueueId, onPlatformSendDispatch, onDeliveryResult }) => {
+		const send = resolveOutboundSendDep(deps, "matrix") ?? sendMessageMatrix;
+		const resolvedThreadId = threadId !== void 0 && threadId !== null ? String(threadId) : void 0;
+		const resolveReplyToId = createReplyToFanout({
+			...replyToId != null ? { replyToId } : {},
+			...replyToIdSource !== void 0 ? { replyToIdSource } : {},
+			...replyToMode !== void 0 ? { replyToMode } : {}
+		});
+		const urls = resolveSendableOutboundReplyParts(payload).mediaUrls;
+		const payloadText = resolveMatrixPayloadText(payload);
+		if (urls.length > 0) {
+			const sentResults = [];
+			const lastResult = await sendPayloadMediaSequence({
+				text: payloadText,
+				mediaUrls: urls,
+				send: async ({ text, mediaUrl, index, isFirst }) => await send(to, text, {
+					cfg,
+					mediaUrl,
+					mediaAccess,
+					mediaLocalRoots,
+					mediaReadFile,
+					replyToId: resolveReplyToId(),
+					threadId: resolvedThreadId,
+					accountId: accountId ?? void 0,
+					audioAsVoice: payload.audioAsVoice ?? audioAsVoice,
+					deliveryQueueId,
+					deliveryPartIndex: index,
+					deliveryPartCount: urls.length,
+					onPlatformSendDispatch,
+					extraContent: isFirst ? resolveMatrixExtraContent(payload) : void 0,
+					onDeliveryResult: resolveMatrixDeliveryProgress(onDeliveryResult)
+				}),
+				onResult: (result) => {
+					sentResults.push(result);
+				}
+			});
+			if (lastResult !== void 0) {
+				const receipt = createMessageReceiptFromOutboundResults({ results: sentResults });
+				receipt.parts = receipt.parts.map((part, index) => ({
+					...part,
+					index
+				}));
+				return attachChannelToResult("matrix", toMatrixOutboundResult({
+					...lastResult,
+					primaryMessageId: receipt.primaryPlatformMessageId,
+					receipt,
+					content: sentResults.map((result) => result.content).join("\n")
+				}));
+			}
+		}
+		const result = await send(to, payloadText, {
+			cfg,
+			mediaAccess,
+			mediaLocalRoots,
+			mediaReadFile,
+			replyToId: resolveReplyToId(),
+			threadId: resolvedThreadId,
+			accountId: accountId ?? void 0,
+			audioAsVoice: payload.audioAsVoice ?? audioAsVoice,
+			deliveryQueueId,
+			deliveryPartIndex: 0,
+			deliveryPartCount: 1,
+			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 }) => {
+		const result = await (resolveOutboundSendDep(deps, "matrix") ?? sendMessageMatrix)(to, text, {
+			cfg,
+			replyToId: replyToId ?? void 0,
+			threadId: threadId !== void 0 && threadId !== null ? String(threadId) : void 0,
+			accountId: accountId ?? void 0,
+			audioAsVoice,
+			deliveryQueueId,
+			deliveryPartIndex,
+			...deliveryQueueId !== void 0 ? { deliveryPartCount } : {},
+			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 }) => {
+		const result = await (resolveOutboundSendDep(deps, "matrix") ?? sendMessageMatrix)(to, text, {
+			cfg,
+			mediaUrl,
+			mediaLocalRoots,
+			mediaReadFile,
+			mediaAccess,
+			replyToId: replyToId ?? void 0,
+			threadId: threadId !== void 0 && threadId !== null ? String(threadId) : void 0,
+			accountId: accountId ?? void 0,
+			audioAsVoice,
+			deliveryQueueId,
+			deliveryPartIndex,
+			...deliveryQueueId !== void 0 ? { deliveryPartCount } : {},
+			onPlatformSendDispatch,
+			onDeliveryResult: resolveMatrixDeliveryProgress(onDeliveryResult)
+		});
+		return attachChannelToResult("matrix", toMatrixOutboundResult(result));
+	},
+	sendPoll: async ({ cfg, to, poll, threadId, accountId }) => {
+		const result = await sendPollMatrix(to, poll, {
+			cfg,
+			threadId: threadId !== void 0 && threadId !== null ? threadId : void 0,
+			accountId: accountId ?? void 0
+		});
+		return {
+			channel: "matrix",
+			messageId: result.eventId,
+			roomId: result.roomId,
+			pollId: result.eventId
+		};
+	}
+};
+//#endregion
+export { prepareMatrixReplyPayload as n, resolveMatrixExtraContent as r, matrixOutbound as t };

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

@@ -2,7 +2,7 @@ import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 //#region extensions/matrix/src/plugin-entry.runtime.ts
-const loadMatrixVerificationRuntime = createLazyRuntimeModule(() => import("./verification-BP-3-XYn.js").then((n) => n.y));
+const loadMatrixVerificationRuntime = createLazyRuntimeModule(() => import("./verification-XJtTc5DI.js").then((n) => n.y));
 function sendError(respond, err) {
 	respond(false, { error: formatErrorMessage(err) });
 }

package/dist/probe.runtime-B1YPxG9x.js

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

package/dist/{profile-update-C61NR24_.js → profile-update-CAl8nZNG.js}

@@ -1,7 +1,7 @@
 import { t as getMatrixRuntime } from "./runtime-6S3DNFNv.js";
-import { n as resolveMatrixConfigPath, r as updateMatrixAccountConfig } from "./config-update-Bor_Pjsv.js";
-import { r as syncMatrixOwnProfile } from "./profile-D-Wubo0A.js";
-import { n as withResolvedActionClient } from "./client-BUtHbzib.js";
+import { n as resolveMatrixConfigPath, r as updateMatrixAccountConfig } from "./config-update-BnX26jCO.js";
+import { r as syncMatrixOwnProfile } from "./profile-vmjsmhh4.js";
+import { n as withResolvedActionClient } from "./client-oNOlldJI.js";
 import { normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 //#region extensions/matrix/src/matrix/actions/profile.ts
 async function updateMatrixOwnProfile(opts = {}) {
@@ -10,9 +10,10 @@ async function updateMatrixOwnProfile(opts = {}) {
 	const avatarPath = opts.avatarPath?.trim();
 	const runtime = getMatrixRuntime();
 	return await withResolvedActionClient(opts, async (client) => {
+		const userId = await client.getUserId();
 		return await syncMatrixOwnProfile({
 			client,
-			userId: await client.getUserId(),
+			userId,
 			displayName: displayName || void 0,
 			avatarUrl: avatarUrl || void 0,
 			avatarPath: avatarPath || void 0,

package/dist/{profile-D-Wubo0A.js → profile-vmjsmhh4.js}

@@ -5,7 +5,7 @@ var profile_exports = /* @__PURE__ */ __exportAll({
 	isSupportedMatrixAvatarSource: () => isSupportedMatrixAvatarSource,
 	syncMatrixOwnProfile: () => syncMatrixOwnProfile
 });
-const MATRIX_PROFILE_AVATAR_MAX_BYTES = 10 * 1024 * 1024;
+const MATRIX_PROFILE_AVATAR_MAX_BYTES = 10485760;
 function isMatrixMxcUri(value) {
 	return normalizeLowercaseStringOrEmpty(normalizeOptionalString(value)).startsWith("mxc://");
 }

package/dist/{reaction-events-BZUgLIZI.js → reaction-events-C_7G7bvI.js}

@@ -1,15 +1,15 @@
-import { a as resolveMatrixAccountConfig } from "./account-config-BZWN9tGS.js";
-import { a as resolveMatrixThreadRootId, o as resolveMatrixThreadRouting, r as resolveMatrixInboundRoute } from "./channel-CBEvelTE.js";
+import { a as resolveMatrixAccountConfig } from "./account-config-CRsKoMqJ.js";
+import { a as resolveMatrixThreadRootId, o as resolveMatrixThreadRouting, r as resolveMatrixInboundRoute } from "./channel-Bs8VLb6q.js";
 import { a as extractMatrixReactionAnnotation } from "./reaction-common-DkrQdBSZ.js";
-import { i as resolveMatrixApprovalReactionTargetWithPersistence, o as unregisterMatrixApprovalReactionTargetsForApproval } from "./approval-reactions-tXh9KYrW.js";
+import { i as resolveMatrixApprovalReactionTargetWithPersistence, o as unregisterMatrixApprovalReactionTargetsForApproval } from "./approval-reactions-1fwEhoK9.js";
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 import { isApprovalNotFoundError } from "openclaw/plugin-sdk/error-runtime";
 import { normalizeAccountId } from "openclaw/plugin-sdk/routing";
 import { getSessionBindingService } from "openclaw/plugin-sdk/session-binding-runtime";
 //#region extensions/matrix/src/matrix/monitor/reaction-events.ts
-const loadApprovalReactionAuth = createLazyRuntimeModule(() => import("./approval-reaction-auth-60xHiDtQ.js"));
+const loadApprovalReactionAuth = createLazyRuntimeModule(() => import("./approval-reaction-auth-DhH8QOSe.js"));
 const loadExecApprovalResolver = createLazyRuntimeModule(() => import("openclaw/plugin-sdk/approval-gateway-runtime"));
-const loadMatrixSend = createLazyRuntimeModule(() => import("./send-BKu9Ghi4.js").then((n) => n.s));
+const loadMatrixSend = createLazyRuntimeModule(() => import("./send-B5XChnvB.js").then((n) => n.s));
 function buildMatrixApprovalTerminalText(result) {
 	const approval = result.approval;
 	const terminalLabel = approval.status === "allowed" ? approval.decision === "allow-always" ? "Allowed always" : "Allowed once" : approval.status === "denied" ? "Denied" : approval.status === "expired" ? "Expired" : "Cancelled";
@@ -152,10 +152,12 @@ async function handleInboundMatrixReaction(params) {
 		isDirectMessage: params.isDirectMessage,
 		dmSessionScope: accountConfig.dm?.sessionScope ?? "per-user",
 		threadId: thread.threadId,
-		eventTs: params.event.origin_server_ts,
 		resolveAgentRoute: params.core.channel.routing.resolveAgentRoute
 	});
-	if (runtimeBindingId) getSessionBindingService().touch(runtimeBindingId, params.event.origin_server_ts);
+	if (runtimeBindingId) getSessionBindingService().touch(runtimeBindingId, params.event.origin_server_ts, {
+		channel: "matrix",
+		accountId: params.accountId
+	});
 	const text = `Matrix reaction added: ${reaction.key} by ${params.senderLabel} on msg ${reaction.eventId}`;
 	params.core.system.enqueueSystemEvent(text, {
 		sessionKey: route.sessionKey,

package/dist/{resolve-targets-DXzZwsIY.js → resolve-targets-B64O69Nd.js}

@@ -1,6 +1,6 @@
 import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
 import { r as normalizeMatrixMessagingTarget, t as isMatrixQualifiedUserId } from "./target-ids-Nwx7cMVE.js";
-import { n as listMatrixDirectoryGroupsLive, r as listMatrixDirectoryPeersLive } from "./directory-live-D0KfJlby.js";
+import { n as listMatrixDirectoryGroupsLive, r as listMatrixDirectoryPeersLive } from "./directory-live-DLUgWBhA.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-p5qJ3Kst.js → resolver.runtime-TRmePJDV.js}

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

package/dist/{room-info-BXQA7y10.js → room-info-6viLR3NH.js}

@@ -1,3 +1,6 @@
+import { b as resolveMatrixRoomId } from "./send-B5XChnvB.js";
+import { s as EventType } from "./messages-Czn8lNEh.js";
+import { n as withResolvedActionClient, r as withResolvedRoomAction } from "./client-oNOlldJI.js";
 import { n as isMatrixNotFoundError } from "./errors-DKVS3_DO.js";
 //#region extensions/matrix/src/matrix/monitor/bounded-cache.ts
 function setBoundedMap(map, key, value, maxEntries) {
@@ -7,6 +10,57 @@ function setBoundedMap(map, key, value, maxEntries) {
 	if (!oldest.done) map.delete(oldest.value);
 }
 //#endregion
+//#region extensions/matrix/src/matrix/actions/room.ts
+async function getMatrixMemberInfo(userId, opts) {
+	return await withResolvedActionClient(opts, async (client) => {
+		const roomId = await resolveMatrixRoomId(client, opts.roomId);
+		if (!(await client.getJoinedRoomMembers(roomId)).includes(userId)) throw new Error(`User ${userId} is not a member of room ${roomId}`);
+		const profile = await client.getUserProfile(userId);
+		return {
+			userId,
+			profile: {
+				displayName: profile?.displayname ?? null,
+				avatarUrl: profile?.avatar_url ?? null
+			},
+			membership: null,
+			powerLevel: null,
+			displayName: profile?.displayname ?? null,
+			roomId
+		};
+	});
+}
+async function getMatrixRoomInfo(roomId, opts = {}) {
+	return await withResolvedRoomAction(roomId, opts, async (client, resolvedRoom) => {
+		let name = null;
+		let topic = null;
+		let canonicalAlias = null;
+		let memberCount = null;
+		try {
+			const nameState = await client.getRoomStateEvent(resolvedRoom, "m.room.name", "");
+			name = typeof nameState?.name === "string" ? nameState.name : null;
+		} catch {}
+		try {
+			const topicState = await client.getRoomStateEvent(resolvedRoom, EventType.RoomTopic, "");
+			topic = typeof topicState?.topic === "string" ? topicState.topic : null;
+		} catch {}
+		try {
+			const aliasState = await client.getRoomStateEvent(resolvedRoom, "m.room.canonical_alias", "");
+			canonicalAlias = typeof aliasState?.alias === "string" ? aliasState.alias : null;
+		} catch {}
+		try {
+			memberCount = (await client.getJoinedRoomMembers(resolvedRoom)).length;
+		} catch {}
+		return {
+			roomId: resolvedRoom,
+			name,
+			topic,
+			canonicalAlias,
+			altAliases: [],
+			memberCount
+		};
+	});
+}
+//#endregion
 //#region extensions/matrix/src/matrix/monitor/room-info.ts
 const MAX_ROOM_INFO = 1024;
 const MAX_MEMBER_DISPLAY_NAMES = 4096;
@@ -93,4 +147,4 @@ function createMatrixRoomInfoResolver(client) {
 	};
 }
 //#endregion
-export { setBoundedMap as n, createMatrixRoomInfoResolver as t };
+export { setBoundedMap as i, getMatrixMemberInfo as n, getMatrixRoomInfo as r, createMatrixRoomInfoResolver as t };

package/dist/runtime-api.js

@@ -1,9 +1,9 @@
-import { a as resolveMatrixDefaultOrOnlyAccountId, i as resolveMatrixChannelConfig, n as requiresExplicitMatrixDefaultAccount, o as resolveMatrixAccountStringValues, r as resolveConfiguredMatrixAccountIds, t as findMatrixAccountEntry } from "./account-selection-CWuhuFn1.js";
+import { a as resolveMatrixDefaultOrOnlyAccountId, i as resolveMatrixChannelConfig, l as resolveMatrixAccountStringValues, n as requiresExplicitMatrixDefaultAccount, r as resolveConfiguredMatrixAccountIds, t as findMatrixAccountEntry } from "./account-selection-DA-jfx22.js";
 import { n as listMatrixEnvAccountIds, r as resolveMatrixEnvAccountToken, t as getMatrixScopedEnvVarNames } from "./env-vars-dGqak9dN.js";
 import { r as setMatrixRuntime } from "./runtime-6S3DNFNv.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 { f as setMatrixThreadBindingMaxAgeBySessionKey, u as setMatrixThreadBindingIdleTimeoutBySessionKey } from "./thread-bindings-shared-oNPiyMWY.js";
-import { n as ensureMatrixSdkInstalled, r as isMatrixSdkAvailable } from "./deps-CcVJfvRM.js";
+import { n as ensureMatrixSdkInstalled, r as isMatrixSdkAvailable } from "./deps-mtxF2mHI.js";
 import { chunkTextForOutbound as chunkTextForOutbound$1 } from "openclaw/plugin-sdk/text-chunking";
 import { assertHttpUrlTargetsPrivateNetwork, closeDispatcher, createPinnedDispatcher, resolvePinnedHostnameWithPolicy, ssrfPolicyFromDangerouslyAllowPrivateNetwork } from "openclaw/plugin-sdk/ssrf-runtime";
 import { writeJsonFileAtomically } from "openclaw/plugin-sdk/json-store";