@openclaw/matrix 2026.5.16-beta.4 → 2026.5.16-beta.5

package/dist/api.js

@@ -3,7 +3,7 @@ import { a as resolveMatrixDefaultOrOnlyAccountId, i as resolveMatrixChannelConf
 import { n as listMatrixEnvAccountIds, r as resolveMatrixEnvAccountToken, t as getMatrixScopedEnvVarNames } from "./env-vars-C7uQCTKn.js";
 import { a as resolveMatrixCredentialsPath, c as resolveMatrixLegacyFlatStoreRoot, i as resolveMatrixCredentialsFilename, l as sanitizeMatrixPathSegment, n as resolveMatrixAccountStorageRoot, o as resolveMatrixHomeserverKey, r as resolveMatrixCredentialsDir, s as resolveMatrixLegacyFlatStoragePaths, t as hashMatrixAccessToken } from "./storage-paths-BJLdnCjV.js";
 import { n as matrixSetupAdapter, t as createMatrixSetupWizardProxy } from "./setup-core-CnUlkNmz.js";
-import { t as matrixPlugin } from "./channel-dMBvPDsp.js";
+import { t as matrixPlugin } from "./channel-ClUVS-7H.js";
 import { n as matrixOnboardingAdapter } from "./setup-surface-BdT1ex7Z.js";
 import { t as createMatrixThreadBindingManager } from "./thread-bindings-CK8lw9qa.js";
 //#region extensions/matrix/api.ts

package/dist/{approval-handler.runtime-Dcj6JaB_.js → approval-handler.runtime-BsELVBtu.js}

@@ -1,6 +1,6 @@
 import { a as resolveMatrixTargetIdentity } from "./target-ids-80nQ2gql.js";
 import { g as resolveMatrixAccount } from "./setup-core-CnUlkNmz.js";
-import { _ as shouldHandleMatrixApprovalRequest, g as isMatrixAnyApprovalClientEnabled } from "./channel-dMBvPDsp.js";
+import { _ as shouldHandleMatrixApprovalRequest, g as isMatrixAnyApprovalClientEnabled } from "./channel-ClUVS-7H.js";
 import { a as sendMessageMatrix, i as reactMatrixMessage, p as repairMatrixDirectRooms, s as sendSingleTextMessageMatrix } from "./send-EorDXlGl.js";
 import { a as unregisterMatrixApprovalReactionTarget, n as listMatrixApprovalReactionBindings, r as registerMatrixApprovalReactionTarget, t as buildMatrixApprovalReactionHint } from "./approval-reactions-Cwd1PMCC.js";
 import { n as editMatrixMessage, t as deleteMatrixMessage } from "./messages-mMLZ7DIz.js";

package/dist/{approval-ids-wB4z5Pen.js → approval-ids-BG6ZMpPU.js}

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

package/dist/{approval-reaction-auth-WbN5AstS.js → approval-reaction-auth-BTy3BiII.js}

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

package/dist/{channel-dMBvPDsp.js → channel-ClUVS-7H.js}

@@ -3,8 +3,8 @@ import { d as setMatrixThreadBindingIdleTimeoutBySessionKey, p as setMatrixThrea
 import { n as requiresExplicitMatrixDefaultAccount } from "./account-selection-BWwIruri.js";
 import { c as resolveMatrixAccountConfig } from "./config-paths-msaDGRh6.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-CnUlkNmz.js";
-import { a as normalizeMatrixUserId, n as DEFAULT_ACCOUNT_ID$2, r as matrixConfigAdapter, t as MatrixChannelConfigSchema } from "./config-schema-DpROObD_.js";
-import { t as normalizeMatrixApproverId } from "./approval-ids-wB4z5Pen.js";
+import { a as normalizeMatrixUserId, n as DEFAULT_ACCOUNT_ID$2, r as matrixConfigAdapter, t as MatrixChannelConfigSchema } from "./config-schema-B1OTtJSg.js";
+import { t as normalizeMatrixApproverId } from "./approval-ids-BG6ZMpPU.js";
 import { t as formatMatrixErrorMessage } from "./errors-BpHgvm2o.js";
 import { n as normalizeCompatibilityConfig, t as legacyConfigRules } from "./doctor-contract-s4gUPmRN.js";
 import { n as collectRuntimeConfigAssignments, r as secretTargetRegistryEntries } from "./secret-contract-e4SdhUtT.js";
@@ -596,7 +596,7 @@ const matrixNativeApprovalCapability = createApproverRestrictedNativeApprovalCap
 			accountId,
 			request
 		}),
