@openclaw/matrix 2026.7.1-beta.6 → 2026.7.2-beta.1

package/dist/{channel-jUTBsjHU.js → channel-CxqDh7mS.js}

@@ -1,22 +1,20 @@
-import { n as requiresExplicitMatrixDefaultAccount } from "./account-selection-5e4mHR1m.js";
+import { n as requiresExplicitMatrixDefaultAccount } from "./account-selection-Bz00QTmQ.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-BGgbrdaJ.js";
-import { a as normalizeMatrixUserId, n as DEFAULT_ACCOUNT_ID$2, r as matrixConfigAdapter, t as MatrixChannelConfigSchema } from "./config-schema-DtnhNYd-.js";
-import { t as normalizeMatrixApproverId } from "./approval-ids-ZgqbspmS.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-DlmTyIP0.js";
+import { a as normalizeMatrixUserId, n as DEFAULT_ACCOUNT_ID$2, r as matrixConfigAdapter, t as MatrixChannelConfigSchema } from "./config-schema-CG9goLWp.js";
+import { t as normalizeMatrixApproverId } from "./approval-ids-C_2kSMdJ.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-BAja_fmb.js";
+import { n as normalizeCompatibilityConfig, t as legacyConfigRules } from "./doctor-contract-D2qTLe-C.js";
 import { d as setMatrixThreadBindingIdleTimeoutBySessionKey, p as setMatrixThreadBindingMaxAgeBySessionKey } from "./thread-bindings-shared-CKnY4LSd.js";
-import { n as collectRuntimeConfigAssignments, r as secretTargetRegistryEntries } from "./secret-contract-DTgQyQxc.js";
-import { i as autoPrepareLegacyMatrixCrypto, o as autoMigrateLegacyMatrixState, r as resolveMatrixMigrationStatus } from "./matrix-migration.runtime-BMCyrANT.js";
-import { t as maybeCreateMatrixMigrationSnapshot } from "./migration-snapshot-backup-YcCrSjbE.js";
-import { n as resolveMatrixInboundConversation } from "./thread-binding-api-DRbBZlhS.js";
+import { n as collectRuntimeConfigAssignments, r as secretTargetRegistryEntries } from "./secret-contract-OZoQf0kI.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";
-import { createAllowlistProviderOpenWarningCollector, projectAccountConfigWarningCollector } from "openclaw/plugin-sdk/channel-policy";
+import { createAllowlistProviderOpenWarningCollector, projectAccountConfigWarningCollector, resolveScopeRequireMention, resolveScopeToolsPolicy } from "openclaw/plugin-sdk/channel-policy";
 import { createScopedAccountReplyToModeResolver } from "openclaw/plugin-sdk/conversation-runtime";
 import { createChannelDirectoryAdapter, createResolvedDirectoryEntriesLister, createRuntimeDirectoryLiveAdapter } from "openclaw/plugin-sdk/directory-runtime";
 import { buildProbeChannelStatusSummary, collectStatusIssuesFromLastError, createComputedAccountStatusAdapter, createDefaultChannelRuntimeState } from "openclaw/plugin-sdk/status-helpers";
