@openclaw/matrix 2026.7.2-beta.3 → 2026.7.2-beta.4

package/dist/doctor-contract-api.js

@@ -2,18 +2,103 @@ import { a as resolveMatrixDefaultOrOnlyAccountId, n as requiresExplicitMatrixDe
 import { t as isRecord$1 } from "./record-shared-CWWx6fvI.js";
 import { r as resolveMatrixCredentialsDir } from "./storage-paths-gUmSydsW.js";
 import { a as isMatrixCredentialRevocation, c as normalizeMatrixStoredCredentials, s as matrixCredentialsStoreKey, t as MATRIX_CREDENTIALS_NAMESPACE } from "./credentials-read-DVmFCm7X.js";
-import { n as normalizeCompatibilityConfig, t as legacyConfigRules } from "./doctor-contract-BA2Y6Crx.js";
-import { O as writeMatrixIdbSnapshotJsonToStore, S as readLegacyMatrixLegacyCryptoMigrationState, _ as hasMatrixRecoveryKeyStateInStore, a as openMatrixStorageMetaStoreOptions, b as openMatrixLegacyCryptoMigrationStoreOptions, f as MATRIX_IDB_SNAPSHOT_FILENAME, g as hasMatrixLegacyCryptoMigrationStateInStore, h as hasMatrixIdbSnapshotStateInStore, i as normalizeMatrixStorageMetadata, j as writeMatrixRecoveryKeyStateToStore, k as writeMatrixLegacyCryptoMigrationStateToStore, m as MATRIX_RECOVERY_KEY_FILENAME, n as hasMatrixStorageMetaStateInStore, p as MATRIX_LEGACY_CRYPTO_MIGRATION_FILENAME, u as writeMatrixStorageMetaStateToStore, w as readLegacyMatrixRecoveryKeyState, x as openMatrixRecoveryKeyStoreOptions, y as openMatrixIdbSnapshotStoreOptions } from "./storage-CzHxeF5E.js";
-import { a as readLegacyMatrixSyncCacheState, i as openMatrixSyncCacheStoreOptions, o as writeMatrixSyncCacheStateToStore, r as hasMatrixSyncCacheStateInStore } from "./file-sync-store-CPkgnSXp.js";
+import { n as normalizeCompatibilityConfig, t as legacyConfigRules } from "./doctor-contract-CWVdlRQR.js";
+import { C as readLegacyMatrixRecoveryKeyState, O as writeMatrixIdbSnapshotJsonToStore, T as readMatrixIdbSnapshotJsonFromStore, a as openMatrixStorageMetaStoreOptions, b as openMatrixRecoveryKeyStoreOptions, f as MATRIX_IDB_SNAPSHOT_FILENAME, g as hasMatrixRecoveryKeyStateInStore, h as hasMatrixLegacyCryptoMigrationStateInStore, i as normalizeMatrixStorageMetadata, j as writeMatrixRecoveryKeyStateToStore, k as writeMatrixLegacyCryptoMigrationStateToStore, m as MATRIX_RECOVERY_KEY_FILENAME, n as hasMatrixStorageMetaStateInStore, p as MATRIX_LEGACY_CRYPTO_MIGRATION_FILENAME, u as writeMatrixStorageMetaStateToStore, v as openMatrixIdbSnapshotStoreOptions, x as readLegacyMatrixLegacyCryptoMigrationState, y as openMatrixLegacyCryptoMigrationStoreOptions } from "./storage-BrkTJZov.js";
+import { a as readLegacyMatrixSyncCacheState, i as openMatrixSyncCacheStoreOptions, o as writeMatrixSyncCacheStateToStore, r as hasMatrixSyncCacheStateInStore } from "./file-sync-store-DUEWCEjb.js";
+import { n as MATRIX_IDB_SNAPSHOT_LOCK_OPTIONS } from "./idb-persistence-lock-DAJ49nZX.js";
+import { r as readLegacyMatrixIdbSnapshotStateUnlocked, t as isValidMatrixIdbSnapshotJson } from "./idb-persistence-C6zQfW2w.js";
 import { a as resolveMatrixInboundDedupeStateNamespace, n as MATRIX_INBOUND_DEDUPE_TTL_MS, r as buildMatrixInboundDedupeEventKey } from "./inbound-dedupe-CaBLblef.js";
-import { r as readLegacyMatrixIdbSnapshotState } from "./idb-persistence-Dyy6ipgU.js";
 import { isRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 import { archiveLegacyStateSource } from "openclaw/plugin-sdk/runtime-doctor";
-import { createHash } from "node:crypto";
+import { createHash, randomUUID } from "node:crypto";
 import path from "node:path";
-import fs from "node:fs/promises";
+import fs from "node:fs";
+import fs$1 from "node:fs/promises";
+import { isDeepStrictEqual } from "node:util";
+import { withFileLock } from "openclaw/plugin-sdk/file-lock";
 import { createPersistentDedupeImportEntry } from "openclaw/plugin-sdk/persistent-dedupe";
+//#region extensions/matrix/src/matrix/crypto-snapshot-doctor.ts
+async function migrateLegacyMatrixIdbSnapshot(params) {
+	const snapshotPath = path.join(params.storageRootDir, MATRIX_IDB_SNAPSHOT_FILENAME);
+	try {
+		await withFileLock(snapshotPath, MATRIX_IDB_SNAPSHOT_LOCK_OPTIONS, () => migrateLegacyMatrixIdbSnapshotLocked(params));
+	} catch (err) {
+		params.warnings.push(`Failed locking Matrix IndexedDB snapshot for ${params.storageRootDir}: ${String(err)}; left legacy source in place`);
+	}
+}
+async function migrateLegacyMatrixIdbSnapshotLocked(params) {
+	const sourcePath = path.join(params.storageRootDir, MATRIX_IDB_SNAPSHOT_FILENAME);
+	let snapshot;
+	try {
+		snapshot = readLegacyMatrixIdbSnapshotStateUnlocked(params.storageRootDir);
+	} catch (err) {
+		params.warnings.push(`Failed reading Matrix IndexedDB snapshot legacy source for ${params.storageRootDir}: ${String(err)}; left source in place`);
+		return;
+	}
+	if (!snapshot) {
+		if (!fs.existsSync(sourcePath)) return;
+		const archived = await archiveLegacyMatrixIdbSnapshot(params);
+		params.warnings.push(archived ? `Matrix IndexedDB snapshot legacy source is invalid for ${params.storageRootDir}; archived without import` : `Matrix IndexedDB snapshot legacy source is invalid for ${params.storageRootDir}; left active because archival failed`);
+		return;
+	}
+	const snapshotJson = JSON.stringify(snapshot);
+	const store = params.context.openPluginStateKeyedStore(openMatrixIdbSnapshotStoreOptions(params.storageRootDir));
+	let persisted;
+	let hadPartialState;
+	try {
+		persisted = await readMatrixIdbSnapshotJsonFromStore({ store });
+		const persistedIsValid = persisted ? isValidMatrixIdbSnapshotJson(persisted) : false;
+		hadPartialState = !persistedIsValid && (await store.entries()).length > 0;
+		if (!persistedIsValid) persisted = null;
+	} catch (err) {
+		params.warnings.push(`Failed inspecting Matrix IndexedDB snapshot SQLite state for ${params.storageRootDir}: ${String(err)}; left legacy source in place`);
+		return;
+	}
+	if (persisted && !snapshotContentMatches(persisted, snapshot)) {
+		if (await archiveLegacyMatrixIdbSnapshot(params)) params.notices.push(`Kept the canonical Matrix IndexedDB snapshot in SQLite and archived a differing legacy source for ${params.storageRootDir}`);
+		return;
+	}
+	if (!persisted) {
+		try {
+			await writeMatrixIdbSnapshotJsonToStore({
+				snapshotJson,
+				databaseCount: snapshot.length,
+				store
+			});
+			persisted = await readMatrixIdbSnapshotJsonFromStore({ store });
+		} catch (err) {
+			params.warnings.push(`Failed importing Matrix IndexedDB snapshot for ${params.storageRootDir}: ${String(err)}; left legacy source in place`);
+			return;
+		}
+		if (!persisted || !snapshotContentMatches(persisted, snapshot)) {
+			params.warnings.push(`Failed verifying Matrix IndexedDB snapshot for ${params.storageRootDir}; left legacy source in place`);
+			return;
+		}
+		params.changes.push(hadPartialState ? `Repaired partial or invalid Matrix IndexedDB snapshot SQLite state for ${params.storageRootDir}` : `Migrated Matrix IndexedDB snapshot JSON to SQLite for ${params.storageRootDir}`);
+	}
+	await archiveLegacyMatrixIdbSnapshot(params);
+}
+function snapshotContentMatches(persistedJson, snapshot) {
+	try {
+		return isDeepStrictEqual(JSON.parse(persistedJson), snapshot);
+	} catch {
+		return false;
+	}
+}
+async function archiveLegacyMatrixIdbSnapshot(params) {
+	const sourcePath = path.join(params.storageRootDir, MATRIX_IDB_SNAPSHOT_FILENAME);
+	const archivePath = `${sourcePath}.migrated-${(/* @__PURE__ */ new Date()).toISOString().replaceAll(":", "-")}-${randomUUID()}`;
+	try {
+		await fs$1.rename(sourcePath, archivePath);
+		params.changes.push(`Archived Matrix IndexedDB snapshot legacy source -> ${archivePath}`);
+		return true;
+	} catch (err) {
+		params.warnings.push(`Failed archiving Matrix IndexedDB snapshot legacy source: ${String(err)}`);
+		return false;
+	}
+}
+//#endregion
 //#region extensions/matrix/src/matrix/monitor/inbound-dedupe-migration.ts
 const LEGACY_SQLITE_NAMESPACE = "inbound-dedupe";
 const LEGACY_SQLITE_MAX_ENTRIES = 2e4;
@@ -29,7 +114,7 @@ async function collectMatrixInboundDedupeSources(stateDir) {
 	async function visit(dir) {
 		let entries;
 		try {
-			entries = await fs.readdir(dir, { withFileTypes: true });
+			entries = await fs$1.readdir(dir, { withFileTypes: true });
 		} catch {
 			return;
 		}
@@ -113,7 +198,7 @@ async function retireLegacyInboundDedupeSqliteRows(io, storageRootDir) {
 }
 async function resolveJsonRootAccountId(storageRootDir) {
 	for (const filename of [STORAGE_META_FILENAME, `${STORAGE_META_FILENAME}.migrated`]) try {
-		const metadata = normalizeMatrixStorageMetadata(JSON.parse(await fs.readFile(path.join(storageRootDir, filename), "utf8")));
+		const metadata = normalizeMatrixStorageMetadata(JSON.parse(await fs$1.readFile(path.join(storageRootDir, filename), "utf8")));
 		if (metadata?.accountId) return metadata.accountId;
 	} catch {}
 	return "default";
@@ -125,7 +210,7 @@ async function resolveJsonRootAccountId(storageRootDir) {
 */
 async function readLegacyInboundDedupeJsonSource(storageRootDir) {
 	const jsonPath = path.join(storageRootDir, MATRIX_LEGACY_INBOUND_DEDUPE_FILENAME);
-	const raw = await fs.readFile(jsonPath, "utf8");
+	const raw = await fs$1.readFile(jsonPath, "utf8");
 	let parsed;
 	try {
 		parsed = JSON.parse(raw);
@@ -208,7 +293,7 @@ async function collectLegacyMatrixCredentialSources(params) {
 	const credentialsDir = resolveMatrixCredentialsDir(params.stateDir);
 	let entries;
 	try {
-		entries = await fs.readdir(credentialsDir, { withFileTypes: true });
+		entries = await fs$1.readdir(credentialsDir, { withFileTypes: true });
 	} catch {
 		return [];
 	}
@@ -227,8 +312,8 @@ async function collectLegacyMatrixCredentialSources(params) {
 async function readLegacyMatrixCredentials(source) {
 	if (!source.accountId) return null;
 	try {
-		const raw = JSON.parse(await fs.readFile(source.filePath, "utf8"));
-		const createdAt = isRecord(raw) && typeof raw.createdAt === "string" && raw.createdAt ? raw.createdAt : (await fs.stat(source.filePath)).mtime.toISOString();
+		const raw = JSON.parse(await fs$1.readFile(source.filePath, "utf8"));
+		const createdAt = isRecord(raw) && typeof raw.createdAt === "string" && raw.createdAt ? raw.createdAt : (await fs$1.stat(source.filePath)).mtime.toISOString();
 		return normalizeMatrixStoredCredentials(isRecord(raw) ? {
 			...raw,
 			createdAt
@@ -237,13 +322,13 @@ async function readLegacyMatrixCredentials(source) {
 		return null;
 	}
 }
-async function collectLegacyMatrixStateRoots(stateDir, filename) {
+async function collectLegacyMatrixStateRoots(stateDir, filename, options) {
 	const matrixRoot = path.join(stateDir, "matrix");
 	const roots = [];
 	async function visit(dir) {
 		let entries;
 		try {
-			entries = await fs.readdir(dir, { withFileTypes: true });
+			entries = await fs$1.readdir(dir, { withFileTypes: true });
 		} catch {
 			return;
 		}
@@ -257,14 +342,14 @@ async function collectLegacyMatrixStateRoots(stateDir, filename) {
 		}
 	}
 	await visit(matrixRoot);
-	return roots.filter((root) => path.resolve(root) !== path.resolve(matrixRoot)).toSorted();
+	return roots.filter((root) => options?.includeMatrixRoot || path.resolve(root) !== path.resolve(matrixRoot)).toSorted();
 }
 async function collectLegacySyncCacheRoots(stateDir) {
 	return collectLegacyMatrixStateRoots(stateDir, MATRIX_SYNC_CACHE_FILENAME);
 }
 async function readLegacyMatrixStorageMetadata(storageRootDir) {
 	try {
-		return normalizeMatrixStorageMetadata(JSON.parse(await fs.readFile(path.join(storageRootDir, MATRIX_STORAGE_META_FILENAME), "utf8")));
+		return normalizeMatrixStorageMetadata(JSON.parse(await fs$1.readFile(path.join(storageRootDir, MATRIX_STORAGE_META_FILENAME), "utf8")));
 	} catch {
 		return null;
 	}
@@ -592,74 +677,23 @@ const stateMigrations = [
 			};
 		}
 	},
-	{
-		id: "matrix-idb-snapshot-json-to-plugin-state",
-		label: "Matrix IndexedDB snapshot",
-		async detectLegacyState(params) {
-			const previews = [];
-			for (const storageRootDir of await collectLegacyMatrixStateRoots(params.stateDir, MATRIX_IDB_SNAPSHOT_FILENAME)) {
-				if (!await readLegacyMatrixIdbSnapshotState(storageRootDir)) continue;
-				previews.push(`Matrix IndexedDB snapshot JSON can migrate to SQLite: ${storageRootDir}`);
-			}
-			return previews.length > 0 ? { preview: previews } : null;
-		},
-		async migrateLegacyState(params) {
-			const changes = [];
-			const warnings = [];
-			const notices = [];
-			for (const storageRootDir of await collectLegacyMatrixStateRoots(params.stateDir, MATRIX_IDB_SNAPSHOT_FILENAME)) {
-				const snapshot = await readLegacyMatrixIdbSnapshotState(storageRootDir);
-				if (!snapshot) continue;
-				const store = params.context.openPluginStateKeyedStore(openMatrixIdbSnapshotStoreOptions(storageRootDir));
-				if (await hasMatrixIdbSnapshotStateInStore({ store })) {
-					await archiveLegacyMatrixStateFile({
-						storageRootDir,
-						filename: MATRIX_IDB_SNAPSHOT_FILENAME,
-						label: "Matrix IndexedDB snapshot",
-						changes,
-						warnings,
-						notices,
-						notice: `Kept existing Matrix IndexedDB snapshot in SQLite and archived the legacy source for ${storageRootDir}`
-					});
-					continue;
-				}
-				await writeMatrixIdbSnapshotJsonToStore({
-					snapshotJson: JSON.stringify(snapshot),
-					databaseCount: snapshot.length,
-					store
-				});
-				changes.push(`Migrated Matrix IndexedDB snapshot JSON to SQLite for ${storageRootDir}`);
-				await archiveLegacyMatrixStateFile({
-					storageRootDir,
-					filename: MATRIX_IDB_SNAPSHOT_FILENAME,
-					label: "Matrix IndexedDB snapshot",
-					changes,
-					warnings
-				});
-			}
-			return {
-				changes,
-				warnings,
-				...notices.length > 0 ? { notices } : {}
-			};
-		}
-	},
 	{
 		id: "matrix-legacy-crypto-migration-json-to-plugin-state",
-		label: "Matrix legacy crypto migration",
+		label: "Matrix legacy crypto state",
 		async detectLegacyState(params) {
 			const previews = [];
-			for (const storageRootDir of await collectLegacyMatrixStateRoots(params.stateDir, MATRIX_LEGACY_CRYPTO_MIGRATION_FILENAME)) {
+			for (const storageRootDir of await collectLegacyMatrixStateRoots(params.stateDir, MATRIX_LEGACY_CRYPTO_MIGRATION_FILENAME, { includeMatrixRoot: true })) {
 				if (!readLegacyMatrixLegacyCryptoMigrationState(storageRootDir)) continue;
 				previews.push(`Matrix legacy crypto migration JSON can migrate to SQLite: ${storageRootDir}`);
 			}
+			for (const storageRootDir of await collectLegacyMatrixStateRoots(params.stateDir, MATRIX_IDB_SNAPSHOT_FILENAME, { includeMatrixRoot: true })) previews.push(`Matrix IndexedDB snapshot JSON can migrate to SQLite: ${storageRootDir}`);
 			return previews.length > 0 ? { preview: previews } : null;
 		},
 		async migrateLegacyState(params) {
 			const changes = [];
 			const warnings = [];
 			const notices = [];
-			for (const storageRootDir of await collectLegacyMatrixStateRoots(params.stateDir, MATRIX_LEGACY_CRYPTO_MIGRATION_FILENAME)) {
+			for (const storageRootDir of await collectLegacyMatrixStateRoots(params.stateDir, MATRIX_LEGACY_CRYPTO_MIGRATION_FILENAME, { includeMatrixRoot: true })) {
 				const state = readLegacyMatrixLegacyCryptoMigrationState(storageRootDir);
 				if (!state) continue;
 				const store = params.context.openPluginStateKeyedStore(openMatrixLegacyCryptoMigrationStoreOptions(storageRootDir));
@@ -688,6 +722,13 @@ const stateMigrations = [
 					warnings
 				});
 			}
+			for (const storageRootDir of await collectLegacyMatrixStateRoots(params.stateDir, MATRIX_IDB_SNAPSHOT_FILENAME, { includeMatrixRoot: true })) await migrateLegacyMatrixIdbSnapshot({
+				storageRootDir,
+				context: params.context,
+				changes,
+				notices,
+				warnings
+			});
 			return {
 				changes,
 				warnings,

package/dist/{draft-stream-CTLKtJJ0.js → draft-stream-BfibauH1.js}

@@ -1,4 +1,4 @@
-import { n as editMessageMatrix, r as prepareMatrixSingleText, s as sendSingleTextMessageMatrix, y as MsgType } from "./send-BJbrdmNm.js";
+import { n as editMessageMatrix, r as prepareMatrixSingleText, s as sendSingleTextMessageMatrix, y as MsgType } from "./send-CZCmDQu8.js";
 import { createDraftStreamLoop } from "openclaw/plugin-sdk/channel-outbound";
 //#region extensions/matrix/src/matrix/draft-stream.ts
 const DEFAULT_THROTTLE_MS = 1e3;

package/dist/{file-sync-store-CPkgnSXp.js → file-sync-store-DUEWCEjb.js}

@@ -1,7 +1,7 @@
 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-CzHxeF5E.js";
+import { M as resolveMatrixSqliteStateEnv, t as claimCurrentTokenStorageState } from "./storage-BrkTJZov.js";
 import { n as LogService } from "./logger-D0GCSDQq.js";
 import { createHash, randomUUID } from "node:crypto";
 import path from "node:path";

package/dist/{http-client-BmrgOZTL.js → http-client-DOyTG9l2.js}

@@ -211,7 +211,7 @@ async function fetchWithMatrixGuardedRedirects(params) {
 				headers.delete("content-type");
 				headers.delete("content-length");
 			}
-			response.body?.cancel();
+			response.body?.cancel().catch(() => void 0);
 			await closeDispatcher(dispatcher);
 			currentUrl = nextUrl;
 		} catch (error) {

package/dist/{idb-persistence-Dyy6ipgU.js → idb-persistence-C6zQfW2w.js}

@@ -1,17 +1,24 @@
-import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
-import { D as writeMatrixIdbSnapshotJson, T as readMatrixIdbSnapshotJson, f as MATRIX_IDB_SNAPSHOT_FILENAME } from "./storage-CzHxeF5E.js";
+import { D as writeMatrixIdbSnapshotJson, f as MATRIX_IDB_SNAPSHOT_FILENAME, w as readMatrixIdbSnapshotJson } from "./storage-BrkTJZov.js";
 import { n as LogService } from "./logger-D0GCSDQq.js";
 import { n as MATRIX_IDB_SNAPSHOT_LOCK_OPTIONS } from "./idb-persistence-lock-DAJ49nZX.js";
 import path from "node:path";
 import fs from "node:fs";
-import { indexedDB } from "fake-indexeddb";
 import { withFileLock } from "openclaw/plugin-sdk/file-lock";
+import { indexedDB } from "fake-indexeddb";
 //#region extensions/matrix/src/matrix/sdk/idb-persistence.ts
-var idb_persistence_exports = /* @__PURE__ */ __exportAll({
-	persistIdbToDisk: () => persistIdbToDisk,
-	readLegacyMatrixIdbSnapshotState: () => readLegacyMatrixIdbSnapshotState,
-	restoreIdbFromDisk: () => restoreIdbFromDisk
-});
+const LEGACY_SNAPSHOT_DIAGNOSTIC = {
+	code: "matrix-idb-snapshot-requires-doctor",
+	message: "Matrix IndexedDB snapshot exists outside canonical SQLite state",
+	remediation: "openclaw doctor --fix"
+};
+var MatrixIdbSnapshotMigrationRequiredError = class extends Error {
+	constructor() {
+		super(`${LEGACY_SNAPSHOT_DIAGNOSTIC.message}; run ${LEGACY_SNAPSHOT_DIAGNOSTIC.remediation}`);
+		this.code = LEGACY_SNAPSHOT_DIAGNOSTIC.code;
+		this.remediation = LEGACY_SNAPSHOT_DIAGNOSTIC.remediation;
+		this.name = "MatrixIdbSnapshotMigrationRequiredError";
+	}
+};
 function isValidIdbIndexSnapshot(value) {
 	if (!value || typeof value !== "object") return false;
 	const candidate = value;
@@ -38,6 +45,13 @@ function parseSnapshotPayload(data) {
 	if (!parsed.every((entry) => isValidIdbDatabaseSnapshot(entry))) throw new Error("Malformed IndexedDB snapshot payload");
 	return parsed;
 }
+function isValidMatrixIdbSnapshotJson(data) {
+	try {
+		return parseSnapshotPayload(data) !== null;
+	} catch {
+		return false;
+	}
+}
 function idbReq(req) {
 	return new Promise((resolve, reject) => {
 		req.addEventListener("success", () => resolve(req.result), { once: true });
@@ -135,88 +149,83 @@ function resolveDefaultIdbSnapshotPath() {
 	return path.join(stateDir, "matrix", "crypto-idb-snapshot.json");
 }
 async function restoreIdbFromDisk(snapshotPath) {
-	const candidatePaths = snapshotPath ? [snapshotPath] : [resolveDefaultIdbSnapshotPath()];
-	for (const resolvedPath of candidatePaths) {
-		const storageRootDir = path.dirname(resolvedPath);
-		try {
-			if (await withFileLock(resolvedPath, MATRIX_IDB_SNAPSHOT_LOCK_OPTIONS, async () => {
-				try {
-					const storedSnapshotJson = readMatrixIdbSnapshotJson(storageRootDir);
-					if (storedSnapshotJson) {
-						const snapshot = parseSnapshotPayload(storedSnapshotJson);
-						if (snapshot) {
-							await restoreIndexedDatabases(snapshot);
-							LogService.info("IdbPersistence", `Restored ${snapshot.length} IndexedDB database(s) from Matrix SQLite state`);
-							return true;
-						}
-					}
-				} catch (err) {
-					LogService.warn("IdbPersistence", "Failed to restore IndexedDB snapshot from SQLite:", err);
-				}
-				if (!fs.existsSync(resolvedPath)) return false;
-				const data = fs.readFileSync(resolvedPath, "utf8");
-				const snapshot = parseSnapshotPayload(data);
-				if (!snapshot) return false;
-				let migratedToSqlite = false;
-				try {
-					writeMatrixIdbSnapshotJson({
-						storageRootDir,
-						snapshotJson: data,
-						databaseCount: snapshot.length
-					});
-					archiveLegacyIdbSnapshotFile(resolvedPath);
-					migratedToSqlite = true;
-				} catch (err) {
-					LogService.warn("IdbPersistence", `Failed to migrate IndexedDB snapshot to SQLite from ${resolvedPath}:`, err);
-				}
-				await restoreIndexedDatabases(snapshot);
-				LogService.info("IdbPersistence", migratedToSqlite ? `Migrated and restored ${snapshot.length} IndexedDB database(s) from ${resolvedPath}` : `Restored ${snapshot.length} IndexedDB database(s) from legacy snapshot ${resolvedPath}`);
-				return true;
-			})) return true;
-		} catch (err) {
-			LogService.warn("IdbPersistence", `Failed to restore IndexedDB snapshot from ${resolvedPath}:`, err);
-			continue;
-		}
+	const resolvedPath = snapshotPath ?? resolveDefaultIdbSnapshotPath();
+	const storageRootDir = path.dirname(resolvedPath);
+	let callbackStarted = false;
+	try {
+		return await withFileLock(resolvedPath, MATRIX_IDB_SNAPSHOT_LOCK_OPTIONS, async () => {
+			callbackStarted = true;
+			let storedSnapshotJson;
+			try {
+				storedSnapshotJson = readMatrixIdbSnapshotJson(storageRootDir);
+			} catch (err) {
+				if (fs.existsSync(resolvedPath)) throwLegacySnapshotMigrationRequired();
+				throw err;
+			}
+			throwIfLegacySnapshotNeedsDoctor(resolvedPath, storedSnapshotJson);
+			if (!storedSnapshotJson) return false;
+			const snapshot = parseSnapshotPayload(storedSnapshotJson);
+			if (!snapshot) return false;
+			await restoreIndexedDatabases(snapshot);
+			LogService.info("IdbPersistence", `Restored ${snapshot.length} IndexedDB database(s) from Matrix SQLite state`);
+			return true;
+		});
+	} catch (err) {
+		if (err instanceof MatrixIdbSnapshotMigrationRequiredError) throw err;
+		if (!callbackStarted && fs.existsSync(resolvedPath)) throwLegacySnapshotMigrationRequired();
+		LogService.warn("IdbPersistence", "Failed to restore IndexedDB snapshot from SQLite:", err);
+		return false;
 	}
-	return false;
 }
 async function persistIdbToDisk(params) {
 	const snapshotPath = params?.snapshotPath ?? resolveDefaultIdbSnapshotPath();
+	let callbackStarted = false;
 	try {
 		fs.mkdirSync(path.dirname(snapshotPath), { recursive: true });
 		const persistedCount = await withFileLock(snapshotPath, MATRIX_IDB_SNAPSHOT_LOCK_OPTIONS, async () => {
+			callbackStarted = true;
+			const storageRootDir = path.dirname(snapshotPath);
+			let storedSnapshotJson;
+			try {
+				storedSnapshotJson = readMatrixIdbSnapshotJson(storageRootDir);
+			} catch (err) {
+				if (fs.existsSync(snapshotPath)) throwLegacySnapshotMigrationRequired();
+				throw err;
+			}
+			throwIfLegacySnapshotNeedsDoctor(snapshotPath, storedSnapshotJson);
 			const snapshot = await dumpIndexedDatabases(params?.databasePrefix);
 			if (snapshot.length === 0) return 0;
 			writeMatrixIdbSnapshotJson({
-				storageRootDir: path.dirname(snapshotPath),
+				storageRootDir,
 				snapshotJson: JSON.stringify(snapshot),
 				databaseCount: snapshot.length
 			});
-			archiveLegacyIdbSnapshotFile(snapshotPath);
 			return snapshot.length;
 		});
 		if (persistedCount === 0) return;
 		LogService.debug("IdbPersistence", `Persisted ${persistedCount} IndexedDB database(s) to Matrix SQLite state`);
 	} catch (err) {
+		if (err instanceof MatrixIdbSnapshotMigrationRequiredError) throw err;
+		if (!callbackStarted && fs.existsSync(snapshotPath)) throwLegacySnapshotMigrationRequired();
 		LogService.warn("IdbPersistence", "Failed to persist IndexedDB snapshot:", err);
 	}
 }
-async function readLegacyMatrixIdbSnapshotState(storageRootDir) {
+function readLegacyMatrixIdbSnapshotStateUnlocked(storageRootDir) {
 	const snapshotPath = path.join(storageRootDir, MATRIX_IDB_SNAPSHOT_FILENAME);
 	if (!fs.existsSync(snapshotPath)) return null;
+	const data = fs.readFileSync(snapshotPath, "utf8");
 	try {
-		return await withFileLock(snapshotPath, MATRIX_IDB_SNAPSHOT_LOCK_OPTIONS, async () => {
-			return parseSnapshotPayload(fs.readFileSync(snapshotPath, "utf8"));
-		});
+		return parseSnapshotPayload(data);
 	} catch {
 		return null;
 	}
 }
-function archiveLegacyIdbSnapshotFile(snapshotPath) {
-	if (!fs.existsSync(snapshotPath)) return;
-	const archivedPath = `${snapshotPath}.migrated`;
-	if (fs.existsSync(archivedPath)) return;
-	fs.renameSync(snapshotPath, archivedPath);
+function throwIfLegacySnapshotNeedsDoctor(snapshotPath, storedSnapshotJson) {
+	if (fs.existsSync(snapshotPath) && (!storedSnapshotJson || !isValidMatrixIdbSnapshotJson(storedSnapshotJson))) throwLegacySnapshotMigrationRequired();
+}
+function throwLegacySnapshotMigrationRequired() {
+	LogService.warn("IdbPersistence", LEGACY_SNAPSHOT_DIAGNOSTIC);
+	throw new MatrixIdbSnapshotMigrationRequiredError();
 }
 function toLintErrorObject(value, fallbackMessage) {
 	if (value instanceof Error) return value;
@@ -226,4 +235,4 @@ function toLintErrorObject(value, fallbackMessage) {
 	return error;
 }
 //#endregion
-export { restoreIdbFromDisk as i, persistIdbToDisk as n, readLegacyMatrixIdbSnapshotState as r, idb_persistence_exports as t };
+export { restoreIdbFromDisk as i, persistIdbToDisk as n, readLegacyMatrixIdbSnapshotStateUnlocked as r, isValidMatrixIdbSnapshotJson as t };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { n as registerMatrixCliMetadata } from "./cli-metadata-Xq1Xb15R.js";
+import { n as registerMatrixCliMetadata } from "./cli-metadata-DAhDhbYX.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/{media-text-BMXEXb1j.js → media-text-Cv1VIHXW.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-BJbrdmNm.js";
+import { C as formatPollResultsAsText, D as parsePollStartContent, O as resolvePollReferenceEventId, S as formatPollAsText, T as isPollStartType, w as isPollEventType, x as buildPollResultsSummary } from "./send-CZCmDQu8.js";
 import path from "node:path";
 //#region extensions/matrix/src/matrix/poll-summary.ts
 function resolveMatrixPollRootEventId(event) {

package/dist/{messages-3UBHfZrN.js → messages-ClTgfFl6.js}

@@ -1,8 +1,8 @@
 import { r as isMatrixNotFoundError } from "./errors-C47hvAF8.js";
-import { T as isPollStartType, a as sendMessageMatrix, n as editMessageMatrix, w as isPollEventType } from "./send-BJbrdmNm.js";
+import { T as isPollStartType, a as sendMessageMatrix, n as editMessageMatrix, w as isPollEventType } from "./send-CZCmDQu8.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-BMXEXb1j.js";
-import { r as withResolvedRoomAction } from "./client-BtG4quUl.js";
+import { a as resolveMatrixMessageAttachment, l as resolveMatrixPollRootEventId, o as resolveMatrixMessageBody, s as fetchMatrixPollMessageSummary } from "./media-text-Cv1VIHXW.js";
+import { r as withResolvedRoomAction } from "./client-BwX6rURh.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

package/dist/{monitor-BtUIds8T.js → monitor-2BjKS9RV.js}

@@ -1,21 +1,21 @@
 import { a as resolveMatrixAccountConfig, i as resolveMatrixAccountAllowlistConfig } from "./account-config-BZWN9tGS.js";
 import { t as getMatrixRuntime } from "./runtime-6S3DNFNv.js";
-import { m as resolveConfiguredMatrixBotUserIds } from "./setup-core-XCdAx1nY.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-j331Xd7b.js";
-import { a as normalizeMatrixUserId, i as normalizeMatrixAllowList, o as resolveMatrixAllowListMatch } from "./config-schema-B5GRV8wL.js";
+import { h as resolveConfiguredMatrixBotUserIds } from "./setup-core-D6gyoyeg.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-MBtrY36B.js";
+import { a as normalizeMatrixUserId, i as normalizeMatrixAllowList, o as resolveMatrixAllowListMatch } from "./config-schema-CggnuwnJ.js";
 import { t as isMatrixQualifiedUserId } from "./target-ids-B-5aQxwn.js";
 import { t as formatMatrixErrorMessage } from "./errors-C47hvAF8.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-BJbrdmNm.js";
-import { t as createMatrixThreadBindingManager } from "./thread-bindings-Cw194yEn.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-CZCmDQu8.js";
+import { t as createMatrixThreadBindingManager } from "./thread-bindings-BcYBELC7.js";
 import { i as createMatrixInboundEventDeduper } from "./inbound-dedupe-CaBLblef.js";
-import { a as resolveMatrixMessageAttachment, c as fetchMatrixPollSnapshot, i as isLikelyBareFilename, n as formatMatrixMediaUnavailableText, o as resolveMatrixMessageBody, r as formatMatrixMessageText, t as formatMatrixMediaTooLargeText } from "./media-text-BMXEXb1j.js";
+import { a as resolveMatrixMessageAttachment, c as fetchMatrixPollSnapshot, i as isLikelyBareFilename, n as formatMatrixMediaUnavailableText, o as resolveMatrixMessageBody, r as formatMatrixMessageText, t as formatMatrixMediaTooLargeText } from "./media-text-Cv1VIHXW.js";
 import { n as setActiveMatrixClient } from "./active-client-DXvz2gCo.js";
 import { t as isBunRuntime } from "./runtime-BefyhPWv.js";
-import { d as backfillMatrixAuthDeviceIdAfterStartup, f as resolveMatrixAuth, i as resolveSharedMatrixClient, l as isMatrixStartupAbortError, n as releaseSharedClientInstance, p as resolveMatrixAuthContext, u as throwIfMatrixStartupAborted } from "./shared-DquM1oz6.js";
-import "./client-CA0PULls.js";
-import { i as isMatrixMediaSizeLimitError, r as MatrixMediaSizeLimitError } from "./http-client-BmrgOZTL.js";
+import { d as backfillMatrixAuthDeviceIdAfterStartup, f as resolveMatrixAuth, i as resolveSharedMatrixClient, l as isMatrixStartupAbortError, n as releaseSharedClientInstance, p as resolveMatrixAuthContext, u as throwIfMatrixStartupAborted } from "./shared-C7Vm9RxI.js";
+import "./client-Dg8dk8NW.js";
+import { i as isMatrixMediaSizeLimitError, r as MatrixMediaSizeLimitError } from "./http-client-DOyTG9l2.js";
 import { d as resolveAllowlistProviderRuntimeGroupPolicy, f as resolveDefaultGroupPolicy, g as warnMissingProviderGroupPolicyFallbackOnce, h as resolveThreadBindingMaxAgeMsForChannel, m as resolveThreadBindingIdleTimeoutMsForChannel, t as GROUP_POLICY_BLOCKED_LABEL } from "./runtime-api-D1xI_cvh.js";
-import { t as resolveMatrixTargets } from "./resolve-targets-DVoj-YxB.js";
+import { t as resolveMatrixTargets } from "./resolve-targets-Dn11HT76.js";
 import { t as formatMatrixEncryptedEventDisabledWarning } from "./encryption-guidance-CbEFe38F.js";
 import { n as isMatrixReadySyncState, r as isMatrixTerminalSyncState, t as isMatrixDisconnectedSyncState } from "./sync-state-CWbp0QSY.js";
 import { a as EventType, i as resolveMatrixThreadRouting, n as resolveMatrixReplyToEventId, o as RelationType, r as resolveMatrixThreadRootId, t as resolveMatrixInboundRoute } from "./route-DY6at4qJ.js";
@@ -818,7 +818,7 @@ const matrixVerificationConstants = {
 const MAX_TRACKED_VERIFICATION_EVENTS = 1024;
 const SAS_NOTICE_RETRY_DELAY_MS = 750;
 const VERIFICATION_EVENT_STARTUP_GRACE_MS = 3e4;
-const loadMatrixDirectRoomDeps = createLazyRuntimeModule(() => Promise.all([import("./send-BJbrdmNm.js").then((n) => n.d), import("./send-BJbrdmNm.js").then((n) => n.m)]).then(([directManagementModule, directRoomModule]) => ({
+const loadMatrixDirectRoomDeps = createLazyRuntimeModule(() => Promise.all([import("./send-CZCmDQu8.js").then((n) => n.d), import("./send-CZCmDQu8.js").then((n) => n.m)]).then(([directManagementModule, directRoomModule]) => ({
 	inspectMatrixDirectRooms: directManagementModule.inspectMatrixDirectRooms,
 	isStrictDirectRoom: directRoomModule.isStrictDirectRoom
 })));
@@ -1691,8 +1691,10 @@ async function resolveMatrixPreflightAudioTranscript(params) {
 		if (params.abortSignal?.aborted) return;
 		const transcript = await transcribeFirstAudio({
 			ctx: {
-				MediaPaths: [params.mediaPath],
-				MediaTypes: params.mediaContentType ? [params.mediaContentType] : void 0,
+				media: [{
+					path: params.mediaPath,
+					contentType: params.mediaContentType
+				}],
 				Provider: "matrix",
 				Surface: "matrix",
 				OriginatingChannel: "matrix",
@@ -2205,11 +2207,11 @@ function createMatrixThreadContextResolver(params) {
 const ALLOW_FROM_STORE_CACHE_TTL_MS = 3e4;
 const PAIRING_REPLY_COOLDOWN_MS = 5 * 6e4;
 const MATRIX_TOOL_PROGRESS_MAX_CHARS = 300;
-const loadMatrixSendModule = createLazyRuntimeModule(() => import("./send-BJbrdmNm.js").then((n) => n.l));
+const loadMatrixSendModule = createLazyRuntimeModule(() => import("./send-CZCmDQu8.js").then((n) => n.l));
 const loadAcpBindingRuntime = createLazyRuntimeModule(() => import("openclaw/plugin-sdk/acp-binding-runtime"));
 const loadSessionBindingRuntime = createLazyRuntimeModule(() => import("openclaw/plugin-sdk/session-binding-runtime"));
-const loadMatrixReactionEvents = createLazyRuntimeModule(() => import("./reaction-events-BwAKtUyQ.js"));
-const loadMatrixDraftStream = createLazyRuntimeModule(() => import("./draft-stream-CTLKtJJ0.js"));
+const loadMatrixReactionEvents = createLazyRuntimeModule(() => import("./reaction-events-Cj6thhmc.js"));
+const loadMatrixDraftStream = createLazyRuntimeModule(() => import("./draft-stream-BfibauH1.js"));
 async function matrixTextWouldActivateMentions(client, text) {
 	const { resolveMatrixMentionsForBody } = await loadMatrixSendModule();
 	const mentions = await resolveMatrixMentionsForBody({
@@ -2797,7 +2799,7 @@ function createMatrixRoomMessageHandler(params) {
 					cfg,
 					surface: "matrix"
 				});
-				const useAccessGroups = cfg.commands?.useAccessGroups !== false;
+				const useAccessGroups = true;
 				const commandCheckText = stripMatrixMentionPrefix({
 					text: mentionPrecheckText,
 					userId: selfUserId,
@@ -3146,6 +3148,7 @@ function createMatrixRoomMessageHandler(params) {
 					bodyForAgent: bodyText,
 					inboundHistory: inboundHistory && inboundHistory.length > 0 ? inboundHistory : void 0
 				},
+				sessionTranscript: { historyLimit: isRoom ? historyLimit : 0 },
 				access: {
 					...isRoom ? { mentions: {
 						canDetectMention: true,
@@ -3805,10 +3808,10 @@ function shouldPromoteRecentInviteRoom(params) {
 //#endregion
 //#region extensions/matrix/src/matrix/monitor/startup.ts
 const loadMatrixStartupMaintenanceDeps = createLazyRuntimeModule(() => Promise.all([
-	import("./setup-core-XCdAx1nY.js").then((n) => n.s),
+	import("./setup-core-D6gyoyeg.js").then((n) => n.c),
 	import("./device-health-D4LBxuPq.js"),
-	import("./setup-core-XCdAx1nY.js").then((n) => n.a),
-	import("./startup-verification-CA00kebL.js")
+	import("./setup-core-D6gyoyeg.js").then((n) => n.o),
+	import("./startup-verification-D1nscMh8.js")
 ]).then(([configUpdateModule, deviceHealthModule, profileModule, startupVerificationModule]) => ({
 	updateMatrixAccountConfig: configUpdateModule.updateMatrixAccountConfig,
 	summarizeMatrixDeviceHealth: deviceHealthModule.summarizeMatrixDeviceHealth,

package/dist/plugin-entry.handlers.runtime.js

@@ -2,7 +2,7 @@ import { t as formatMatrixErrorMessage } from "./errors-C47hvAF8.js";
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 //#region extensions/matrix/src/plugin-entry.runtime.ts
-const loadMatrixVerificationRuntime = createLazyRuntimeModule(() => import("./verification-DjxyWTNP.js").then((n) => n.y));
+const loadMatrixVerificationRuntime = createLazyRuntimeModule(() => import("./verification-DhMBWxOJ.js").then((n) => n.y));
 function sendError(respond, err) {
 	respond(false, { error: formatMatrixErrorMessage(err) });
 }