@openclaw/matrix 2026.7.2-beta.5 → 2026.8.1-beta.2

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

@@ -1,16 +1,14 @@
-import { n as requiresExplicitMatrixDefaultAccount } from "./account-selection-kqquRzCf.js";
+import { n as requiresExplicitMatrixDefaultAccount } from "./account-selection-CWuhuFn1.js";
 import { a as resolveMatrixAccountConfig } from "./account-config-BZWN9tGS.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 { i as resolveMatrixAccount, r as resolveDefaultMatrixAccountId, t as listMatrixAccountIds } from "./accounts-BCzyubQt.js";
+import { a as normalizeMatrixUserId, r as DEFAULT_ACCOUNT_ID$2, t as matrixPluginBase } from "./channel.setup-PpxRP9Du.js";
+import { t as normalizeMatrixApproverId } from "./approval-ids-7rf7etWE.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-BMSJkkAE.js";
+import { n as normalizeCompatibilityConfig, t as legacyConfigRules } from "./doctor-contract-DEt4O4Zt.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 collectRuntimeConfigAssignments, r as secretTargetRegistryEntries } from "./secret-contract-CufozuyJ.js";
 import { n as resolveMatrixInboundConversation, t as defaultTopLevelPlacement } from "./thread-binding-api-DRbBZlhS.js";
 import { createLazyRuntimeModule, createLazyRuntimeNamedExport } from "openclaw/plugin-sdk/lazy-runtime";
-import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 import { adaptScopedAccountAccessor, createScopedDmSecurityResolver } from "openclaw/plugin-sdk/channel-config-helpers";
 import { buildChannelOutboundSessionRoute, buildThreadAwareOutboundSessionRoute, createChatChannelPlugin } from "openclaw/plugin-sdk/channel-core";
 import { createChannelMessageAdapterFromOutbound, createReplyPrefixOptions, createRuntimeOutboundDelegates, createTypingCallbacks, logTypingFailure } from "openclaw/plugin-sdk/channel-outbound";
@@ -26,13 +24,14 @@ import { Type } from "typebox";
 import { normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 import { createApproverRestrictedNativeApprovalCapability, createChannelApprovalCapability, splitChannelApprovalCapability } from "openclaw/plugin-sdk/approval-delivery-runtime";
 import { createLazyChannelApprovalNativeRuntimeAdapter } from "openclaw/plugin-sdk/approval-handler-adapter-runtime";
-import { createChannelNativeOriginTargetResolver, resolveApprovalRequestChannelAccountId, resolveApprovalRequestSessionConversation } from "openclaw/plugin-sdk/approval-native-runtime";
+import { createChannelNativeOriginTargetResolver, doesApprovalRequestSelectChannelAccount, resolveApprovalRequestSessionConversation } from "openclaw/plugin-sdk/approval-native-runtime";
 import { createChannelApprovalAuth, resolveApprovalApprovers } from "openclaw/plugin-sdk/approval-auth-runtime";
 import { addAllowlistUserEntriesFromConfigEntry, buildAllowlistResolutionSummary, canonicalizeAllowlistWithResolvedIds, patchAllowlistUsersInConfigEntries, summarizeMapping } from "openclaw/plugin-sdk/allow-from";
 import { createChannelExecApprovalProfile, getExecApprovalReplyMetadata, isChannelExecApprovalClientEnabledFromConfig, isChannelExecApprovalTargetRecipient, matchesApprovalRequestFilters } from "openclaw/plugin-sdk/approval-client-runtime";
-import { normalizeAccountId as normalizeAccountId$1, parseThreadSessionSuffix } from "openclaw/plugin-sdk/routing";
 import { createPairingPrefixStripper } from "openclaw/plugin-sdk/channel-pairing";
 import { PAIRING_APPROVED_MESSAGE } from "openclaw/plugin-sdk/channel-status";
+import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
+import { parseThreadSessionSuffix } from "openclaw/plugin-sdk/routing";
 import { formatLocationText, logInboundDrop, toLocationContext } from "openclaw/plugin-sdk/channel-inbound";
 import { getAgentScopedMediaLocalRoots } from "openclaw/plugin-sdk/media-local-roots";
 import { buildChannelKeyCandidates } from "openclaw/plugin-sdk/channel-targets";
@@ -81,7 +80,7 @@ function createMatrixExposedActions(params) {
 	if (params.gate("profile") && params.senderIsOwner === true) actions.add("set-profile");
 	if (params.gate("memberInfo")) actions.add("member-info");
 	if (params.gate("channelInfo")) actions.add("channel-info");
-	if (params.encryptionEnabled && params.gate("verification")) actions.add("permissions");
+	if (params.encryptionEnabled && params.gate("verification") && params.senderIsOwner === true) actions.add("permissions");
 	return actions;
 }
 function buildMatrixProfileToolSchema() {
@@ -94,18 +93,21 @@ function buildMatrixProfileToolSchema() {
 		}
 	};
 }
