@openclaw/matrix 2026.8.1-beta.3 → 2026.8.1

package/dist/{account-config-BZWN9tGS.js → account-config-CRsKoMqJ.js}

@@ -1,5 +1,5 @@
 import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/account-id";
-import { hasConfiguredSecretInput } from "openclaw/plugin-sdk/secret-input-runtime";
+import { hasConfiguredSecretInput } from "openclaw/plugin-sdk/secret-input";
 import { listConfiguredAccountIds, resolveMergedAccountConfig, resolveNormalizedAccountEntry } from "openclaw/plugin-sdk/account-resolution-runtime";
 //#region extensions/matrix/src/matrix/account-config.ts
 function resolveMatrixBaseConfig(cfg) {

package/dist/{account-selection-CWuhuFn1.js → account-selection-C8nnBTxi.js}

@@ -30,6 +30,66 @@ function resolveMatrixAccountStringValues(params) {
 	return resolved;
 }
 //#endregion
+//#region extensions/matrix/src/matrix/client/env-auth.ts
+function cleanEnv(value) {
+	return normalizeOptionalString(value) ?? "";
+}
+function resolveGlobalMatrixEnvConfig(env) {
+	return {
+		homeserver: cleanEnv(env.MATRIX_HOMESERVER),
+		userId: cleanEnv(env.MATRIX_USER_ID),
+		accessToken: cleanEnv(env.MATRIX_ACCESS_TOKEN) || void 0,
+		password: cleanEnv(env.MATRIX_PASSWORD) || void 0,
+		deviceId: cleanEnv(env.MATRIX_DEVICE_ID) || void 0,
+		deviceName: cleanEnv(env.MATRIX_DEVICE_NAME) || void 0
+	};
+}
+function hasReadyMatrixEnvAuth(config) {
+	const homeserver = cleanEnv(config.homeserver);
+	const userId = cleanEnv(config.userId);
+	const accessToken = cleanEnv(config.accessToken);
+	const password = cleanEnv(config.password);
+	return Boolean(homeserver && (accessToken || userId && password));
+}
+function resolveScopedMatrixEnvConfig(accountId, env = process.env) {
+	const keys = getMatrixScopedEnvVarNames(accountId);
+	return {
+		homeserver: cleanEnv(env[keys.homeserver]),
+		userId: cleanEnv(env[keys.userId]),
+		accessToken: cleanEnv(env[keys.accessToken]) || void 0,
+		password: cleanEnv(env[keys.password]) || void 0,
+		deviceId: cleanEnv(env[keys.deviceId]) || void 0,
+		deviceName: cleanEnv(env[keys.deviceName]) || void 0
+	};
+}
+function resolveMatrixEnvAuthReadiness(accountId, env = process.env) {
+	const normalizedAccountId = normalizeAccountId(accountId);
+	const scoped = resolveScopedMatrixEnvConfig(normalizedAccountId, env);
+	const scopedReady = hasReadyMatrixEnvAuth(scoped);
+	if (normalizedAccountId !== DEFAULT_ACCOUNT_ID) {
+		const keys = getMatrixScopedEnvVarNames(normalizedAccountId);
+		return {
+			ready: scopedReady,
+			homeserver: scoped.homeserver || void 0,
+			userId: scoped.userId || void 0,
+			sourceHint: `${keys.homeserver} (+ auth vars)`,
+			missingMessage: `Set per-account env vars for "${normalizedAccountId}" (for example ${keys.homeserver} + ${keys.accessToken} or ${keys.userId} + ${keys.password}).`
+		};
+	}
+	const defaultScoped = resolveScopedMatrixEnvConfig(DEFAULT_ACCOUNT_ID, env);
+	const global = resolveGlobalMatrixEnvConfig(env);
+	const defaultScopedReady = hasReadyMatrixEnvAuth(defaultScoped);
+	const globalReady = hasReadyMatrixEnvAuth(global);
+	const defaultKeys = getMatrixScopedEnvVarNames(DEFAULT_ACCOUNT_ID);
+	return {
+		ready: defaultScopedReady || globalReady,
+		homeserver: defaultScoped.homeserver || global.homeserver || void 0,
+		userId: defaultScoped.userId || global.userId || void 0,
+		sourceHint: "MATRIX_* or MATRIX_DEFAULT_*",
+		missingMessage: `Set Matrix env vars for the default account (for example MATRIX_HOMESERVER + MATRIX_ACCESS_TOKEN, MATRIX_USER_ID + MATRIX_PASSWORD, or ${defaultKeys.homeserver} + ${defaultKeys.accessToken}).`
+	};
+}
+//#endregion
 //#region extensions/matrix/src/account-selection.ts
 function readConfiguredMatrixString(value) {
 	return normalizeOptionalString(value) ?? "";
@@ -48,30 +108,6 @@ function resolveMatrixChannelStringSources(entry) {
 		deviceName: readConfiguredMatrixString(entry.deviceName)
 	};
 }
-function readEnvMatrixString(env, key) {
-	return normalizeOptionalString(env[key]) ?? "";
-}
-function resolveScopedMatrixEnvStringSources(accountId, env) {
-	const keys = getMatrixScopedEnvVarNames(accountId);
-	return {
-		homeserver: readEnvMatrixString(env, keys.homeserver),
-		userId: readEnvMatrixString(env, keys.userId),
-		accessToken: readEnvMatrixString(env, keys.accessToken),
-		password: readEnvMatrixString(env, keys.password),
-		deviceId: readEnvMatrixString(env, keys.deviceId),
-		deviceName: readEnvMatrixString(env, keys.deviceName)
-	};
-}
-function resolveGlobalMatrixEnvStringSources(env) {
-	return {
-		homeserver: readEnvMatrixString(env, "MATRIX_HOMESERVER"),
-		userId: readEnvMatrixString(env, "MATRIX_USER_ID"),
-		accessToken: readEnvMatrixString(env, "MATRIX_ACCESS_TOKEN"),
-		password: readEnvMatrixString(env, "MATRIX_PASSWORD"),
-		deviceId: readEnvMatrixString(env, "MATRIX_DEVICE_ID"),
-		deviceName: readEnvMatrixString(env, "MATRIX_DEVICE_NAME")
-	};
-}
 function hasUsableResolvedMatrixAuth(values) {
 	return Boolean(values.homeserver && (values.accessToken || values.userId));
 }
@@ -82,9 +118,9 @@ function resolveEffectiveMatrixAccountSources(params) {
 	const normalizedAccountId = normalizeAccountId(params.accountId);
 	return resolveMatrixAccountStringValues({
 		accountId: normalizedAccountId,
-		scopedEnv: resolveScopedMatrixEnvStringSources(normalizedAccountId, params.env),
+		scopedEnv: resolveScopedMatrixEnvConfig(normalizedAccountId, params.env),
 		channel: resolveMatrixChannelStringSources(params.channel),
-		globalEnv: resolveGlobalMatrixEnvStringSources(params.env)
+		globalEnv: resolveGlobalMatrixEnvConfig(params.env)
 	});
 }
 function hasUsableEffectiveMatrixAccountSource(params) {
@@ -154,4 +190,4 @@ function requiresExplicitMatrixDefaultAccount(cfg, env = process.env) {
 	return !(configuredDefault && configuredAccountIds.includes(configuredDefault));
 }
 //#endregion
-export { resolveMatrixDefaultOrOnlyAccountId as a, resolveMatrixChannelConfig as i, requiresExplicitMatrixDefaultAccount as n, resolveMatrixAccountStringValues as o, resolveConfiguredMatrixAccountIds as r, findMatrixAccountEntry as t };
+export { resolveMatrixDefaultOrOnlyAccountId as a, resolveScopedMatrixEnvConfig as c, resolveMatrixChannelConfig as i, resolveMatrixAccountStringValues as l, requiresExplicitMatrixDefaultAccount as n, resolveGlobalMatrixEnvConfig as o, resolveConfiguredMatrixAccountIds as r, resolveMatrixEnvAuthReadiness as s, findMatrixAccountEntry as t };

package/dist/{accounts-BCzyubQt.js → accounts-fC57n-Jo.js}

@@ -1,10 +1,9 @@
-import { a as resolveMatrixDefaultOrOnlyAccountId, o as resolveMatrixAccountStringValues, r as resolveConfiguredMatrixAccountIds } from "./account-selection-CWuhuFn1.js";
-import { a as resolveMatrixAccountConfig, o as resolveMatrixBaseConfig, t as findMatrixAccountConfig } from "./account-config-BZWN9tGS.js";
-import { r as resolveScopedMatrixEnvConfig, t as resolveGlobalMatrixEnvConfig } from "./env-auth-MVS-Vv41.js";
+import { a as resolveMatrixDefaultOrOnlyAccountId, c as resolveScopedMatrixEnvConfig, l as resolveMatrixAccountStringValues, o as resolveGlobalMatrixEnvConfig, r as resolveConfiguredMatrixAccountIds } from "./account-selection-C8nnBTxi.js";
+import { a as resolveMatrixAccountConfig, o as resolveMatrixBaseConfig, t as findMatrixAccountConfig } from "./account-config-CRsKoMqJ.js";
 import { i as loadMatrixCredentials, n as credentialsMatchConfig } from "./credentials-read-B37cQknZ.js";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/account-id";
-import { hasConfiguredSecretInput } from "openclaw/plugin-sdk/secret-input-runtime";
+import { hasConfiguredSecretInput } from "openclaw/plugin-sdk/secret-input";
 //#region extensions/matrix/src/matrix/accounts.ts
 function clean(value) {
 	return normalizeOptionalString(value) ?? "";

package/dist/api.js

@@ -1,9 +1,9 @@
-import { a as resolveMatrixDefaultOrOnlyAccountId, i as resolveMatrixChannelConfig, n as requiresExplicitMatrixDefaultAccount, r as resolveConfiguredMatrixAccountIds, t as findMatrixAccountEntry } from "./account-selection-CWuhuFn1.js";
+import { a as resolveMatrixDefaultOrOnlyAccountId, i as resolveMatrixChannelConfig, n as requiresExplicitMatrixDefaultAccount, r as resolveConfiguredMatrixAccountIds, t as findMatrixAccountEntry } from "./account-selection-C8nnBTxi.js";
 import { n as listMatrixEnvAccountIds, r as resolveMatrixEnvAccountToken, t as getMatrixScopedEnvVarNames } from "./env-vars-dGqak9dN.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 { t as matrixPlugin } from "./channel-CzQw5OZN.js";
-import { n as matrixSetupAdapter, t as createMatrixSetupWizardProxy } from "./setup-core-DigrLebY.js";
+import { t as matrixPlugin } from "./channel-BkEcVUs_.js";
+import { n as matrixSetupAdapter, t as createMatrixSetupWizardProxy } from "./setup-core-r6L0nno-.js";
 import { f as setMatrixThreadBindingMaxAgeBySessionKey, n as getMatrixThreadBindingManager, u as setMatrixThreadBindingIdleTimeoutBySessionKey } from "./thread-bindings-shared-oNPiyMWY.js";
-import { n as matrixOnboardingAdapter } from "./setup-surface-Dtn8sAWs.js";
-import { t as createMatrixThreadBindingManager } from "./thread-bindings-BYEGfw3h.js";
+import { n as matrixOnboardingAdapter } from "./setup-surface-g174ElFO.js";
+import { t as createMatrixThreadBindingManager } from "./thread-bindings-ERWNousC.js";
 export { createMatrixSetupWizardProxy, createMatrixThreadBindingManager, findMatrixAccountEntry, getMatrixScopedEnvVarNames, getMatrixThreadBindingManager, hashMatrixAccessToken, listMatrixEnvAccountIds, matrixOnboardingAdapter, matrixOnboardingAdapter as matrixSetupWizard, matrixPlugin, matrixSetupAdapter, requiresExplicitMatrixDefaultAccount, resolveConfiguredMatrixAccountIds, resolveMatrixAccountStorageRoot, resolveMatrixChannelConfig, resolveMatrixCredentialsDir, resolveMatrixCredentialsFilename, resolveMatrixCredentialsPath, resolveMatrixDefaultOrOnlyAccountId, resolveMatrixEnvAccountToken, resolveMatrixHomeserverKey, sanitizeMatrixPathSegment, setMatrixThreadBindingIdleTimeoutBySessionKey, setMatrixThreadBindingMaxAgeBySessionKey };

package/dist/{approval-handler.runtime-CSvueU9P.js → approval-handler.runtime-BBjFZw1t.js}

@@ -1,9 +1,9 @@
-import { i as resolveMatrixAccount } from "./accounts-BCzyubQt.js";
-import { C as shouldHandleMatrixApprovalRequest, S as isMatrixAnyApprovalClientEnabled } from "./channel-CzQw5OZN.js";
+import { i as resolveMatrixAccount } from "./accounts-fC57n-Jo.js";
+import { C as shouldHandleMatrixApprovalRequest, S as isMatrixAnyApprovalClientEnabled } from "./channel-BkEcVUs_.js";
 import { o as resolveMatrixTargetIdentity } from "./target-ids-Nwx7cMVE.js";
-import { a as sendSingleTextMessageMatrix, n as reactMatrixMessage, r as sendMessageMatrix, w as repairMatrixDirectRooms } from "./send-ClHgDZLT.js";
+import { C as repairMatrixDirectRooms, a as sendSingleTextMessageMatrix, n as reactMatrixMessage, r as sendMessageMatrix } from "./send-BL_iH5Ox.js";
 import { a as unregisterMatrixApprovalReactionTarget, n as listMatrixApprovalReactionBindings, r as registerMatrixApprovalReactionTarget, t as buildMatrixApprovalReactionHint } from "./approval-reactions-tXh9KYrW.js";
-import { n as editMatrixMessage, t as deleteMatrixMessage } from "./messages-DEqg7HVy.js";
+import { n as editMatrixMessage, t as deleteMatrixMessage } from "./messages-DaGRt-tu.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";
@@ -136,7 +136,8 @@ function buildPendingApprovalContent(params) {
 				severity: params.view.severity,
 				toolName: params.view.toolName ?? void 0,
 				pluginId: params.view.pluginId ?? void 0,
-				agentId: params.view.agentId ?? void 0
+				agentId: params.view.agentId ?? void 0,
+				scope: params.view.scope ?? void 0
 			},
 			createdAtMs: 0,
 			expiresAtMs: params.view.expiresAtMs
@@ -154,6 +155,7 @@ function buildPendingApprovalContent(params) {
 		cwd: params.view.cwd ?? void 0,
 		host: params.view.host === "node" ? "node" : "gateway",
 		nodeId: params.view.nodeId ?? void 0,
+		scope: params.view.scope ?? void 0,
 		sessionKey: params.view.sessionKey ?? void 0,
 		expiresAtMs: params.view.expiresAtMs,
 		nowMs: params.nowMs

package/dist/{approval-ids-CEcf-EiM.js → approval-ids-DTIdXV-m.js}

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

package/dist/{approval-reaction-auth-CziKXatm.js → approval-reaction-auth-BDONXxnF.js}

@@ -1,5 +1,5 @@
-import { i as resolveMatrixAccount } from "./accounts-BCzyubQt.js";
-import { t as normalizeMatrixApproverId } from "./approval-ids-CEcf-EiM.js";
+import { i as resolveMatrixAccount } from "./accounts-fC57n-Jo.js";
+import { t as normalizeMatrixApproverId } from "./approval-ids-DTIdXV-m.js";
 import { resolveApprovalApprovers } from "openclaw/plugin-sdk/approval-auth-runtime";
 //#region extensions/matrix/src/approval-reaction-auth.ts
 function normalizeMatrixExecApproverId(value) {

package/dist/{channel-CzQw5OZN.js → channel-BkEcVUs_.js}

@@ -1,8 +1,8 @@
-import { n as requiresExplicitMatrixDefaultAccount } from "./account-selection-CWuhuFn1.js";
-import { a as resolveMatrixAccountConfig } from "./account-config-BZWN9tGS.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-aNaa3Uyn.js";
-import { t as normalizeMatrixApproverId } from "./approval-ids-CEcf-EiM.js";
+import { n as requiresExplicitMatrixDefaultAccount } from "./account-selection-C8nnBTxi.js";
+import { a as resolveMatrixAccountConfig } from "./account-config-CRsKoMqJ.js";
+import { i as resolveMatrixAccount, r as resolveDefaultMatrixAccountId, t as listMatrixAccountIds } from "./accounts-fC57n-Jo.js";
+import { a as normalizeMatrixUserId, r as DEFAULT_ACCOUNT_ID$2, t as matrixPluginBase } from "./channel.setup-CSacbORr.js";
+import { t as normalizeMatrixApproverId } from "./approval-ids-DTIdXV-m.js";
 import { a as resolveMatrixDirectUserId, i as normalizeMatrixResolvableTarget, n as isMatrixRoomId, o as resolveMatrixTargetIdentity, r as normalizeMatrixMessagingTarget, t as isMatrixQualifiedUserId } from "./target-ids-Nwx7cMVE.js";
 import { n as normalizeCompatibilityConfig, t as legacyConfigRules } from "./doctor-contract-DEt4O4Zt.js";
 import { n as MATRIX_REACTION_EVENT_TYPE } from "./reaction-common-DkrQdBSZ.js";
@@ -45,6 +45,7 @@ const MATRIX_PLUGIN_HANDLED_ACTIONS = /* @__PURE__ */ new Set([
 	"poll-vote",
 	"react",
 	"reactions",
+	"emoji-list",
 	"read",
 	"edit",
 	"delete",
@@ -74,6 +75,7 @@ function createMatrixExposedActions(params) {
 	if (params.gate("reactions")) {
 		actions.add("react");
 		actions.add("reactions");
+		actions.add("emoji-list");
 	}
 	if (params.gate("pins")) {
 		actions.add("pin");
@@ -121,10 +123,16 @@ const matrixMessageActions = {
 			senderIsOwner
 		});
 		const listedActions = Array.from(actions);
+		const schema = [];
+		if (actions.has("set-profile")) schema.push(buildMatrixProfileToolSchema());
+		if (actions.has("react")) schema.push({
+			actions: ["react", "reactions"],
+			properties: { emoji: Type.Optional(Type.String({ description: `Unicode emoji or custom emote shortcode.${actions.has("emoji-list") ? " Discover room and personal custom emotes with action:\"emoji-list\"." : ""}` })) }
+		});
 		return {
 			actions: listedActions,
 			capabilities: ["presentation"],
-			schema: listedActions.includes("set-profile") ? buildMatrixProfileToolSchema() : null,
+			schema: schema.length > 1 ? schema : schema[0] ?? null,
 			mediaSourceParams: listedActions.includes("set-profile") ? { "set-profile": MATRIX_PROFILE_MEDIA_SOURCE_PARAMS } : null
 		};
 	},
@@ -141,7 +149,7 @@ const matrixMessageActions = {
 		return account && createActionGate(account.config.actions)("messages") ? payload : null;
 	},
 	handleAction: async (ctx) => {
-		const { handleMatrixAction } = await import("./tool-actions.runtime-ck6IJyP0.js");
+		const { handleMatrixAction } = await import("./tool-actions.runtime-DcBCSwY4.js");
 		const { action, params, cfg, accountId, mediaLocalRoots } = ctx;
 		const dispatch = async (actionParams) => await handleMatrixAction({
 			...actionParams,
@@ -206,6 +214,15 @@ const matrixMessageActions = {
 				limit
 			});
 		}
+		if (action === "emoji-list") {
+			const roomId = readStringParam(params, "roomId") ?? readStringParam(params, "channelId") ?? readStringParam(params, "to") ?? (ctx.toolContext?.currentChannelProvider === "matrix" ? ctx.toolContext.currentChannelId : void 0);
+			if (!roomId) throw new Error("Matrix emoji-list requires a roomId or current Matrix conversation.");
+			return await dispatch({
+				action: "emoji-list",
+				roomId,
+				limit: readPositiveIntegerParam(params, "limit", { message: "limit must be a positive integer." })
+			});
+		}
 		if (action === "read") {
 			const limit = readPositiveIntegerParam(params, "limit", { message: "limit must be a positive integer." });
 			return await dispatch({
@@ -609,7 +626,7 @@ const matrixNativeApprovalCapability = createApproverRestrictedNativeApprovalCap
 			approvalKind,
 			request
 		}),
-		load: async () => (await import("./approval-handler.runtime-CSvueU9P.js")).matrixApprovalNativeRuntime
+		load: async () => (await import("./approval-handler.runtime-BBjFZw1t.js")).matrixApprovalNativeRuntime
 	})
 });
 const splitMatrixApprovalCapability = splitChannelApprovalCapability(matrixNativeApprovalCapability);
@@ -1022,7 +1039,7 @@ function resolveMatrixConversationRouteOwner(params) {
 }
 //#endregion
 //#region extensions/matrix/src/resolver.ts
-const loadMatrixChannelRuntime$1 = createLazyRuntimeNamedExport(() => import("./resolver.runtime-V8u0pHEb.js"), "matrixResolverRuntime");
+const loadMatrixChannelRuntime$1 = createLazyRuntimeNamedExport(() => import("./resolver.runtime-zX3TR3TN.js"), "matrixResolverRuntime");
 const matrixResolverAdapter = { resolveTargets: async ({ cfg, accountId, inputs, kind, runtime }) => (await loadMatrixChannelRuntime$1()).resolveMatrixTargets({
 	cfg,
 	accountId,
@@ -1149,7 +1166,7 @@ function resolveMatrixOutboundSessionRoute(params) {
 //#endregion
 //#region extensions/matrix/src/channel.ts
 let matrixStartupLock = Promise.resolve();
-const loadMatrixChannelRuntime = createLazyRuntimeNamedExport(() => import("./channel.runtime-I9pBRQb3.js"), "matrixChannelRuntime");
+const loadMatrixChannelRuntime = createLazyRuntimeNamedExport(() => import("./channel.runtime-CTLSBFsP.js"), "matrixChannelRuntime");
 const loadMatrixDoctorModule = createLazyRuntimeModule(() => import("./doctor-EWf9CDso.js"));
 function buildMatrixTrafficStatusSummary(snapshot) {
 	return {
@@ -1500,7 +1517,7 @@ const matrixPlugin = createChatChannelPlugin({
 			await previousLock;
 			let monitorMatrixProvider;
 			try {
-				monitorMatrixProvider = (await import("./monitor-FNrfkuWL.js")).monitorMatrixProvider;
+				monitorMatrixProvider = (await import("./monitor-CLPbPcR9.js")).monitorMatrixProvider;
 			} finally {
 				releaseLock();
 			}

package/dist/channel-plugin-api.js

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

package/dist/{channel.runtime-I9pBRQb3.js → channel.runtime-CTLSBFsP.js}

@@ -1,19 +1,19 @@
-import { b as reconcileMatrixUnknownSend, i as sendPollMatrix, o as sendTypingMatrix, r as sendMessageMatrix, y as cleanupMatrixDeliveryPlans } from "./send-ClHgDZLT.js";
+import { i as sendPollMatrix, o as sendTypingMatrix, r as sendMessageMatrix, v as cleanupMatrixDeliveryPlans, y as reconcileMatrixUnknownSend } from "./send-BL_iH5Ox.js";
 import { t as isBunRuntime } from "./runtime-BefyhPWv.js";
-import { c as resolveMatrixAuth } from "./client-BBQdBG7t.js";
-import { n as listMatrixDirectoryGroupsLive, r as listMatrixDirectoryPeersLive } from "./directory-live-DLQzel12.js";
-import { p as resolveOutboundSendDep, r as chunkTextForOutbound } from "./runtime-api-BGO16Fu8.js";
-import { t as resolveMatrixTargets } from "./resolve-targets-e7AI0P75.js";
+import { c as resolveMatrixAuth } from "./client-kSi51NKp.js";
+import { n as listMatrixDirectoryGroupsLive, r as listMatrixDirectoryPeersLive } from "./directory-live-DKr0w35b.js";
+import { t as resolveMatrixTargets } from "./resolve-targets-qG6gceps.js";
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
-import { createMessageReceiptFromOutboundResults, createReplyToFanout } from "openclaw/plugin-sdk/channel-outbound";
+import { createMessageReceiptFromOutboundResults, createReplyToFanout, resolveOutboundSendDep } from "openclaw/plugin-sdk/channel-outbound";
 import { asOptionalRecord, normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
+import { chunkTextForOutbound } from "openclaw/plugin-sdk/text-chunking";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { runChannelProbe } from "openclaw/plugin-sdk/text-utility-runtime";
 import { attachChannelToResult } from "openclaw/plugin-sdk/channel-send-result";
 import { renderMessagePresentationFallbackText } from "openclaw/plugin-sdk/interactive-runtime";
 import { resolveSendableOutboundReplyParts, sendPayloadMediaSequence } from "openclaw/plugin-sdk/reply-payload";
 //#region extensions/matrix/src/matrix/probe.ts
-const loadMatrixProbeRuntimeDeps = createLazyRuntimeModule(() => import("./probe.runtime-NIJZYqc2.js").then((runtimeModule) => ({ createMatrixClient: runtimeModule.createMatrixClient })));
+const loadMatrixProbeRuntimeDeps = createLazyRuntimeModule(() => import("./probe.runtime-Bxpr1FFy.js").then((runtimeModule) => ({ createMatrixClient: runtimeModule.createMatrixClient })));
 async function probeMatrix(params) {
 	return await runChannelProbe(void 0, async () => {
 		const result = {

package/dist/{channel.setup-aNaa3Uyn.js → channel.setup-CSacbORr.js}

@@ -1,6 +1,6 @@
-import { a as resolveMatrixAccountConfig } from "./account-config-BZWN9tGS.js";
-import { i as resolveMatrixAccount, r as resolveDefaultMatrixAccountId, t as listMatrixAccountIds } from "./accounts-BCzyubQt.js";
-import { r as matrixSetupContract, t as createMatrixSetupWizardProxy } from "./setup-core-DigrLebY.js";
+import { a as resolveMatrixAccountConfig } from "./account-config-CRsKoMqJ.js";
+import { i as resolveMatrixAccount, r as resolveDefaultMatrixAccountId, t as listMatrixAccountIds } from "./accounts-fC57n-Jo.js";
+import { r as matrixSetupContract, t as createMatrixSetupWizardProxy } from "./setup-core-r6L0nno-.js";
 import { adaptScopedAccountAccessor, createScopedChannelConfigAdapter } from "openclaw/plugin-sdk/channel-config-helpers";
 import { createChannelConfigUiHints } from "openclaw/plugin-sdk/channel-core";
 import { normalizeLowercaseStringOrEmpty } from "openclaw/plugin-sdk/string-coerce-runtime";
@@ -98,6 +98,10 @@ const matrixConfigAdapter = createScopedChannelConfigAdapter({
 //#endregion
 //#region extensions/matrix/src/config-ui-hints.ts
 const matrixChannelConfigUiHints = {
+	joinIntro: {
+		label: "Matrix Group Join Introduction",
+		help: "Post one brief introduction when the bot joins an allowed group room (default: true). Account settings override the channel-wide setting."
+	},
 	...createChannelConfigUiHints({
 		channelLabel: "Matrix",
 		mentionPatterns: {
@@ -225,8 +229,9 @@ const MatrixChannelConfigSchema = buildChannelConfigSchema(z.object({
 	name: z.string().optional(),
 	enabled: z.boolean().optional(),
 	configWrites: z.boolean().optional(),
+	joinIntro: z.boolean().optional(),
 	defaultAccount: z.string().optional(),
-	accounts: z.record(z.string(), z.unknown().refine(hasCanonicalMatrixAccountStreaming, { message: "flat or scalar streaming values are no longer supported; use streaming.* and run \"openclaw doctor --fix\"" })).optional(),
+	accounts: z.record(z.string(), z.object({ joinIntro: z.boolean().optional() }).passthrough().refine(hasCanonicalMatrixAccountStreaming, { message: "flat or scalar streaming values are no longer supported; use streaming.* and run \"openclaw doctor --fix\"" })).optional(),
 	markdown: MarkdownConfigSchema,
 	homeserver: z.string().optional(),
 	network: matrixNetworkSchema,
@@ -307,7 +312,7 @@ const matrixPluginBase = {
 		order: 70,
 		quickstartAllowFrom: true
 	},
-	setupWizard: createMatrixSetupWizardProxy(async () => ({ matrixSetupWizard: (await import("./setup-surface-Dtn8sAWs.js").then((n) => n.t)).matrixSetupWizard })),
+	setupWizard: createMatrixSetupWizardProxy(async () => ({ matrixSetupWizard: (await import("./setup-surface-g174ElFO.js").then((n) => n.t)).matrixSetupWizard })),
 	setupContract: matrixSetupContract,
 	capabilities: {
 		chatTypes: [

package/dist/{cli-iR6QJ5U0.js → cli-DRVtgrq5.js}

@@ -1,20 +1,20 @@
-import { a as resolveMatrixAccountConfig } from "./account-config-BZWN9tGS.js";
+import { a as resolveMatrixAccountConfig } from "./account-config-CRsKoMqJ.js";
 import { t as getMatrixRuntime } from "./runtime-6S3DNFNv.js";
-import { i as resolveMatrixAccount } from "./accounts-BCzyubQt.js";
-import { n as resolveMatrixConfigPath, r as updateMatrixAccountConfig } from "./config-update-Bor_Pjsv.js";
-import { n as matrixSetupAdapter } from "./setup-core-DigrLebY.js";
-import { n as withResolvedActionClient } from "./client-D8XghqmX.js";
-import { l as resolveMatrixAuthContext } from "./client-BBQdBG7t.js";
-import { a as formatZonedTimestamp } from "./runtime-api-BGO16Fu8.js";
+import { i as resolveMatrixAccount } from "./accounts-fC57n-Jo.js";
+import { n as resolveMatrixConfigPath, r as updateMatrixAccountConfig } from "./config-update-DC0fWBxc.js";
+import { n as matrixSetupAdapter } from "./setup-core-r6L0nno-.js";
+import { n as withResolvedActionClient } from "./client-CZ_JvrO0.js";
+import { l as resolveMatrixAuthContext } from "./client-kSi51NKp.js";
 import { t as resolveMatrixRoomKeyBackupIssue } from "./backup-health-Dm_YMVFT.js";
 import { i as setMatrixSdkLogMode, r as setMatrixSdkConsoleLogging } from "./logging-DRjvUOIh.js";
 import { n as isOpenClawManagedMatrixDevice, r as summarizeMatrixDeviceHealth } from "./device-health-B4-YXtJR.js";
-import { n as updateMatrixOwnProfile, t as applyMatrixProfileUpdate } from "./profile-update-BQlE5s2J.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-CabtBTtB.js";
+import { n as updateMatrixOwnProfile, t as applyMatrixProfileUpdate } from "./profile-update-zXVCMg7y.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-4vsW_WSn.js";
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 import { normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { parseStrictInteger, timestampMsToIsoString } from "openclaw/plugin-sdk/number-runtime";
+import { formatZonedTimestamp } from "openclaw/plugin-sdk/time-runtime";
 import { readByteStreamWithLimit } from "openclaw/plugin-sdk/response-limit-runtime";
 //#region extensions/matrix/src/cli-shared.ts
 let matrixCliExitScheduled = false;
@@ -328,16 +328,17 @@ function printVerificationStatus(status, verbose = false, accountId) {
 	const backupIssue = resolveMatrixRoomKeyBackupIssue(resolveBackupStatus(status));
 	printVerificationBackupSummary(status);
 	if (backupIssue.message) console.log(`Backup issue: ${backupIssue.message}`);
+	console.log(`Recovery key stored: ${status.recoveryKeyStored ? "yes" : "no"}`);
+	if (status.recoveryKey) console.log("Recovery key: available (re-run with --json to include the raw key value in output)");
 	if (verbose) {
 		console.log("Diagnostics:");
 		printVerificationIdentity(status);
 		if (status.serverDeviceKnown !== void 0) console.log(`Device present on server: ${yesNoUnknown(status.serverDeviceKnown ?? null)}`);
 		printVerificationTrustDiagnostics(status);
 		printVerificationBackupStatus(status);
-		console.log(`Recovery key stored: ${status.recoveryKeyStored ? "yes" : "no"}`);
 		printTimestamp("Recovery key created at", status.recoveryKeyCreatedAt);
 		console.log(`Pending verifications: ${status.pendingVerifications}`);
-	} else console.log(`Recovery key stored: ${status.recoveryKeyStored ? "yes" : "no"}`);
+	}
 	printVerificationGuidance(status, accountId);
 }
 //#endregion
@@ -412,7 +413,7 @@ async function addMatrixAccount(params) {
 		backupVersion: null
 	};
 	if (accountConfig.encryption === true) {
-		const { maybeBootstrapNewEncryptedMatrixAccount } = await import("./setup-bootstrap-BGPjbA5N.js");
+		const { maybeBootstrapNewEncryptedMatrixAccount } = await import("./setup-bootstrap-D8M7FmcO.js");
 		verificationBootstrap = await maybeBootstrapNewEncryptedMatrixAccount({
 			previousCfg: cfg,
 			cfg: updated,
@@ -595,8 +596,8 @@ function registerMatrixDeviceCommands(root) {
 }
 //#endregion
 //#region extensions/matrix/src/cli-direct.ts
-const loadMatrixActionClientModule = createLazyRuntimeModule(() => import("./client-D8XghqmX.js").then((n) => n.t));
-const loadMatrixDirectManagementModule = createLazyRuntimeModule(() => import("./send-ClHgDZLT.js").then((n) => n.S));
+const loadMatrixActionClientModule = createLazyRuntimeModule(() => import("./client-CZ_JvrO0.js").then((n) => n.t));
+const loadMatrixDirectManagementModule = createLazyRuntimeModule(() => import("./send-BL_iH5Ox.js").then((n) => n.x));
 function printDirectRoomCandidate(room) {
 	const members = room.joinedMembers === null ? "unavailable" : room.joinedMembers.map((member) => formatMatrixCliText(member)).join(", ") || "none";
 	console.log(`- ${formatMatrixCliText(room.roomId)} [${room.source}] strict=${room.strict ? "yes" : "no"} joined=${members}`);

package/dist/{cli-metadata-BmUYWjuM.js → cli-metadata-Ddx_y4Os.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-iR6QJ5U0.js");
+		const { registerMatrixCli } = await import("./cli-DRVtgrq5.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-BmUYWjuM.js";
+import { n as registerMatrixCliMetadata, t as cli_metadata_default } from "./cli-metadata-Ddx_y4Os.js";
 export { cli_metadata_default as default, registerMatrixCliMetadata };

package/dist/{client-D8XghqmX.js → client-CZ_JvrO0.js}

@@ -1,6 +1,6 @@
 import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
-import { x as resolveMatrixRoomId } from "./send-ClHgDZLT.js";
-import { n as withResolvedRuntimeMatrixClient } from "./client-bootstrap-Co3RlItb.js";
+import { b as resolveMatrixRoomId } from "./send-BL_iH5Ox.js";
+import { n as withResolvedRuntimeMatrixClient } from "./client-bootstrap-D8irSL2i.js";
 //#region extensions/matrix/src/matrix/actions/client.ts
 var client_exports = /* @__PURE__ */ __exportAll({
 	withResolvedActionClient: () => withResolvedActionClient,

package/dist/{client-bootstrap-Co3RlItb.js → client-bootstrap-D8irSL2i.js}

@@ -7,7 +7,7 @@ var client_bootstrap_exports = /* @__PURE__ */ __exportAll({
 	resolveRuntimeMatrixClientWithReadiness: () => resolveRuntimeMatrixClientWithReadiness,
 	withResolvedRuntimeMatrixClient: () => withResolvedRuntimeMatrixClient
 });
-const loadMatrixSharedClientRuntimeDeps = createLazyRuntimeModule(() => import("./client-BBQdBG7t.js").then((n) => n.t).then((clientModule) => ({
+const loadMatrixSharedClientRuntimeDeps = createLazyRuntimeModule(() => import("./client-kSi51NKp.js").then((n) => n.t).then((clientModule) => ({
 	acquireSharedMatrixClient: clientModule.acquireSharedMatrixClient,
 	resolveMatrixAuthContext: clientModule.resolveMatrixAuthContext
 })));