@@ -29,7 +27,7 @@ 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 { createResolvedApproverActionAuthAdapter, resolveApprovalApprovers } from "openclaw/plugin-sdk/approval-auth-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";
@@ -37,7 +35,7 @@ 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 { buildChannelKeyCandidates, resolveChannelEntryMatch } from "openclaw/plugin-sdk/channel-targets";
+import { buildChannelKeyCandidates } from "openclaw/plugin-sdk/channel-targets";
 import { getSessionEntry, resolveStorePath } from "openclaw/plugin-sdk/session-store-runtime";
 //#region extensions/matrix/src/actions.ts
 const MATRIX_PLUGIN_HANDLED_ACTIONS = /* @__PURE__ */ new Set([
@@ -119,7 +117,7 @@ const matrixMessageActions = {
 		const listedActions = Array.from(actions);
 		return {
 			actions: listedActions,
-			capabilities: [],
+			capabilities: ["presentation"],
 			schema: listedActions.includes("set-profile") ? buildMatrixProfileToolSchema() : null,
 			mediaSourceParams: listedActions.includes("set-profile") ? { "set-profile": MATRIX_PROFILE_MEDIA_SOURCE_PARAMS } : null
 		};
@@ -129,12 +127,22 @@ const matrixMessageActions = {
 		return extractToolSend(args, "sendMessage");
 	},
 	handleAction: async (ctx) => {
-		const { handleMatrixAction } = await import("./tool-actions.runtime-C1d5fxE_.js");
+		const { handleMatrixAction } = await import("./tool-actions.runtime-CnyhVPoY.js");
 		const { action, params, cfg, accountId, mediaLocalRoots } = ctx;
 		const dispatch = async (actionParams) => await handleMatrixAction({
 			...actionParams,
 			...accountId ? { accountId } : {}
-		}, cfg, { mediaLocalRoots });
+		}, cfg, {
+			mediaLocalRoots,
+			readContext: {
+				accountId,
+				requesterAccountId: ctx.requesterAccountId,
+				currentChannelId: ctx.toolContext?.currentChannelId,
+				currentChannelProvider: ctx.toolContext?.currentChannelProvider,
+				currentChatType: ctx.toolContext?.currentChatType,
+				conversationReadOrigin: ctx.conversationReadOrigin
+			}
+		});
 		const resolveRoomId = () => readStringParam(params, "roomId") ?? readStringParam(params, "channelId") ?? readStringParam(params, "to", { required: true });
 		if (action === "send") {
 			const to = readStringParam(params, "to", { required: true });
@@ -232,7 +240,7 @@ const matrixMessageActions = {
 		if (action === "member-info") return await dispatch({
 			action: "memberInfo",
 			userId: readStringParam(params, "userId", { required: true }),
-			roomId: readStringParam(params, "roomId") ?? readStringParam(params, "channelId")
+			roomId: resolveRoomId()
 		});
 		if (action === "channel-info") return await dispatch({
 			action: "channelInfo",
@@ -271,20 +279,18 @@ const matrixMessageActions = {
 };
 //#endregion
 //#region extensions/matrix/src/approval-auth.ts
-function getMatrixApprovalAuthApprovers(params) {
-	return resolveApprovalApprovers({
-		allowFrom: resolveMatrixAccount(params).config.dm?.allowFrom,
-		normalizeApprover: normalizeMatrixApproverId
-	});
-}
-const matrixApprovalAuth = createResolvedApproverActionAuthAdapter({
+const matrixApproval = createChannelApprovalAuth({
 	channelLabel: "Matrix",
-	resolveApprovers: ({ cfg, accountId }) => getMatrixApprovalAuthApprovers({
-		cfg,
-		accountId
-	}),
-	normalizeSenderId: (value) => normalizeMatrixApproverId(value)
+	resolveInputs: ({ cfg, accountId }) => {
+		return { allowFrom: resolveMatrixAccount({
+			cfg,
+			accountId
+		}).config.dm?.allowFrom };
+	},
+	normalizeApprover: normalizeMatrixApproverId
 });
+const getMatrixApprovalAuthApprovers = matrixApproval.resolveApprovers;
+const matrixApprovalAuth = matrixApproval.approvalAuth;
 //#endregion
 //#region extensions/matrix/src/exec-approvals.ts
 function normalizeMatrixExecApproverId(value) {
@@ -354,9 +360,6 @@ function getMatrixExecApprovalApprovers(params) {
 		normalizeApprover: normalizeMatrixExecApproverId
 	});
 }
-function resolveMatrixApprovalKind(request) {
-	return request.id.startsWith("plugin:") ? "plugin" : "exec";
-}
 function getMatrixApprovalApprovers(params) {
 	if (params.approvalKind === "plugin") return getMatrixApprovalAuthApprovers({
 		cfg: params.cfg,
@@ -383,10 +386,8 @@ const matrixExecApprovalProfile = createChannelExecApprovalProfile({
 	})
 });
 const isMatrixExecApprovalClientEnabled = matrixExecApprovalProfile.isClientEnabled;
-matrixExecApprovalProfile.isApprover;
 const isMatrixExecApprovalAuthorizedSender = matrixExecApprovalProfile.isAuthorizedSender;
 const resolveMatrixExecApprovalTarget = matrixExecApprovalProfile.resolveTarget;
-matrixExecApprovalProfile.shouldHandleRequest;
 function isMatrixApprovalClientEnabled(params) {
 	if (params.approvalKind === "exec") return isMatrixExecApprovalClientEnabled(params);
 	return isChannelExecApprovalClientEnabledFromConfig({
@@ -404,17 +405,17 @@ function isMatrixAnyApprovalClientEnabled(params) {
 	});
 }
 function shouldHandleMatrixApprovalRequest(params) {
-	const approvalKind = resolveMatrixApprovalKind(params.request);
+	if (params.approvalKind !== "exec" && params.approvalKind !== "plugin") return false;
 	if (!matchesMatrixRequestAccount({
 		...params,
-		approvalKind
+		approvalKind: params.approvalKind
 	})) return false;
 	const config = resolveMatrixExecApprovalConfig(params);
 	if (!isChannelExecApprovalClientEnabledFromConfig({
 		enabled: config?.enabled,
 		approverCount: getMatrixApprovalApprovers({
 			...params,
-			approvalKind
+			approvalKind: params.approvalKind
 		}).length
 	})) return false;
 	return matchesApprovalRequestFilters({
@@ -454,6 +455,7 @@ function shouldSuppressLocalMatrixExecApprovalPrompt(params) {
 	return shouldHandleMatrixApprovalRequest({
 		cfg: params.cfg,
 		accountId: params.accountId,
+		approvalKind: metadata.approvalKind,
 		request
 	});
 }
@@ -519,11 +521,15 @@ function resolveSuppressionAccountId(params) {
 }
 const resolveMatrixOriginTarget = createChannelNativeOriginTargetResolver({
 	channel: "matrix",
-	shouldHandleRequest: ({ cfg, accountId, request }) => shouldHandleMatrixApprovalRequest({
-		cfg,
-		accountId,
-		request
-	}),
+	shouldHandleRequest: ({ cfg, accountId, approvalKind, request }) => {
+		if (approvalKind !== "exec" && approvalKind !== "plugin") return false;
+		return shouldHandleMatrixApprovalRequest({
+			cfg,
+			accountId,
+			approvalKind,
+			request
+		});
+	},
 	resolveTurnSourceTarget: resolveTurnSourceMatrixOriginTarget,
 	resolveSessionTarget: resolveSessionMatrixOriginTarget,
 	normalizeTargetForMatch: normalizeMatrixOriginTarget,
@@ -589,12 +595,13 @@ const matrixNativeApprovalCapability = createApproverRestrictedNativeApprovalCap
 			cfg,
 			accountId
 		}),
-		shouldHandle: ({ cfg, accountId, request }) => shouldHandleMatrixApprovalRequest({
+		shouldHandle: ({ cfg, accountId, approvalKind, request }) => shouldHandleMatrixApprovalRequest({
 			cfg,
 			accountId,
+			approvalKind,
 			request
 		}),
-		load: async () => (await import("./approval-handler.runtime-DI5x9r8I.js")).matrixApprovalNativeRuntime
+		load: async () => (await import("./approval-handler.runtime--Ei44Vo2.js")).matrixApprovalNativeRuntime
 	})
 });
 const splitMatrixApprovalCapability = splitChannelApprovalCapability(matrixNativeApprovalCapability);
@@ -609,6 +616,16 @@ const matrixDeliveryAdapter = matrixBaseDeliveryAdapter && {
 			accountId,
 			approvalKind: params.approvalKind
 		})) return false;
+		if (params.approvalKind === "plugin") {
+			const targetChannel = normalizeLowercaseStringOrEmpty(params.target.channel);
+			const turnSourceChannel = normalizeLowercaseStringOrEmpty(params.request.request.turnSourceChannel);
+			return targetChannel === "matrix" && turnSourceChannel === "matrix" && shouldHandleMatrixApprovalRequest({
+				cfg: params.cfg,
+				accountId,
+				approvalKind: "plugin",
+				request: params.request
+			});
+		}
 		return matrixBaseDeliveryAdapter.shouldSuppressForwardingFallback?.(params) ?? false;
 	}
 };
@@ -627,7 +644,7 @@ const matrixNativeAdapter = matrixBaseNativeApprovalAdapter && {
 		});
 		return {
 			...capabilities,
-			enabled: capabilities.enabled && hasApprovers && clientEnabled
+			enabled: hasApprovers && clientEnabled
 		};
 	},
 	resolveOriginTarget: matrixBaseNativeApprovalAdapter.resolveOriginTarget,
@@ -707,56 +724,63 @@ function readLegacyRoomAllowAlias(room) {
 	const rawRoom = room;
 	return typeof rawRoom?.allow === "boolean" ? rawRoom.allow : void 0;
 }
+function buildMatrixRoomScopeTree(rooms) {
+	const scopes = {};
+	for (const [key, room] of Object.entries(rooms ?? {})) scopes[key] = {
+		requireMention: typeof room.autoReply === "boolean" ? !room.autoReply : room.requireMention,
+		tools: room.tools
+	};
+	return { scopes };
+}
+function resolveMatrixRoomScopePath(params) {
+	const key = buildChannelKeyCandidates(params.roomId, `room:${params.roomId}`, ...params.aliases).find((candidate) => Object.hasOwn(params.tree.scopes, candidate)) ?? (Object.hasOwn(params.tree.scopes, "*") ? "*" : void 0);
+	return key ? [key] : [];
+}
 function resolveMatrixRoomConfig(params) {
 	const rooms = params.rooms ?? {};
-	const allowlistConfigured = Object.keys(rooms).length > 0;
-	const { entry: matched, key: matchedKey, wildcardEntry, wildcardKey } = resolveChannelEntryMatch({
-		entries: rooms,
-		keys: buildChannelKeyCandidates(params.roomId, `room:${params.roomId}`, ...params.aliases),
-		wildcardKey: "*"
+	const tree = { scopes: rooms };
+	const [matchKey] = resolveMatrixRoomScopePath({
+		...params,
+		tree
 	});
-	const resolved = matched ?? wildcardEntry;
+	const resolved = matchKey ? rooms[matchKey] : void 0;
 	const legacyAllow = readLegacyRoomAllowAlias(resolved);
 	return {
 		allowed: resolved ? resolved.enabled !== false && legacyAllow !== false : false,
-		allowlistConfigured,
+		allowlistConfigured: Object.keys(rooms).length > 0,
 		config: resolved,
-		matchKey: matchedKey ?? wildcardKey,
-		matchSource: matched ? "direct" : wildcardEntry ? "wildcard" : void 0
+		matchKey,
+		matchSource: resolved ? matchKey === "*" ? "wildcard" : "direct" : void 0
 	};
 }
 //#endregion
 //#region extensions/matrix/src/group-mentions.ts
-function resolveMatrixRoomConfigForGroup(params) {
-	const roomId = normalizeMatrixResolvableTarget(params.groupId?.trim() ?? "");
-	const groupChannel = params.groupChannel?.trim() ?? "";
-	const aliases = groupChannel ? [normalizeMatrixResolvableTarget(groupChannel)] : [];
-	const cfg = params.cfg;
+function resolveMatrixGroupScope(params) {
 	const matrixConfig = resolveMatrixAccountConfig({
-		cfg,
+		cfg: params.cfg,
 		accountId: params.accountId
 	});
-	return resolveMatrixRoomConfig({
-		rooms: matrixConfig.groups ?? matrixConfig.rooms,
-		roomId,
-		aliases
-	}).config;
+	const tree = buildMatrixRoomScopeTree(matrixConfig.groups ?? matrixConfig.rooms);
+	const roomId = normalizeMatrixResolvableTarget(params.groupId?.trim() ?? "");
+	const groupChannel = normalizeMatrixResolvableTarget(params.groupChannel?.trim() ?? "");
+	return {
+		tree,
+		path: resolveMatrixRoomScopePath({
+			tree,
+			roomId,
+			aliases: groupChannel ? [groupChannel] : []
+		})
+	};
 }
 function resolveMatrixGroupRequireMention(params) {
-	const resolved = resolveMatrixRoomConfigForGroup(params);
-	if (resolved) {
-		if (resolved.autoReply === true) return false;
-		if (resolved.autoReply === false) return true;
-		if (typeof resolved.requireMention === "boolean") return resolved.requireMention;
-	}
-	return true;
+	return resolveScopeRequireMention(resolveMatrixGroupScope(params));
 }
 function resolveMatrixGroupToolPolicy(params) {
-	return resolveMatrixRoomConfigForGroup(params)?.tools;
+	return resolveScopeToolsPolicy(resolveMatrixGroupScope(params));
 }
 //#endregion
 //#region extensions/matrix/src/resolver.ts
-const loadMatrixChannelRuntime$1 = createLazyRuntimeNamedExport(() => import("./resolver.runtime-Hr6bO5zl.js"), "matrixResolverRuntime");
+const loadMatrixChannelRuntime$1 = createLazyRuntimeNamedExport(() => import("./resolver.runtime-MeaT1zXx.js"), "matrixResolverRuntime");
 const matrixResolverAdapter = { resolveTargets: async ({ cfg, accountId, inputs, kind, runtime }) => (await loadMatrixChannelRuntime$1()).resolveMatrixTargets({
 	cfg,
 	accountId,
@@ -880,75 +904,11 @@ function resolveMatrixOutboundSessionRoute(params) {
 	});
 }
 //#endregion
-//#region extensions/matrix/src/startup-maintenance.ts
-function logWarningOnlyMatrixMigrationReasons(params) {
-	if (params.status.legacyState && "warning" in params.status.legacyState) params.log.warn?.(`matrix: ${params.status.legacyState.warning}`);
-	if (params.status.legacyCrypto.warnings.length > 0) params.log.warn?.(`matrix: legacy encrypted-state warnings:\n${params.status.legacyCrypto.warnings.map((entry) => `- ${entry}`).join("\n")}`);
-}
-async function runBestEffortMatrixMigrationStep(params) {
-	try {
-		await params.run();
-	} catch (err) {
-		params.log.warn?.(`${params.logPrefix?.trim() || "gateway"}: ${params.label} failed during Matrix migration; continuing startup: ${String(err)}`);
-	}
-}
-async function runMatrixStartupMaintenance(params) {
-	const env = params.env ?? process.env;
-	const createSnapshot = params.deps?.maybeCreateMatrixMigrationSnapshot ?? maybeCreateMatrixMigrationSnapshot;
-	const migrateLegacyState = params.deps?.autoMigrateLegacyMatrixState ?? autoMigrateLegacyMatrixState;
-	const prepareLegacyCrypto = params.deps?.autoPrepareLegacyMatrixCrypto ?? autoPrepareLegacyMatrixCrypto;
-	const trigger = params.trigger?.trim() || "gateway-startup";
-	const logPrefix = params.logPrefix?.trim() || "gateway";
-	const migrationStatus = resolveMatrixMigrationStatus({
-		cfg: params.cfg,
-		env
-	});
-	if (!migrationStatus.pending) return;
-	if (!migrationStatus.actionable) {
-		params.log.info?.("matrix: migration remains in a warning-only state; no pre-migration snapshot was needed yet");
-		logWarningOnlyMatrixMigrationReasons({
-			status: migrationStatus,
-			log: params.log
-		});
-		return;
-	}
-	try {
-		await createSnapshot({
-			trigger,
-			env,
-			log: params.log
-		});
-	} catch (err) {
-		params.log.warn?.(`${logPrefix}: failed creating a Matrix migration snapshot; skipping Matrix migration for now: ${String(err)}`);
-		return;
-	}
-	await runBestEffortMatrixMigrationStep({
-		label: "legacy Matrix state migration",
-		log: params.log,
-		logPrefix,
-		run: () => migrateLegacyState({
-			cfg: params.cfg,
-			env,
-			log: params.log
-		})
-	});
-	await runBestEffortMatrixMigrationStep({
-		label: "legacy Matrix encrypted-state preparation",
-		log: params.log,
-		logPrefix,
-		run: () => prepareLegacyCrypto({
-			cfg: params.cfg,
-			env,
-			log: params.log
-		})
-	});
-}
-//#endregion
 //#region extensions/matrix/src/channel.ts
 let matrixStartupLock = Promise.resolve();
-const loadMatrixSetupWizard = createLazyRuntimeNamedExport(() => import("./setup-surface-iJ6pd-t5.js").then((n) => n.t), "matrixSetupWizard");
-const loadMatrixChannelRuntime = createLazyRuntimeNamedExport(() => import("./channel.runtime-DO1Nv9ed.js"), "matrixChannelRuntime");
-const loadMatrixDoctorModule = createLazyRuntimeModule(() => import("./doctor-DfaOqFtr.js"));
+const loadMatrixSetupWizard = createLazyRuntimeNamedExport(() => import("./setup-surface-2SS94JV0.js").then((n) => n.t), "matrixSetupWizard");
+const loadMatrixChannelRuntime = createLazyRuntimeNamedExport(() => import("./channel.runtime-wNfJc57I.js"), "matrixChannelRuntime");
+const loadMatrixDoctorModule = createLazyRuntimeModule(() => import("./doctor-BGTs609f.js"));
 const meta = {
 	id: "matrix",
 	label: "Matrix",
@@ -1201,7 +1161,7 @@ const matrixPlugin = createChatChannelPlugin({
 		},
 		conversationBindings: {
 			supportsCurrentConversationBinding: true,
-			defaultTopLevelPlacement: "child",
+			defaultTopLevelPlacement,
 			setIdleTimeoutBySessionKey: ({ targetSessionKey, accountId, idleTimeoutMs }) => setMatrixThreadBindingIdleTimeoutBySessionKey({
 				targetSessionKey,
 				accountId: accountId ?? "",
@@ -1320,7 +1280,7 @@ const matrixPlugin = createChatChannelPlugin({
 			await previousLock;
 			let monitorMatrixProvider;
 			try {
-				monitorMatrixProvider = (await import("./monitor-CsGOGdwu.js")).monitorMatrixProvider;
+				monitorMatrixProvider = (await import("./monitor-C_kgPPeV.js")).monitorMatrixProvider;
 			} finally {
 				releaseLock();
 			}
@@ -1336,7 +1296,6 @@ const matrixPlugin = createChatChannelPlugin({
 			});
 		} },
 		doctor: matrixDoctor,
-		lifecycle: { runStartupMaintenance: runMatrixStartupMaintenance },
 		heartbeat: {
 			sendTyping: async ({ cfg, to, accountId }) => {
 				await (await loadMatrixChannelRuntime()).sendTypingMatrix(to, true, {

package/dist/channel-plugin-api.js

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

package/dist/{channel.runtime-DO1Nv9ed.js → channel.runtime-wNfJc57I.js}

@@ -1,10 +1,10 @@
-import { a as sendMessageMatrix, c as sendTypingMatrix, o as sendPollMatrix } from "./send-D92v6Yy0.js";
+import { a as sendMessageMatrix, c as sendTypingMatrix, o as sendPollMatrix } from "./send-C7xuGWpv.js";
 import { t as isBunRuntime } from "./runtime-BefyhPWv.js";
-import { f as resolveMatrixAuth } from "./shared-DkFfq7mH.js";
-import "./client-tgnlQJk4.js";
-import { n as listMatrixDirectoryGroupsLive, r as listMatrixDirectoryPeersLive } from "./directory-live-Ufd4qSpX.js";
-import { f as resolveOutboundSendDep, n as chunkTextForOutbound } from "./runtime-api-CsBoesCU.js";
-import { t as resolveMatrixTargets } from "./resolve-targets-DcV_KfgX.js";
+import { f as resolveMatrixAuth } from "./shared-DgvN5rBx.js";
+import "./client-DP0nmFxK.js";
+import { n as listMatrixDirectoryGroupsLive, r as listMatrixDirectoryPeersLive } from "./directory-live-DPy2aaPF.js";
+import { p as resolveOutboundSendDep, r as chunkTextForOutbound } from "./runtime-api-D1xI_cvh.js";
+import { t as resolveMatrixTargets } from "./resolve-targets-DlLrfWDy.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";
@@ -12,7 +12,7 @@ import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { renderMessagePresentationFallbackText } from "openclaw/plugin-sdk/interactive-runtime";
 import { resolvePayloadMediaUrls } from "openclaw/plugin-sdk/reply-payload";
 //#region extensions/matrix/src/matrix/probe.ts
-const loadMatrixProbeRuntimeDeps = createLazyRuntimeModule(() => import("./probe.runtime-2MZLc6ng.js").then((runtimeModule) => ({ createMatrixClient: runtimeModule.createMatrixClient })));
+const loadMatrixProbeRuntimeDeps = createLazyRuntimeModule(() => import("./probe.runtime-Dry8PTWC.js").then((runtimeModule) => ({ createMatrixClient: runtimeModule.createMatrixClient })));
 async function probeMatrix(params) {
 	const started = Date.now();
 	const result = {

package/dist/{cli-metadata-CfiEO-CE.js → cli-metadata-Gf3HSJ2c.js}

@@ -2,7 +2,7 @@ import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 //#region extensions/matrix/src/cli-metadata.ts
 function registerMatrixCliMetadata(api) {
 	api.registerCli(async ({ program }) => {
-		const { registerMatrixCli } = await import("./cli-CEfWwCKx.js");
+		const { registerMatrixCli } = await import("./cli-o00oTJhx.js");
 		registerMatrixCli({ program });
 	}, { descriptors: [{
 		name: "matrix",

package/dist/cli-metadata.js

@@ -1,2 +1,2 @@
-import { n as registerMatrixCliMetadata, t as cli_metadata_default } from "./cli-metadata-CfiEO-CE.js";
+import { n as registerMatrixCliMetadata, t as cli_metadata_default } from "./cli-metadata-Gf3HSJ2c.js";
 export { cli_metadata_default as default, registerMatrixCliMetadata };

package/dist/{cli-CEfWwCKx.js → cli-o00oTJhx.js}

@@ -1,16 +1,16 @@
 import { a as resolveMatrixAccountConfig } from "./account-config-BZWN9tGS.js";
-import { t as getMatrixRuntime } from "./runtime-6S3DNFNv.js";
-import { c as resolveMatrixConfigPath, g as resolveMatrixAccount, l as updateMatrixAccountConfig, n as matrixSetupAdapter } from "./setup-core-BGgbrdaJ.js";
+import { t as getMatrixRuntime } from "./runtime-CveSqMOP.js";
+import { c as resolveMatrixConfigPath, g as resolveMatrixAccount, l as updateMatrixAccountConfig, n as matrixSetupAdapter } from "./setup-core-DlmTyIP0.js";
 import { t as formatMatrixErrorMessage } from "./errors-C47hvAF8.js";
-import { n as withResolvedActionClient } from "./client-FRuyCNju.js";
-import { p as resolveMatrixAuthContext } from "./shared-DkFfq7mH.js";
-import "./client-tgnlQJk4.js";
-import { i as formatZonedTimestamp } from "./runtime-api-CsBoesCU.js";
+import { n as withResolvedActionClient } from "./client-ClHisZbf.js";
+import { p as resolveMatrixAuthContext } from "./shared-DgvN5rBx.js";
+import "./client-DP0nmFxK.js";
+import { a as formatZonedTimestamp } from "./runtime-api-D1xI_cvh.js";
 import { isOpenClawManagedMatrixDevice, summarizeMatrixDeviceHealth } from "./device-health-D4LBxuPq.js";
-import { n as updateMatrixOwnProfile, t as applyMatrixProfileUpdate } from "./profile-update-Ucc8RrJL.js";
-import { a as confirmMatrixVerificationSas, b as verifyMatrixRecoveryKey, c as getMatrixRoomKeyBackupStatus, d as listMatrixVerifications, f as mismatchMatrixVerificationSas, g as runMatrixSelfVerification, h as restoreMatrixRoomKeyBackup, l as getMatrixVerificationSas, m as resetMatrixRoomKeyBackup, n as bootstrapMatrixVerification, p as requestMatrixVerification, r as cancelMatrixVerification, t as acceptMatrixVerification, u as getMatrixVerificationStatus, v as startMatrixVerification } from "./verification-BGCMiO1p.js";
+import { n as updateMatrixOwnProfile, t as applyMatrixProfileUpdate } from "./profile-update-iUHCoks3.js";
+import { a as confirmMatrixVerificationSas, b as verifyMatrixRecoveryKey, c as getMatrixRoomKeyBackupStatus, d as listMatrixVerifications, f as mismatchMatrixVerificationSas, g as runMatrixSelfVerification, h as restoreMatrixRoomKeyBackup, l as getMatrixVerificationSas, m as resetMatrixRoomKeyBackup, n as bootstrapMatrixVerification, p as requestMatrixVerification, r as cancelMatrixVerification, t as acceptMatrixVerification, u as getMatrixVerificationStatus, v as startMatrixVerification } from "./verification-DLSe3sP7.js";
 import { t as resolveMatrixRoomKeyBackupIssue } from "./backup-health-Dm_YMVFT.js";
-import { setMatrixSdkConsoleLogging, setMatrixSdkLogMode } from "./logging-QH-48Gr6.js";
+import { setMatrixSdkConsoleLogging, setMatrixSdkLogMode } from "./logging-CFJrbDAN.js";
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 import { normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 import { parseStrictInteger, timestampMsToIsoString } from "openclaw/plugin-sdk/number-runtime";
@@ -36,8 +36,8 @@ async function pruneMatrixStaleGatewayDevices(opts = {}) {
 //#endregion
 //#region extensions/matrix/src/cli.ts
 let matrixCliExitScheduled = false;
-const loadMatrixActionClientModule = createLazyRuntimeModule(() => import("./client-FRuyCNju.js").then((n) => n.t));
-const loadMatrixDirectManagementModule = createLazyRuntimeModule(() => import("./send-D92v6Yy0.js").then((n) => n.d));
+const loadMatrixActionClientModule = createLazyRuntimeModule(() => import("./client-ClHisZbf.js").then((n) => n.t));
+const loadMatrixDirectManagementModule = createLazyRuntimeModule(() => import("./send-C7xuGWpv.js").then((n) => n.d));
 function scheduleMatrixCliExit() {
 	if (matrixCliExitScheduled || process.env.VITEST) return;
 	matrixCliExitScheduled = true;
@@ -205,7 +205,7 @@ async function addMatrixAccount(params) {
 		backupVersion: null
 	};
 	if (accountConfig.encryption === true) {
-		const { maybeBootstrapNewEncryptedMatrixAccount } = await import("./setup-bootstrap-Da564w5f.js");
+		const { maybeBootstrapNewEncryptedMatrixAccount } = await import("./setup-bootstrap-CCsexWTZ.js");
 		verificationBootstrap = await maybeBootstrapNewEncryptedMatrixAccount({
 			previousCfg: cfg,
 			cfg: updated,

package/dist/{client-FRuyCNju.js → client-ClHisZbf.js}

@@ -1,6 +1,6 @@
 import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
-import { u as resolveMatrixRoomId } from "./send-D92v6Yy0.js";
-import { n as withResolvedRuntimeMatrixClient } from "./client-bootstrap-DjFJ7e0N.js";
+import { u as resolveMatrixRoomId } from "./send-C7xuGWpv.js";
+import { n as withResolvedRuntimeMatrixClient } from "./client-bootstrap-PqYOS-mO.js";
 //#region extensions/matrix/src/matrix/actions/client.ts
 var client_exports = /* @__PURE__ */ __exportAll({
 	withResolvedActionClient: () => withResolvedActionClient,

package/dist/{client-tgnlQJk4.js → client-DP0nmFxK.js}

@@ -1,10 +1,10 @@
 import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
-import { t as getMatrixScopedEnvVarNames } from "./env-vars-KzaYveuy.js";
-import { i as resolveScopedMatrixEnvConfig, r as resolveMatrixEnvAuthReadiness, t as hasReadyMatrixEnvAuth } from "./env-auth-DIzOApj0.js";
+import { t as getMatrixScopedEnvVarNames } from "./env-vars-B0NxQnPk.js";
+import { i as resolveScopedMatrixEnvConfig, r as resolveMatrixEnvAuthReadiness, t as hasReadyMatrixEnvAuth } from "./env-auth-CQsYbz-p.js";
 import { n as validateMatrixHomeserverUrl, t as resolveValidatedMatrixHomeserverUrl } from "./url-validation-GRHde6lq.js";
 import { t as isBunRuntime } from "./runtime-BefyhPWv.js";
-import { d as backfillMatrixAuthDeviceIdAfterStartup, f as resolveMatrixAuth, i as resolveSharedMatrixClient, m as resolveMatrixConfigForAccount, n as releaseSharedClientInstance, o as stopSharedClientForAccount, p as resolveMatrixAuthContext, r as removeSharedClientInstance, s as stopSharedClientInstance, t as acquireSharedMatrixClient } from "./shared-DkFfq7mH.js";
-import { t as createMatrixClient } from "./create-client-CNakT7zF.js";
+import { d as backfillMatrixAuthDeviceIdAfterStartup, f as resolveMatrixAuth, i as resolveSharedMatrixClient, m as resolveMatrixConfigForAccount, n as releaseSharedClientInstance, o as stopSharedClientForAccount, p as resolveMatrixAuthContext, r as removeSharedClientInstance, s as stopSharedClientInstance, t as acquireSharedMatrixClient } from "./shared-DgvN5rBx.js";
+import { t as createMatrixClient } from "./create-client-D9z9RjCM.js";
 //#region extensions/matrix/src/matrix/client.ts
 var client_exports = /* @__PURE__ */ __exportAll({
 	acquireSharedMatrixClient: () => acquireSharedMatrixClient,

package/dist/{client-bootstrap-DjFJ7e0N.js → client-bootstrap-PqYOS-mO.js}

@@ -8,7 +8,7 @@ var client_bootstrap_exports = /* @__PURE__ */ __exportAll({
 	resolveRuntimeMatrixClientWithReadiness: () => resolveRuntimeMatrixClientWithReadiness,
 	withResolvedRuntimeMatrixClient: () => withResolvedRuntimeMatrixClient
 });
-const loadMatrixSharedClientRuntimeDeps = createLazyRuntimeModule(() => Promise.all([import("./client-tgnlQJk4.js").then((n) => n.t), import("./shared-DkFfq7mH.js").then((n) => n.a)]).then(([clientModule, sharedModule]) => ({
+const loadMatrixSharedClientRuntimeDeps = createLazyRuntimeModule(() => Promise.all([import("./client-DP0nmFxK.js").then((n) => n.t), import("./shared-DgvN5rBx.js").then((n) => n.a)]).then(([clientModule, sharedModule]) => ({
 	acquireSharedMatrixClient: clientModule.acquireSharedMatrixClient,
 	resolveMatrixAuthContext: clientModule.resolveMatrixAuthContext,
 	releaseSharedClientInstance: sharedModule.releaseSharedClientInstance