+function resolveMatrixActionAccount(params) {
+	if (!params.accountId && requiresExplicitMatrixDefaultAccount(params.cfg)) return null;
+	const account = resolveMatrixAccount({
+		cfg: params.cfg,
+		accountId: params.accountId ?? resolveDefaultMatrixAccountId(params.cfg)
+	});
+	return account.enabled && account.configured ? account : null;
+}
 const matrixMessageActions = {
 	describeMessageTool: ({ cfg, accountId, senderIsOwner }) => {
-		const resolvedCfg = cfg;
-		if (!accountId && requiresExplicitMatrixDefaultAccount(resolvedCfg)) return {
-			actions: [],
-			capabilities: []
-		};
-		const account = resolveMatrixAccount({
-			cfg: resolvedCfg,
-			accountId: accountId ?? resolveDefaultMatrixAccountId(resolvedCfg)
+		const account = resolveMatrixActionAccount({
+			cfg,
+			accountId
 		});
-		if (!account.enabled || !account.configured) return {
+		if (!account) return {
 			actions: [],
 			capabilities: []
 		};
@@ -126,13 +128,22 @@ const matrixMessageActions = {
 	extractToolSend: ({ args }) => {
 		return extractToolSend(args, "sendMessage");
 	},
+	prepareSendPayload: ({ ctx, payload }) => {
+		if (ctx.action !== "send") return null;
+		const account = resolveMatrixActionAccount({
+			cfg: ctx.cfg,
+			accountId: ctx.accountId
+		});
+		return account && createActionGate(account.config.actions)("messages") ? payload : null;
+	},
 	handleAction: async (ctx) => {
-		const { handleMatrixAction } = await import("./tool-actions.runtime-Dh5ow2EK.js");
+		const { handleMatrixAction } = await import("./tool-actions.runtime-DmdRL0bN.js");
 		const { action, params, cfg, accountId, mediaLocalRoots } = ctx;
 		const dispatch = async (actionParams) => await handleMatrixAction({
 			...actionParams,
 			...accountId ? { accountId } : {}
 		}, cfg, {
+			...action === "send" && ctx.mediaAccess ? { mediaAccess: ctx.mediaAccess } : {},
 			mediaLocalRoots,
 			readContext: {
 				accountId,
@@ -149,7 +160,8 @@ const matrixMessageActions = {
 			const mediaUrl = readStringParam(params, "media", { trim: false }) ?? readStringParam(params, "mediaUrl", { trim: false }) ?? readStringParam(params, "filePath", { trim: false }) ?? readStringParam(params, "path", { trim: false });
 			const content = readStringParam(params, "message", {
 				required: !mediaUrl,
-				allowEmpty: true
+				allowEmpty: true,
+				trim: false
 			});
 			const replyTo = readStringParam(params, "replyTo");
 			const threadId = readStringParam(params, "threadId");
@@ -203,7 +215,10 @@ const matrixMessageActions = {
 		}
 		if (action === "edit") {
 			const messageId = readStringParam(params, "messageId", { required: true });
-			const content = readStringParam(params, "message", { required: true });
+			const content = readStringParam(params, "message", {
+				required: true,
+				trim: false
+			});
 			return await dispatch({
 				action: "editMessage",
 				roomId: resolveRoomId(),
@@ -247,6 +262,7 @@ const matrixMessageActions = {
 			roomId: resolveRoomId()
 		});
 		if (action === "permissions") {
+			if (ctx.senderIsOwner !== true) throw new ToolAuthorizationError("Matrix verification actions require owner access.");
 			const operation = normalizeLowercaseStringOrEmpty(readStringParam(params, "operation") ?? readStringParam(params, "mode") ?? "verification-list");
 			const operationToAction = {
 				"encryption-status": "encryptionStatus",
@@ -306,51 +322,37 @@ function resolveMatrixExecApprovalConfig(params) {
 		enabled: account.enabled && account.configured ? config.enabled : false
 	};
 }
-function countMatrixExecApprovalEligibleAccounts(params) {
-	return listMatrixAccountIds(params.cfg).filter((accountId) => {
-		const account = resolveMatrixAccount({
-			cfg: params.cfg,
-			accountId
-		});
-		if (!account.enabled || !account.configured) return false;
-		const config = resolveMatrixExecApprovalConfig({
-			cfg: params.cfg,
-			accountId
-		});
-		const filters = config?.enabled ? {
-			agentFilter: config.agentFilter,
-			sessionFilter: config.sessionFilter
-		} : {
-			agentFilter: void 0,
-			sessionFilter: void 0
-		};
-		return isChannelExecApprovalClientEnabledFromConfig({
-			enabled: config?.enabled,
-			approverCount: getMatrixApprovalApprovers({
-				cfg: params.cfg,
-				accountId,
-				approvalKind: params.approvalKind
-			}).length
-		}) && matchesApprovalRequestFilters({
-			request: params.request.request,
-			agentFilter: filters.agentFilter,
-			sessionFilter: filters.sessionFilter
-		});
-	}).length;
+function isMatrixExecApprovalAccountEligible(params) {
+	const account = resolveMatrixAccount(params);
+	if (!account.enabled || !account.configured) return false;
+	const config = resolveMatrixExecApprovalConfig(params);
+	const filters = config?.enabled ? {
+		agentFilter: config.agentFilter,
+		sessionFilter: config.sessionFilter
+	} : {
+		agentFilter: void 0,
+		sessionFilter: void 0
+	};
+	return isChannelExecApprovalClientEnabledFromConfig({
+		enabled: config?.enabled,
+		approverCount: getMatrixApprovalApprovers(params).length
+	}) && matchesApprovalRequestFilters({
+		request: params.request.request,
+		agentFilter: filters.agentFilter,
+		sessionFilter: filters.sessionFilter
+	});
 }
 function matchesMatrixRequestAccount(params) {
-	const turnSourceChannel = normalizeLowercaseStringOrEmpty(params.request.request.turnSourceChannel);
-	const boundAccountId = resolveApprovalRequestChannelAccountId({
-		cfg: params.cfg,
-		request: params.request,
-		channel: "matrix"
+	const accountId = params.accountId ?? resolveDefaultMatrixAccountId(params.cfg);
+	return doesApprovalRequestSelectChannelAccount({
+		...params,
+		channel: "matrix",
+		defaultAccountId: resolveDefaultMatrixAccountId(params.cfg),
+		eligibleAccountIds: isMatrixExecApprovalAccountEligible({
+			...params,
+			accountId
+		}) ? [accountId] : []
 	});
-	if (turnSourceChannel && turnSourceChannel !== "matrix" && !boundAccountId) return countMatrixExecApprovalEligibleAccounts({
-		cfg: params.cfg,
-		request: params.request,
-		approvalKind: params.approvalKind
-	}) <= 1;
-	return !boundAccountId || !params.accountId || normalizeAccountId$1(boundAccountId) === normalizeAccountId$1(params.accountId);
 }
 function getMatrixExecApprovalApprovers(params) {
 	const account = resolveMatrixAccount(params).config;
@@ -601,7 +603,7 @@ const matrixNativeApprovalCapability = createApproverRestrictedNativeApprovalCap
 			approvalKind,
 			request
 		}),
-		load: async () => (await import("./approval-handler.runtime-D1ibJgSk.js")).matrixApprovalNativeRuntime
+		load: async () => (await import("./approval-handler.runtime-CJXCUdRg.js")).matrixApprovalNativeRuntime
 	})
 });
 const splitMatrixApprovalCapability = splitChannelApprovalCapability(matrixNativeApprovalCapability);
@@ -699,7 +701,7 @@ function createMatrixProbeAccount(params) {
 		} catch (err) {
 			return {
 				ok: false,
-				error: formatMatrixErrorMessage(err),
+				error: formatErrorMessage(err),
 				elapsedMs: 0
 			};
 		}
@@ -719,6 +721,53 @@ function createMatrixPairingText(sendMessageMatrix) {
 	};
 }
 //#endregion
+//#region extensions/matrix/src/channel-message-adapter.ts
+function createMatrixMessageAdapter(params) {
+	const base = createChannelMessageAdapterFromOutbound({
+		id: "matrix",
+		outbound: params.outbound,
+		live: {
+			capabilities: {
+				draftPreview: true,
+				previewFinalization: true,
+				progressUpdates: true,
+				quietFinalization: true
+			},
+			finalizer: { capabilities: {
+				finalEdit: true,
+				normalFallback: true,
+				discardPending: true,
+				previewReceipt: true
+			} }
+		}
+	});
+	return {
+		...base,
+		durableFinal: {
+			...base.durableFinal,
+			automaticUnknownSendReconciliation: true,
+			capabilities: {
+				...base.durableFinal?.capabilities,
+				afterCommit: true,
+				reconcileUnknownSend: true
+			},
+			reconcileUnknownSendKinds: {
+				text: true,
+				media: true
+			},
+			reconcileUnknownSend: async (ctx) => await (await params.getRuntime()).reconcileMatrixUnknownSend(ctx),
+			afterUnknownSendTerminal: async (ctx) => await (await params.getRuntime()).cleanupMatrixDeliveryPlans({ queueId: ctx.queueId })
+		},
+		send: {
+			...base.send,
+			lifecycle: { afterCommit: async (ctx) => {
+				if (!ctx.deliveryQueueId) return;
+				await (await params.getRuntime()).cleanupMatrixDeliveryPlans({ queueId: ctx.deliveryQueueId });
+			} }
+		}
+	};
+}
+//#endregion
 //#region extensions/matrix/src/matrix/monitor/rooms.ts
 function readLegacyRoomAllowAlias(room) {
 	const rawRoom = room;
@@ -780,7 +829,7 @@ function resolveMatrixGroupToolPolicy(params) {
 }
 //#endregion
 //#region extensions/matrix/src/resolver.ts
-const loadMatrixChannelRuntime$1 = createLazyRuntimeNamedExport(() => import("./resolver.runtime-BvaFlVLg.js"), "matrixResolverRuntime");
+const loadMatrixChannelRuntime$1 = createLazyRuntimeNamedExport(() => import("./resolver.runtime-LWJELYq5.js"), "matrixResolverRuntime");
 const matrixResolverAdapter = { resolveTargets: async ({ cfg, accountId, inputs, kind, runtime }) => (await loadMatrixChannelRuntime$1()).resolveMatrixTargets({
 	cfg,
 	accountId,
@@ -895,6 +944,11 @@ function resolveMatrixOutboundSessionRoute(params) {
 		replyToId: params.replyToId,
 		threadId: params.threadId,
 		currentSessionKey: params.currentSessionKey,
+		precedence: [
+			"threadId",
+			"replyToId",
+			"currentSession"
+		],
 		normalizeThreadId: (threadId) => threadId,
 		canRecoverCurrentThread: ({ route }) => route.peer.kind !== "direct" || (params.cfg.session?.dmScope ?? "main") !== "main"
 	});
@@ -902,20 +956,8 @@ function resolveMatrixOutboundSessionRoute(params) {
 //#endregion
 //#region extensions/matrix/src/channel.ts
 let matrixStartupLock = Promise.resolve();
-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",
-	selectionLabel: "Matrix (plugin)",
-	docsPath: "/channels/matrix",
-	docsLabel: "matrix",
-	blurb: "open protocol; configure a homeserver + access token.",
-	order: 70,
-	markdownCapable: true,
-	quickstartAllowFrom: true
-};
+const loadMatrixChannelRuntime = createLazyRuntimeNamedExport(() => import("./channel.runtime-pOOL0uT_.js"), "matrixChannelRuntime");
+const loadMatrixDoctorModule = createLazyRuntimeModule(() => import("./doctor-EWf9CDso.js"));
 function buildMatrixTrafficStatusSummary(snapshot) {
 	return {
 		lastInboundAt: snapshot?.lastInboundAt ?? null,
@@ -1051,6 +1093,13 @@ function resolveMatrixDeliveryTarget(params) {
 	if (conversationTarget?.kind === "room") return { to: `room:${conversationTarget.id}` };
 	return null;
 }
+function matchesMatrixToolContextRoom(params) {
+	const { toolContext } = params;
+	if (toolContext.currentChannelProvider && toolContext.currentChannelProvider !== "matrix") return false;
+	const currentTarget = toolContext.currentChannelId ? resolveMatrixTargetIdentity(toolContext.currentChannelId) : null;
+	const target = resolveMatrixTargetIdentity(params.target);
+	return currentTarget?.kind === "room" && target?.kind === "room" && currentTarget.id === target.id;
+}
 const matrixChannelOutbound = {
 	deliveryMode: "direct",
 	chunker: chunkTextForOutbound,
@@ -1062,7 +1111,9 @@ const matrixChannelOutbound = {
 		media: true,
 		replyTo: true,
 		thread: true,
-		messageSendingHooks: true
+		messageSendingHooks: true,
+		afterCommit: true,
+		reconcileUnknownSend: true
 	} },
 	presentationCapabilities: {
 		supported: true,
@@ -1104,52 +1155,21 @@ const matrixChannelOutbound = {
 		}
 	})
 };
-const matrixMessageAdapter = createChannelMessageAdapterFromOutbound({
-	id: "matrix",
+const matrixMessageAdapter = createMatrixMessageAdapter({
 	outbound: matrixChannelOutbound,
-	live: {
-		capabilities: {
-			draftPreview: true,
-			previewFinalization: true,
-			progressUpdates: true,
-			quietFinalization: true
-		},
-		finalizer: { capabilities: {
-			finalEdit: true,
-			normalFallback: true,
-			discardPending: true,
-			previewReceipt: true
-		} }
-	}
+	getRuntime: loadMatrixChannelRuntime
 });
 const matrixPlugin = createChatChannelPlugin({
 	base: {
-		id: "matrix",
-		meta,
-		setupWizard: createMatrixSetupWizardProxy(async () => ({ matrixSetupWizard: await loadMatrixSetupWizard() })),
+		...matrixPluginBase,
+		meta: {
+			...matrixPluginBase.meta,
+			markdownCapable: true
+		},
 		capabilities: {
-			chatTypes: [
-				"direct",
-				"group",
-				"thread"
-			],
-			polls: true,
-			reactions: true,
-			threads: true,
-			media: true,
+			...matrixPluginBase.capabilities,
 			tts: { voice: { synthesisTarget: "voice-note" } }
 		},
-		reload: { configPrefixes: ["channels.matrix"] },
-		configSchema: MatrixChannelConfigSchema,
-		config: {
-			...matrixConfigAdapter,
-			isConfigured: (account) => account.configured,
-			describeAccount: (account) => describeAccountSnapshot({
-				account,
-				configured: account.configured,
-				extra: { baseUrl: account.homeserver }
-			})
-		},
 		approvalCapability: matrixApprovalCapability,
 		groups: {
 			resolveRequireMention: resolveMatrixGroupRequireMention,
@@ -1174,6 +1194,10 @@ const matrixPlugin = createChatChannelPlugin({
 			targetPrefixes: ["matrix"],
 			targetIdComparison: "case-sensitive",
 			normalizeTarget: normalizeMatrixMessagingTarget,
+			inferTargetChatType: ({ to }) => {
+				const target = resolveMatrixTargetIdentity(to);
+				return target ? target.kind === "user" ? "direct" : "channel" : void 0;
+			},
 			resolveInboundConversation: ({ to, conversationId, threadId }) => resolveMatrixInboundConversation({
 				to,
 				conversationId,
@@ -1215,18 +1239,6 @@ const matrixPlugin = createChatChannelPlugin({
 			secretTargetRegistryEntries,
 			collectRuntimeConfigAssignments
 		},
-		setup: {
-			...matrixSetupAdapter,
-			singleAccountKeysToMove,
-			namedAccountPromotionKeys,
-			resolveSingleAccountPromotionTarget
-		},
-		setupContract: {
-			...matrixSetupContract,
-			singleAccountKeysToMove,
-			namedAccountPromotionKeys,
-			resolveSingleAccountPromotionTarget
-		},
 		bindings: {
 			compileConfiguredBinding: ({ conversationId }) => normalizeMatrixAcpConversationId(conversationId),
 			matchInboundConversation: ({ compiledBinding, conversationId, parentConversationId }) => matchMatrixAcpConversation({
@@ -1283,7 +1295,7 @@ const matrixPlugin = createChatChannelPlugin({
 			await previousLock;
 			let monitorMatrixProvider;
 			try {
-				monitorMatrixProvider = (await import("./monitor-s--XqoxF.js")).monitorMatrixProvider;
+				monitorMatrixProvider = (await import("./monitor-Ddfc-vjX.js")).monitorMatrixProvider;
 			} finally {
 				releaseLock();
 			}
@@ -1320,6 +1332,15 @@ const matrixPlugin = createChatChannelPlugin({
 	},
 	pairing: { text: createMatrixPairingText(async (to, message, options) => await (await loadMatrixChannelRuntime()).sendMessageMatrix(to, message, options)) },
 	threading: {
+		matchesToolContextTarget: matchesMatrixToolContextRoom,
+		resolveAutoThreadId: ({ to, toolContext }) => {
+			const threadId = normalizeOptionalString(toolContext?.currentThreadTs);
+			if (!threadId || !toolContext) return;
+			return matchesMatrixToolContextRoom({
+				target: to,
+				toolContext
+			}) ? threadId : void 0;
+		},
 		resolveReplyToMode: createScopedAccountReplyToModeResolver({
 			resolveAccount: adaptScopedAccountAccessor(resolveMatrixAccountConfig),
 			resolveReplyToMode: (account) => account.replyToMode

package/dist/channel-plugin-api.js

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