-		load: async () => (await import("./approval-handler.runtime-Dcj6JaB_.js")).matrixApprovalNativeRuntime
+		load: async () => (await import("./approval-handler.runtime-BsELVBtu.js")).matrixApprovalNativeRuntime
 	})
 });
 const splitMatrixApprovalCapability = splitChannelApprovalCapability(matrixNativeApprovalCapability);
@@ -948,7 +948,7 @@ async function runMatrixStartupMaintenance(params) {
 //#region extensions/matrix/src/channel.ts
 let matrixStartupLock = Promise.resolve();
 const loadMatrixSetupWizard = createLazyRuntimeNamedExport(() => import("./setup-surface-BdT1ex7Z.js").then((n) => n.t), "matrixSetupWizard");
-const loadMatrixChannelRuntime = createLazyRuntimeNamedExport(() => import("./channel.runtime-CTUadFsd.js"), "matrixChannelRuntime");
+const loadMatrixChannelRuntime = createLazyRuntimeNamedExport(() => import("./channel.runtime-B1QurRaj.js"), "matrixChannelRuntime");
 const meta = {
 	id: "matrix",
 	label: "Matrix",
@@ -1111,7 +1111,11 @@ const matrixChannelOutbound = {
 		buttons: true,
 		selects: true,
 		context: true,
-		divider: true
+		divider: true,
+		limits: { text: {
+			markdownDialect: "markdown",
+			supportsEdit: true
+		} }
 	},
 	shouldSuppressLocalPayloadPrompt: ({ cfg, accountId, payload }) => shouldSuppressLocalMatrixExecApprovalPrompt({
 		cfg,
@@ -1314,7 +1318,7 @@ const matrixPlugin = createChatChannelPlugin({
 			await previousLock;
 			let monitorMatrixProvider;
 			try {
-				monitorMatrixProvider = (await import("./monitor-DrLsF0eK.js")).monitorMatrixProvider;
+				monitorMatrixProvider = (await import("./monitor-4YYdKe_C.js")).monitorMatrixProvider;
 			} finally {
 				releaseLock();
 			}

package/dist/channel-plugin-api.js

@@ -1,2 +1,2 @@
-import { t as matrixPlugin } from "./channel-dMBvPDsp.js";
+import { t as matrixPlugin } from "./channel-ClUVS-7H.js";
 export { matrixPlugin };

package/dist/{channel.runtime-CTUadFsd.js → channel.runtime-B1QurRaj.js}

@@ -134,7 +134,11 @@ const matrixChannelRuntime = {
 			buttons: true,
 			selects: true,
 			context: true,
-			divider: true
+			divider: true,
+			limits: { text: {
+				markdownDialect: "markdown",
+				supportsEdit: true
+			} }
 		},
 		renderPresentation: ({ payload, presentation }) => renderMatrixPresentationPayload({
 			payload,

package/dist/{config-schema-DpROObD_.js → config-schema-B1OTtJSg.js}

@@ -142,6 +142,10 @@ const matrixChannelConfigUiHints = {
 		label: "Matrix Progress Max Lines",
 		help: "Maximum number of compact progress lines to keep below the draft label (default: 8)."
 	},
+	"streaming.progress.maxLineChars": {
+		label: "Matrix Progress Max Line Chars",
+		help: "Maximum characters per compact progress line before truncation (default: 120). Prose cuts at word boundaries; commands and paths keep useful suffixes."
+	},
 	"streaming.progress.toolProgress": {
 		label: "Matrix Progress Tool Lines",
 		help: "Show compact tool/progress lines in progress draft mode (default: true). Set false to keep only the label until final delivery."
@@ -212,6 +216,7 @@ const matrixStreamingSchema = z.object({
 		label: z.union([z.string(), z.literal(false)]).optional(),
 		labels: z.array(z.string()).optional(),
 		maxLines: z.number().int().positive().optional(),
+		maxLineChars: z.number().int().positive().optional(),
 		toolProgress: z.boolean().optional()
 	}).strict().optional(),
 	preview: z.object({ toolProgress: z.boolean().optional() }).strict().optional()

package/dist/{monitor-DrLsF0eK.js → monitor-4YYdKe_C.js}

@@ -2,8 +2,8 @@ import { t as isMatrixQualifiedUserId } from "./target-ids-80nQ2gql.js";
 import { c as resolveMatrixAccountConfig, s as resolveMatrixAccountAllowlistConfig } from "./config-paths-msaDGRh6.js";
 import { t as getMatrixRuntime } from "./runtime-Dog86njy.js";
 import { m as resolveConfiguredMatrixBotUserIds } from "./setup-core-CnUlkNmz.js";
-import { a as buildAllowlistResolutionSummary, c as createTypingCallbacks, d as logInboundDrop, f as logTypingFailure, h as toLocationContext, i as addAllowlistUserEntriesFromConfigEntry, l as formatLocationText, m as summarizeMapping, n as resolveMatrixStoredSessionMeta, o as canonicalizeAllowlistWithResolvedIds, p as patchAllowlistUsersInConfigEntries, r as resolveMatrixRoomConfig, s as createReplyPrefixOptions, u as getAgentScopedMediaLocalRoots } from "./channel-dMBvPDsp.js";
-import { a as normalizeMatrixUserId, i as normalizeMatrixAllowList, o as resolveMatrixAllowListMatch } from "./config-schema-DpROObD_.js";
+import { a as buildAllowlistResolutionSummary, c as createTypingCallbacks, d as logInboundDrop, f as logTypingFailure, h as toLocationContext, i as addAllowlistUserEntriesFromConfigEntry, l as formatLocationText, m as summarizeMapping, n as resolveMatrixStoredSessionMeta, o as canonicalizeAllowlistWithResolvedIds, p as patchAllowlistUsersInConfigEntries, r as resolveMatrixRoomConfig, s as createReplyPrefixOptions, u as getAgentScopedMediaLocalRoots } from "./channel-ClUVS-7H.js";
+import { a as normalizeMatrixUserId, i as normalizeMatrixAllowList, o as resolveMatrixAllowListMatch } from "./config-schema-B1OTtJSg.js";
 import { r as isMatrixNotFoundError, t as formatMatrixErrorMessage } from "./errors-BpHgvm2o.js";
 import { i as resolveMatrixStateFilePath } from "./storage-HI1nL3im.js";
 import { D as parsePollStartContent, S as formatPollAsText, T as isPollStartType, _ as readJoinedMatrixMembers, a as sendMessageMatrix, f as promoteMatrixDirectRoomCandidate, g as isStrictDirectMembership, h as hasDirectMatrixMemberFlag, t as chunkMatrixText, v as MATRIX_OPENCLAW_FINALIZED_PREVIEW_KEY, w as isPollEventType } from "./send-EorDXlGl.js";
@@ -24,9 +24,11 @@ import { a as EventType, i as resolveMatrixThreadRouting, n as resolveMatrixRepl
 import { normalizeLowercaseStringOrEmpty, normalizeOptionalString, normalizeStringifiedOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { createPreviewMessageReceipt, defineFinalizableLivePreviewAdapter, deliverWithFinalizableLivePreviewAdapter } from "openclaw/plugin-sdk/channel-message";
 import { CHANNEL_APPROVAL_NATIVE_RUNTIME_CONTEXT_CAPABILITY } from "openclaw/plugin-sdk/approval-handler-adapter-runtime";
+import { resolveInboundLastRouteSessionKey } from "openclaw/plugin-sdk/routing";
 import { loadSessionStore, resolveSessionStoreEntry } from "openclaw/plugin-sdk/session-store-runtime";
 import { readJsonFileWithFallback, writeJsonFileAtomically } from "openclaw/plugin-sdk/json-store";
 import { format } from "node:util";
+import { buildTtsSupplementMediaPayload, getReplyPayloadTtsSupplement } from "openclaw/plugin-sdk/reply-payload";
 import { resolveAckReaction } from "openclaw/plugin-sdk/channel-feedback";
 import { hasFinalInboundReplyDispatch } from "openclaw/plugin-sdk/inbound-reply-dispatch";
 import { waitUntilAbort } from "openclaw/plugin-sdk/channel-lifecycle";
@@ -2018,7 +2020,7 @@ function loadSessionBindingRuntime() {
 	return sessionBindingRuntimePromise;
 }
 function loadMatrixReactionEvents() {
-	matrixReactionEventsPromise ??= import("./reaction-events-QfQs2osk.js");
+	matrixReactionEventsPromise ??= import("./reaction-events-1XDDYTnu.js");
 	return matrixReactionEventsPromise;
 }
 function loadMatrixDraftStream() {
@@ -3070,11 +3072,16 @@ function createMatrixRoomMessageHandler(params) {
 				deliver: async (payload, info) => {
 					if (draftStream && info.kind !== "tool" && !payload.isCompactionNotice) {
 						const hasMedia = Boolean(payload.mediaUrl) || (payload.mediaUrls?.length ?? 0) > 0;
+						const ttsSupplement = getReplyPayloadTtsSupplement(payload);
+						const fallbackPayload = ttsSupplement && ttsSupplement.visibleTextAlreadyDelivered !== true && !payload.text?.trim() ? {
+							...payload,
+							text: ttsSupplement.spokenText
+						} : payload;
 						if (draftConsumed) {
 							await draftStream.discardPending();
 							await deliverMatrixReplies({
 								cfg,
-								replies: [payload],
+								replies: [fallbackPayload],
 								roomId,
 								client,
 								runtime,
@@ -3139,7 +3146,7 @@ function createMatrixRoomMessageHandler(params) {
 									await redactMatrixDraftEvent(client, roomId, draftEventId);
 									await deliverMatrixReplies({
 										cfg,
-										replies: [payload],
+										replies: [fallbackPayload],
 										roomId,
 										client,
 										runtime,
@@ -3155,7 +3162,7 @@ function createMatrixRoomMessageHandler(params) {
 							draftConsumed = true;
 						} else if (draftEventId && hasMedia && !payloadReplyMismatch) {
 							let textEditOk = !mustDeliverFinalNormally;
-							const payloadText = payload.text;
+							const payloadText = payload.text ?? ttsSupplement?.spokenText;
 							const payloadTextMatchesDraft = typeof payloadText === "string" && draftStream.matchesPreparedText(payloadText);
 							const reusesDraftTextUnchanged = typeof payloadText === "string" && Boolean(payloadText.trim()) && payloadTextMatchesDraft;
 							if (textEditOk && payloadText && (quietDraftStreaming || typeof payloadText === "string" && !payloadTextMatchesDraft)) {
@@ -3168,13 +3175,13 @@ function createMatrixRoomMessageHandler(params) {
 									extraContent: quietDraftStreaming ? buildMatrixFinalizedPreviewContent() : void 0
 								}).then(() => true, () => false);
 							} else if (textEditOk && reusesDraftTextUnchanged) textEditOk = await draftStream.finalizeLive();
-							const reusesDraftAsFinalText = Boolean(payload.text?.trim()) && textEditOk;
+							const reusesDraftAsFinalText = Boolean(payloadText?.trim()) && textEditOk;
 							if (!reusesDraftAsFinalText) await redactMatrixDraftEvent(client, roomId, draftEventId);
 							await deliverMatrixReplies({
 								cfg,
-								replies: [{
+								replies: [ttsSupplement && reusesDraftAsFinalText ? buildTtsSupplementMediaPayload(payload) : {
 									...payload,
-									text: reusesDraftAsFinalText ? void 0 : payload.text
+									text: reusesDraftAsFinalText ? void 0 : payload.text ?? (ttsSupplement?.visibleTextAlreadyDelivered === true ? void 0 : ttsSupplement?.spokenText)
 								}],
 								roomId,
 								client,
@@ -3192,7 +3199,7 @@ function createMatrixRoomMessageHandler(params) {
 							if (draftRedacted && draftEventId) await redactMatrixDraftEvent(client, roomId, draftEventId);
 							const deliveredFallback = await deliverMatrixReplies({
 								cfg,
-								replies: [payload],
+								replies: [fallbackPayload],
 								roomId,
 								client,
 								runtime,
@@ -3258,6 +3265,10 @@ function createMatrixRoomMessageHandler(params) {
 					normalizeEntry: normalizeMatrixUserId
 				});
 			})() : null;
+			const inboundLastRouteSessionKey = resolveInboundLastRouteSessionKey({
+				route: _route,
+				sessionKey: _route.sessionKey
+			});
 			const turnResult = await core.channel.turn.run({
 				channel: "matrix",
 				accountId: _route.accountId,
@@ -3280,11 +3291,11 @@ function createMatrixRoomMessageHandler(params) {
 						botLoopProtection,
 						record: {
 							updateLastRoute: isDirectMessage ? {
-								sessionKey: _route.mainSessionKey,
+								sessionKey: inboundLastRouteSessionKey,
 								channel: "matrix",
 								to: `room:${roomId}`,
 								accountId: _route.accountId,
-								mainDmOwnerPin: pinnedMainDmOwner ? {
+								mainDmOwnerPin: inboundLastRouteSessionKey === _route.mainSessionKey && pinnedMainDmOwner ? {
 									ownerRecipient: pinnedMainDmOwner,
 									senderRecipient: normalizeMatrixUserId(senderId),
 									onSkip: ({ ownerRecipient, senderRecipient }) => {

package/dist/{reaction-events-QfQs2osk.js → reaction-events-1XDDYTnu.js}

@@ -7,7 +7,7 @@ import { getSessionBindingService } from "openclaw/plugin-sdk/session-binding-ru
 let approvalReactionAuthPromise;
 let execApprovalResolverPromise;
 function loadApprovalReactionAuth() {
-	approvalReactionAuthPromise ??= import("./approval-reaction-auth-WbN5AstS.js");
+	approvalReactionAuthPromise ??= import("./approval-reaction-auth-BTy3BiII.js");
 	return approvalReactionAuthPromise;
 }
 function loadExecApprovalResolver() {

package/dist/setup-plugin-api.js

@@ -1,5 +1,5 @@
 import { g as resolveMatrixAccount, n as matrixSetupAdapter, t as createMatrixSetupWizardProxy } from "./setup-core-CnUlkNmz.js";
-import { r as matrixConfigAdapter, t as MatrixChannelConfigSchema } from "./config-schema-DpROObD_.js";
+import { r as matrixConfigAdapter, t as MatrixChannelConfigSchema } from "./config-schema-B1OTtJSg.js";
 import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 const matrixSetupPlugin = {
 	id: "matrix",

package/dist/test-api.js

@@ -1,4 +1,4 @@
 import { r as setMatrixRuntime } from "./runtime-Dog86njy.js";
-import { t as matrixPlugin } from "./channel-dMBvPDsp.js";
+import { t as matrixPlugin } from "./channel-ClUVS-7H.js";
 import { t as MatrixClient } from "./sdk-DDUAi9uh.js";
 export { MatrixClient, matrixPlugin, setMatrixRuntime };

package/openclaw.plugin.json

@@ -370,6 +370,11 @@
                         "exclusiveMinimum": 0,
                         "maximum": 9007199254740991
                       },
+                      "maxLineChars": {
+                        "type": "integer",
+                        "exclusiveMinimum": 0,
+                        "maximum": 9007199254740991
+                      },
                       "toolProgress": {
                         "type": "boolean"
                       }
@@ -893,6 +898,10 @@
           "label": "Matrix Progress Max Lines",
           "help": "Maximum number of compact progress lines to keep below the draft label (default: 8)."
         },
+        "streaming.progress.maxLineChars": {
+          "label": "Matrix Progress Max Line Chars",
+          "help": "Maximum characters per compact progress line before truncation (default: 120). Prose cuts at word boundaries; commands and paths keep useful suffixes."
+        },
         "streaming.progress.toolProgress": {
           "label": "Matrix Progress Tool Lines",
           "help": "Show compact tool/progress lines in progress draft mode (default: true). Set false to keep only the label until final delivery."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/matrix",
-  "version": "2026.5.16-beta.4",
+  "version": "2026.5.16-beta.5",
   "description": "OpenClaw Matrix channel plugin",
   "repository": {
     "type": "git",
@@ -22,7 +22,7 @@
     "openclaw": "workspace:*"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.5.16-beta.4"
+    "openclaw": ">=2026.5.16-beta.5"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -87,10 +87,10 @@
       "allowInvalidConfigRecovery": true
     },
     "compat": {
-      "pluginApi": ">=2026.5.16-beta.4"
+      "pluginApi": ">=2026.5.16-beta.5"
     },
     "build": {
-      "openclawVersion": "2026.5.16-beta.4"
+      "openclawVersion": "2026.5.16-beta.5"
     },
     "release": {
       "publishToClawHub": true,