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

package/dist/{file-sync-store-DiiFsayX.js → file-sync-store-DjskBX2o.js}

@@ -1,8 +1,8 @@
 import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
-import { t as isRecord } from "./record-shared-CWWx6fvI.js";
 import { t as getMatrixRuntime } from "./runtime-6S3DNFNv.js";
-import { M as resolveMatrixSqliteStateEnv, t as claimCurrentTokenStorageState } from "./storage-BvAkgzvT.js";
-import { n as LogService } from "./logger-D0GCSDQq.js";
+import { M as resolveMatrixSqliteStateEnv, t as claimCurrentTokenStorageState } from "./storage-BsGuHngK.js";
+import { n as LogService } from "./logger-B_71hN6W.js";
+import { isRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { createHash, randomUUID } from "node:crypto";
 import path from "node:path";
 import fs from "node:fs/promises";
@@ -108,6 +108,7 @@ var SqliteBackedMatrixSyncStore = class extends MemoryStore {
 		this.savedSync = null;
 		this.cleanShutdown = false;
 		this.dirty = false;
+		this.frozen = false;
 		this.persistTimer = null;
 		this.persistPromise = null;
 		this.stateKey = SYNC_CACHE_STATE_KEY;
@@ -154,6 +155,7 @@ var SqliteBackedMatrixSyncStore = class extends MemoryStore {
 		return Promise.resolve(this.savedSync?.nextBatch ?? null);
 	}
 	setSyncData(syncData) {
+		if (this.frozen) return Promise.resolve();
 		this.accumulator.accumulate(syncData);
 		this.savedSync = this.accumulator.getJSON();
 		this.markDirtyAndSchedulePersist();
@@ -163,6 +165,7 @@ var SqliteBackedMatrixSyncStore = class extends MemoryStore {
 		return Promise.resolve(this.savedClientOptions ? cloneJson(this.savedClientOptions) : void 0);
 	}
 	storeClientOptions(options) {
+		if (this.frozen) return Promise.resolve();
 		this.savedClientOptions = cloneJson(options);
 		super.storeClientOptions(options);
 		this.markDirtyAndSchedulePersist();
@@ -195,6 +198,23 @@ var SqliteBackedMatrixSyncStore = class extends MemoryStore {
 		this.cleanShutdown = true;
 		this.dirty = true;
 	}
+	async freezeSyncCursorPersistence() {
+		this.frozen = true;
+		if (this.persistTimer) {
+			clearTimeout(this.persistTimer);
+			this.persistTimer = null;
+		}
+		await this.persistPromise;
+	}
+	discardPendingSyncCursorPersistence() {
+		this.frozen = true;
+		if (this.persistTimer) {
+			clearTimeout(this.persistTimer);
+			this.persistTimer = null;
+		}
+		this.cleanShutdown = false;
+		this.dirty = false;
+	}
 	async flush() {
 		if (this.persistTimer) {
 			clearTimeout(this.persistTimer);
@@ -208,6 +228,7 @@ var SqliteBackedMatrixSyncStore = class extends MemoryStore {
 		}
 	}
 	markDirtyAndSchedulePersist() {
+		if (this.frozen) return;
 		this.cleanShutdown = false;
 		this.dirty = true;
 		if (this.persistTimer) return;

package/dist/helper-api.js

@@ -1,4 +1,4 @@
-import { a as resolveMatrixDefaultOrOnlyAccountId, i as resolveMatrixChannelConfig, n as requiresExplicitMatrixDefaultAccount, r as resolveConfiguredMatrixAccountIds, t as findMatrixAccountEntry } from "./account-selection-kqquRzCf.js";
-import { n as listMatrixEnvAccountIds, r as resolveMatrixEnvAccountToken, t as getMatrixScopedEnvVarNames } from "./env-vars-B0NxQnPk.js";
+import { a as resolveMatrixDefaultOrOnlyAccountId, i as resolveMatrixChannelConfig, n as requiresExplicitMatrixDefaultAccount, r as resolveConfiguredMatrixAccountIds, t as findMatrixAccountEntry } from "./account-selection-CWuhuFn1.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";
 export { findMatrixAccountEntry, getMatrixScopedEnvVarNames, hashMatrixAccessToken, listMatrixEnvAccountIds, requiresExplicitMatrixDefaultAccount, resolveConfiguredMatrixAccountIds, resolveMatrixAccountStorageRoot, resolveMatrixChannelConfig, resolveMatrixCredentialsDir, resolveMatrixCredentialsFilename, resolveMatrixCredentialsPath, resolveMatrixDefaultOrOnlyAccountId, resolveMatrixEnvAccountToken, resolveMatrixHomeserverKey, sanitizeMatrixPathSegment };

package/dist/{idb-persistence-B6x7dMsF.js → idb-persistence-BM0P27Zg.js}

@@ -1,5 +1,5 @@
-import { D as writeMatrixIdbSnapshotJson, f as MATRIX_IDB_SNAPSHOT_FILENAME, w as readMatrixIdbSnapshotJson } from "./storage-BvAkgzvT.js";
-import { n as LogService } from "./logger-D0GCSDQq.js";
+import { D as writeMatrixIdbSnapshotJson, f as MATRIX_IDB_SNAPSHOT_FILENAME, w as readMatrixIdbSnapshotJson } from "./storage-BsGuHngK.js";
+import { n as LogService } from "./logger-B_71hN6W.js";
 import { n as MATRIX_IDB_SNAPSHOT_LOCK_OPTIONS } from "./idb-persistence-lock-DAJ49nZX.js";
 import path from "node:path";
 import { toErrorObject } from "openclaw/plugin-sdk/error-runtime";
@@ -209,6 +209,7 @@ async function persistIdbToDisk(params) {
 		if (err instanceof MatrixIdbSnapshotMigrationRequiredError) throw err;
 		if (!callbackStarted && fs.existsSync(snapshotPath)) throwLegacySnapshotMigrationRequired();
 		LogService.warn("IdbPersistence", "Failed to persist IndexedDB snapshot:", err);
+		if (params?.strict) throw err;
 	}
 }
 function readLegacyMatrixIdbSnapshotStateUnlocked(storageRootDir) {

package/dist/{inbound-dedupe-CaBLblef.js → inbound-dedupe-RvSLqdsz.js}

@@ -1,4 +1,4 @@
-import { n as LogService } from "./logger-D0GCSDQq.js";
+import { n as LogService } from "./logger-B_71hN6W.js";
 import { createChannelReplayGuard, resolvePersistentDedupePluginStateNamespace } from "openclaw/plugin-sdk/persistent-dedupe";
 //#region extensions/matrix/src/matrix/monitor/inbound-dedupe.ts
 const MATRIX_INBOUND_DEDUPE_PLUGIN_ID = "matrix";
@@ -45,4 +45,4 @@ function createMatrixInboundEventDeduper(params) {
 	});
 }
 //#endregion
-export { resolveMatrixInboundDedupeStateNamespace as a, createMatrixInboundEventDeduper as i, MATRIX_INBOUND_DEDUPE_TTL_MS as n, buildMatrixInboundDedupeEventKey as r, MATRIX_INBOUND_DEDUPE_STATE_MAX_ENTRIES as t };
+export { MATRIX_INBOUND_DEDUPE_STATE_MAX_ENTRIES, MATRIX_INBOUND_DEDUPE_TTL_MS, buildMatrixInboundDedupeEventKey, createMatrixInboundEventDeduper, resolveMatrixInboundDedupeStateNamespace };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { n as registerMatrixCliMetadata } from "./cli-metadata-DnXxNCoj.js";
+import { n as registerMatrixCliMetadata } from "./cli-metadata-B1d1aGM5.js";
 import { registerMatrixSubagentHooks } from "./subagent-hooks-api.js";
 import { defineBundledChannelEntry } from "openclaw/plugin-sdk/channel-entry-contract";
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";

package/dist/{logger-D0GCSDQq.js → logger-B_71hN6W.js}

@@ -1,6 +1,6 @@
 import { t as getMatrixRuntime } from "./runtime-6S3DNFNv.js";
 import { format } from "node:util";
-import { redactSensitiveText } from "openclaw/plugin-sdk/logging-core";
+import { redactSensitiveText } from "openclaw/plugin-sdk/security-runtime";
 //#region extensions/matrix/src/matrix/sdk/logger.ts
 function noop() {}
 let forceConsoleLogging = false;

package/dist/{logging-DV-p52N0.js → logging-DRjvUOIh.js}

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
-import { i as setMatrixConsoleLogging, n as LogService, t as ConsoleLogger } from "./logger-D0GCSDQq.js";
+import { i as setMatrixConsoleLogging, n as LogService, t as ConsoleLogger } from "./logger-B_71hN6W.js";
 import { logger } from "matrix-js-sdk/lib/logger.js";
 //#region extensions/matrix/src/matrix/client/logging.ts
 var logging_exports = /* @__PURE__ */ __exportAll({

package/dist/{media-text-DlQC_k_K.js → media-text-JudlYOSc.js}

@@ -1,4 +1,4 @@
-import { C as formatPollResultsAsText, D as parsePollStartContent, O as resolvePollReferenceEventId, S as formatPollAsText, T as isPollStartType, w as isPollEventType, x as buildPollResultsSummary } from "./send-C9Ssx-iV.js";
+import { _ as parsePollStartContent, d as buildPollResultsSummary, f as formatPollAsText, h as isPollStartType, m as isPollEventType, p as formatPollResultsAsText, v as resolvePollReferenceEventId } from "./send-ZDLU4JTk.js";
 import path from "node:path";
 //#region extensions/matrix/src/matrix/poll-summary.ts
 function resolveMatrixPollRootEventId(event) {

package/dist/{messages-Bf_s--M9.js → messages-BW0s-6Y9.js}

@@ -1,8 +1,8 @@
-import { r as isMatrixNotFoundError } from "./errors-C47hvAF8.js";
-import { T as isPollStartType, r as sendMessageMatrix, t as editMessageMatrix, w as isPollEventType } from "./send-C9Ssx-iV.js";
+import { h as isPollStartType, m as isPollEventType, r as sendMessageMatrix, t as editMessageMatrix } from "./send-ZDLU4JTk.js";
 import { n as MATRIX_REACTION_EVENT_TYPE } from "./reaction-common-DkrQdBSZ.js";
-import { a as resolveMatrixMessageAttachment, l as resolveMatrixPollRootEventId, o as resolveMatrixMessageBody, s as fetchMatrixPollMessageSummary } from "./media-text-DlQC_k_K.js";
-import { r as withResolvedRoomAction } from "./client-CitERujx.js";
+import { a as resolveMatrixMessageAttachment, l as resolveMatrixPollRootEventId, o as resolveMatrixMessageBody, s as fetchMatrixPollMessageSummary } from "./media-text-JudlYOSc.js";
+import { r as withResolvedRoomAction } from "./client-sJesKQmp.js";
+import { n as isMatrixNotFoundError } from "./errors-DKVS3_DO.js";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { resolveIntegerOption } from "openclaw/plugin-sdk/number-runtime";
 //#region extensions/matrix/src/matrix/actions/limits.ts
@@ -19,9 +19,20 @@ const EventType = {
 };
 //#endregion
 //#region extensions/matrix/src/matrix/actions/summary.ts
+function resolveBundledMatrixReplacementContent(event) {
+	const rawReplacement = event.unsigned?.["m.relations"]?.["m.replace"];
+	if (!rawReplacement || typeof rawReplacement !== "object" || event.state_key !== void 0) return;
+	const replacement = rawReplacement;
+	const content = replacement.content;
+	const relation = content?.["m.relates_to"];
+	const newContent = content?.["m.new_content"];
+	if (replacement.sender !== event.sender || replacement.type !== event.type || replacement.state_key !== void 0 || replacement.unsigned?.redacted_because || !relation || typeof relation !== "object" || relation.rel_type !== "m.replace" || relation.event_id !== event.event_id || !newContent || typeof newContent !== "object" || Array.isArray(newContent)) return;
+	return newContent;
+}
 function summarizeMatrixRawEvent(event) {
 	const content = event.content;
 	const relates = content["m.relates_to"];
+	const displayContent = relates?.rel_type === "m.replace" ? content["m.new_content"] ?? content : resolveBundledMatrixReplacementContent(event) ?? content;
 	let relType;
 	let eventId;
 	if (relates) {
@@ -38,15 +49,15 @@ function summarizeMatrixRawEvent(event) {
 		eventId: event.event_id,
 		sender: event.sender,
 		body: resolveMatrixMessageBody({
-			body: content.body,
-			filename: content.filename,
-			msgtype: content.msgtype
+			body: displayContent.body,
+			filename: displayContent.filename,
+			msgtype: displayContent.msgtype
 		}),
-		msgtype: content.msgtype,
+		msgtype: displayContent.msgtype,
 		attachment: resolveMatrixMessageAttachment({
-			body: content.body,
-			filename: content.filename,
-			msgtype: content.msgtype
+			body: displayContent.body,
+			filename: displayContent.filename,
+			msgtype: displayContent.msgtype
 		}),
 		timestamp: event.origin_server_ts,
 		relatesTo
@@ -74,11 +85,35 @@ async function fetchEventSummary(client, roomId, eventId) {
 //#endregion
 //#region extensions/matrix/src/matrix/actions/messages.ts
 const MATRIX_THREAD_RELATIONS_START_CURSOR_PREFIX = "openclaw.matrix.thread-relations-start:";
+function resolveMatrixReplacementTarget(event) {
+	const relation = event.content["m.relates_to"];
+	if (!relation || typeof relation !== "object") return;
+	const replacement = relation;
+	return replacement.rel_type === "m.replace" && typeof replacement.event_id === "string" ? replacement.event_id : void 0;
+}
+function resolveLatestMatrixReplacements(events) {
+	const pageEventIds = new Set(events.map((event) => event.event_id));
+	const originals = new Map(events.filter((event) => event.type === EventType.RoomMessage && !event.unsigned?.redacted_because && event.state_key === void 0 && !resolveMatrixReplacementTarget(event)).map((event) => [event.event_id, event]));
+	const replacements = /* @__PURE__ */ new Map();
+	for (const event of events) {
+		const targetId = resolveMatrixReplacementTarget(event);
+		const original = targetId ? originals.get(targetId) : void 0;
+		const newContent = event.content["m.new_content"];
+		if (!targetId || !original || event.sender !== original.sender || event.type !== original.type || event.state_key !== void 0 || event.unsigned?.redacted_because || !newContent || typeof newContent !== "object" || Array.isArray(newContent)) continue;
+		const latest = replacements.get(targetId);
+		if (!latest || event.origin_server_ts > latest.origin_server_ts || event.origin_server_ts === latest.origin_server_ts && event.event_id > latest.event_id) replacements.set(targetId, event);
+	}
+	return {
+		pageEventIds,
+		replacements
+	};
+}
 async function sendMatrixMessage(to, content, opts = {}) {
 	if (!opts.cfg) throw new Error("Matrix message actions require a resolved runtime config.");
 	return await sendMessageMatrix(to, content, {
 		cfg: opts.cfg,
 		mediaUrl: opts.mediaUrl,
+		...opts.mediaAccess ? { mediaAccess: opts.mediaAccess } : {},
 		mediaLocalRoots: opts.mediaLocalRoots,
 		replyToId: opts.replyToId,
 		threadId: opts.threadId,
@@ -90,9 +125,8 @@ async function sendMatrixMessage(to, content, opts = {}) {
 }
 async function editMatrixMessage(roomId, messageId, content, opts = {}) {
 	if (!opts.cfg) throw new Error("Matrix message actions require a resolved runtime config.");
-	const trimmed = content.trim();
-	if (!trimmed) throw new Error("Matrix edit requires content");
-	return { eventId: await editMessageMatrix(roomId, messageId, trimmed, {
+	if (!content.trim()) throw new Error("Matrix edit requires content");
+	return { eventId: await editMessageMatrix(roomId, messageId, content.trimEnd(), {
 		cfg: opts.cfg,
 		accountId: opts.accountId ?? void 0,
 		client: opts.client,
@@ -131,6 +165,7 @@ async function readMatrixMessages(roomId, opts = {}) {
 			from: token
 		});
 		const hydratedChunk = await client.hydrateEvents(resolvedRoom, relationPage ? rootFillsThreadPage ? [] : relationPage.events : flatPage?.chunk ?? []);
+		const { pageEventIds, replacements } = resolveLatestMatrixReplacements(hydratedChunk);
 		const messages = [];
 		if (threadRootSummary) messages.push(threadRootSummary);
 		for (const event of hydratedChunk) {
@@ -138,7 +173,22 @@ async function readMatrixMessages(roomId, opts = {}) {
 			if (!threadId && isMatrixThreadEvent(event)) continue;
 			if (event.type === EventType.RoomMessage) {
 				if (threadId && event.event_id === threadId) continue;
-				messages.push(summarizeMatrixRawEvent(event));
+				const replacementTarget = resolveMatrixReplacementTarget(event);
+				if (replacementTarget) {
+					const newContent = event.content["m.new_content"];
+					if (pageEventIds.has(replacementTarget) || !newContent || typeof newContent !== "object" || Array.isArray(newContent)) continue;
+					messages.push(summarizeMatrixRawEvent(event));
+					continue;
+				}
+				const replacement = replacements.get(event.event_id);
+				const originalRelation = event.content["m.relates_to"];
+				messages.push(summarizeMatrixRawEvent(replacement ? {
+					...event,
+					content: {
+						...replacement.content["m.new_content"],
+						"m.relates_to": originalRelation
+					}
+				} : event));
 				continue;
 			}
 			if (!isPollEventType(event.type)) continue;
@@ -172,8 +222,10 @@ function isMatrixThreadRelationsStartCursor(raw, threadId) {
 	if (!raw?.startsWith(MATRIX_THREAD_RELATIONS_START_CURSOR_PREFIX)) return false;
 	const encoded = raw.slice(39);
 	try {
-		const decoded = JSON.parse(Buffer.from(encoded, "base64url").toString("utf8"));
-		return decoded.v === 1 && decoded.threadId === threadId;
+		const bytes = Buffer.from(encoded, "base64url");
+		if (bytes.toString("base64url") !== encoded) return false;
+		const decoded = JSON.parse(bytes.toString("utf8"));
+		return decoded.v === 1 && decoded.threadId === threadId && encodeMatrixThreadRelationsStartCursor(decoded.threadId) === raw;
 	} catch {
 		return false;
 	}