@openclaw/matrix 2026.8.2 → 2026.9.1

package/dist/doctor-contract-api.js

@@ -2,99 +2,74 @@ import { a as resolveMatrixDefaultOrOnlyAccountId, n as requiresExplicitMatrixDe
 import { i as normalizeMatrixStoredCredentials, n as isMatrixCredentialRevocation, r as matrixCredentialsStoreKey, t as MATRIX_CREDENTIALS_NAMESPACE } from "./credentials-state-B3cuUFwZ.js";
 import { r as resolveMatrixCredentialsDir } from "./storage-paths-gUmSydsW.js";
 import { n as normalizeCompatibilityConfig, t as legacyConfigRules } from "./doctor-contract-HyWFZQVG.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-BVf4uucD.js";
+import { C as readLegacyMatrixRecoveryKeyState, M as resolveMatrixSqliteStateEnv, 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, x as readLegacyMatrixLegacyCryptoMigrationState, y as openMatrixLegacyCryptoMigrationStoreOptions } from "./storage-BVf4uucD.js";
 import { a as readLegacyMatrixSyncCacheState, c as writeMatrixSyncCacheStateToStore, i as openMatrixSyncCacheStoreOptions, r as hasMatrixSyncCacheStateInStore } from "./sync-cache-state-d-A_OhbU.js";
-import { n as MATRIX_IDB_SNAPSHOT_LOCK_OPTIONS } from "./idb-persistence-lock-B3fZXyF_.js";
-import { r as readLegacyMatrixIdbSnapshotStateUnlocked, t as isValidMatrixIdbSnapshotJson } from "./idb-persistence-D4NGNQxt.js";
 import { isRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { normalizeAccountId } from "openclaw/plugin-sdk/account-id";
-import { createHash, randomUUID } from "node:crypto";
+import { createHash } from "node:crypto";
 import path from "node:path";
 import { archiveLegacyStateSource } from "openclaw/plugin-sdk/runtime-doctor-migrations";
-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";
-//#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) {
+import fs from "node:fs/promises";
+//#region extensions/matrix/src/matrix/account-state-schema-doctor.ts
+const STATE_DATABASE_FILENAME = "openclaw.sqlite";
+async function collectMatrixAccountStateRoots(stateDir) {
+	const accountsRoot = path.join(stateDir, "matrix", "accounts");
+	const roots = /* @__PURE__ */ new Set();
+	async function visit(dir, allowMissing = false) {
+		let entries;
 		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;
+			entries = await fs.readdir(dir, { withFileTypes: true });
+		} catch (error) {
+			if (allowMissing && typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT") return;
+			throw error;
 		}
-		if (!persisted || !snapshotContentMatches(persisted, snapshot)) {
-			params.warnings.push(`Failed verifying Matrix IndexedDB snapshot for ${params.storageRootDir}; left legacy source in place`);
-			return;
+		for (const entry of entries) {
+			const entryPath = path.join(dir, entry.name);
+			if (entry.isFile() && entry.name === STATE_DATABASE_FILENAME && path.basename(dir) === "state") roots.add(path.dirname(dir));
+			else if (entry.isDirectory()) await visit(entryPath);
 		}
-		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);
+	await visit(accountsRoot, true);
+	return [...roots].toSorted();
 }
-function snapshotContentMatches(persistedJson, snapshot) {
-	try {
-		return isDeepStrictEqual(JSON.parse(persistedJson), snapshot);
-	} catch {
-		return false;
-	}
+function describeMatrixAccountStateMigration(storageRootDir, migration) {
+	return `Matrix account SQLite schema migration (${migration.kind}): ${storageRootDir}`;
 }
-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;
+const matrixAccountStateSchemaMigration = {
+	id: "matrix-account-sqlite-schema",
+	label: "Matrix account SQLite schemas",
+	async detectLegacyState(params) {
+		const { detectOpenClawStateDatabaseSchemaMigrations } = await import("openclaw/plugin-sdk/doctor-repair-runtime");
+		const preview = [];
+		for (const storageRootDir of await collectMatrixAccountStateRoots(params.stateDir)) {
+			const env = resolveMatrixSqliteStateEnv({
+				env: params.env,
+				stateDir: storageRootDir
+			});
+			preview.push(...detectOpenClawStateDatabaseSchemaMigrations({ env }).map((migration) => describeMatrixAccountStateMigration(storageRootDir, migration)));
+		}
+		return preview.length > 0 ? { preview } : null;
+	},
+	async migrateLegacyState(params) {
+		const { detectOpenClawStateDatabaseSchemaMigrations, repairOpenClawStateDatabaseSchema } = await import("openclaw/plugin-sdk/doctor-repair-runtime");
+		const changes = [];
+		const warnings = [];
+		for (const storageRootDir of await collectMatrixAccountStateRoots(params.stateDir)) {
+			const env = resolveMatrixSqliteStateEnv({
+				env: params.env,
+				stateDir: storageRootDir
+			});
+			if (detectOpenClawStateDatabaseSchemaMigrations({ env }).length === 0) continue;
+			const repaired = repairOpenClawStateDatabaseSchema({ env });
+			changes.push(...repaired.changes.map((change) => `Matrix account SQLite ${storageRootDir}: ${change}`));
+			warnings.push(...repaired.warnings.map((warning) => `Matrix account SQLite ${storageRootDir}: ${warning}`));
+		}
+		return {
+			changes,
+			warnings
+		};
 	}
-}
+};
 //#endregion
 //#region extensions/matrix/src/matrix/monitor/inbound-dedupe-migration.ts
 const LEGACY_SQLITE_NAMESPACE = "inbound-dedupe";
@@ -143,7 +118,7 @@ async function collectMatrixInboundDedupeSources(stateDir) {
 	async function visit(dir, allowMissing = false) {
 		let entries;
 		try {
-			entries = await fs$1.readdir(dir, { withFileTypes: true });
+			entries = await fs.readdir(dir, { withFileTypes: true });
 		} catch (err) {
 			if (allowMissing && err.code === "ENOENT") return;
 			warnings.push(`Failed scanning Matrix inbound dedupe sources under ${dir}: ${String(err)}`);
@@ -269,7 +244,7 @@ async function verifyMatrixInboundDedupeSourcesRetired(stateDir) {
 }
 async function resolveJsonRootAccountId(storageRootDir) {
 	for (const filename of [STORAGE_META_FILENAME, `${STORAGE_META_FILENAME}.migrated`]) try {
-		const metadata = normalizeMatrixStorageMetadata(JSON.parse(await fs$1.readFile(path.join(storageRootDir, filename), "utf8")));
+		const metadata = normalizeMatrixStorageMetadata(JSON.parse(await fs.readFile(path.join(storageRootDir, filename), "utf8")));
 		if (metadata?.accountId) return metadata.accountId;
 	} catch {}
 	return "default";
@@ -281,7 +256,7 @@ async function resolveJsonRootAccountId(storageRootDir) {
 */
 async function readLegacyInboundDedupeJsonSource(storageRootDir) {
 	const jsonPath = path.join(storageRootDir, MATRIX_LEGACY_INBOUND_DEDUPE_FILENAME);
-	const raw = await fs$1.readFile(jsonPath, "utf8");
+	const raw = await fs.readFile(jsonPath, "utf8");
 	let parsed;
 	try {
 		parsed = JSON.parse(raw);
@@ -389,7 +364,7 @@ async function collectLegacyMatrixCredentialSources(params) {
 	const credentialsDir = resolveMatrixCredentialsDir(params.stateDir);
 	let entries;
 	try {
-		entries = await fs$1.readdir(credentialsDir, { withFileTypes: true });
+		entries = await fs.readdir(credentialsDir, { withFileTypes: true });
 	} catch {
 		return [];
 	}
@@ -408,8 +383,8 @@ async function collectLegacyMatrixCredentialSources(params) {
 async function readLegacyMatrixCredentials(source) {
 	if (!source.accountId) return null;
 	try {
-		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();
+		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();
 		return normalizeMatrixStoredCredentials(isRecord(raw) ? {
 			...raw,
 			createdAt
@@ -424,7 +399,7 @@ async function collectLegacyMatrixStateRoots(stateDir, filename, options) {
 	async function visit(dir) {
 		let entries;
 		try {
-			entries = await fs$1.readdir(dir, { withFileTypes: true });
+			entries = await fs.readdir(dir, { withFileTypes: true });
 		} catch {
 			return;
 		}
@@ -440,12 +415,18 @@ async function collectLegacyMatrixStateRoots(stateDir, filename, options) {
 	await visit(matrixRoot);
 	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* readLegacyMatrixSyncCaches(stateDir) {
+	for (const storageRootDir of await collectLegacyMatrixStateRoots(stateDir, MATRIX_SYNC_CACHE_FILENAME)) {
+		const persisted = await readLegacyMatrixSyncCacheState(storageRootDir);
+		if (persisted) yield {
+			storageRootDir,
+			persisted
+		};
+	}
 }
 async function readLegacyMatrixStorageMetadata(storageRootDir) {
 	try {
-		return normalizeMatrixStorageMetadata(JSON.parse(await fs$1.readFile(path.join(storageRootDir, MATRIX_STORAGE_META_FILENAME), "utf8")));
+		return normalizeMatrixStorageMetadata(JSON.parse(await fs.readFile(path.join(storageRootDir, MATRIX_STORAGE_META_FILENAME), "utf8")));
 	} catch {
 		return null;
 	}
@@ -468,6 +449,7 @@ async function archiveLegacyMatrixStateFile(params) {
 	if (params.notice && params.warnings.length === warningCount) params.notices?.push(params.notice);
 }
 const stateMigrations = [
+	matrixAccountStateSchemaMigration,
 	{
 		id: "matrix-credentials-json-to-plugin-state",
 		label: "Matrix credentials",
@@ -698,19 +680,14 @@ const stateMigrations = [
 		label: "Matrix sync cache",
 		async detectLegacyState(params) {
 			const previews = [];
-			for (const storageRootDir of await collectLegacySyncCacheRoots(params.stateDir)) {
-				if (!await readLegacyMatrixSyncCacheState(storageRootDir)) continue;
-				previews.push(`Matrix sync cache JSON can migrate to SQLite: ${storageRootDir}`);
-			}
+			for await (const { storageRootDir } of readLegacyMatrixSyncCaches(params.stateDir)) previews.push(`Matrix sync cache 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 collectLegacySyncCacheRoots(params.stateDir)) {
-				const persisted = await readLegacyMatrixSyncCacheState(storageRootDir);
-				if (!persisted) continue;
+			for await (const { storageRootDir, persisted } of readLegacyMatrixSyncCaches(params.stateDir)) {
 				const store = params.context.openPluginStateKeyedStore(openMatrixSyncCacheStoreOptions(storageRootDir));
 				if (await hasMatrixSyncCacheStateInStore({
 					storageRootDir,
@@ -840,13 +817,16 @@ 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
-			});
+			for (const storageRootDir of await collectLegacyMatrixStateRoots(params.stateDir, MATRIX_IDB_SNAPSHOT_FILENAME, { includeMatrixRoot: true })) {
+				const { migrateLegacyMatrixIdbSnapshot } = await import("./crypto-snapshot-doctor.runtime-D0v841D_.js");
+				await migrateLegacyMatrixIdbSnapshot({
+					storageRootDir,
+					context: params.context,
+					changes,
+					notices,
+					warnings
+				});
+			}
 			return {
 				changes,
 				warnings,

package/dist/{draft-stream-DhGHVdO4.js → draft-stream-DPYdv4fE.js}

@@ -1,4 +1,4 @@
-import { T as MsgType, a as sendSingleTextMessageMatrix, c as prepareMatrixSingleText, t as editMessageMatrix } from "./send-DfS5ciUL.js";
+import { T as MsgType, a as sendSingleTextMessageMatrix, c as prepareMatrixSingleText, t as editMessageMatrix } from "./send-DG7Bnj7_.js";
 import { createFinalizableDraftStreamControlsForState } from "openclaw/plugin-sdk/channel-outbound";
 //#region extensions/matrix/src/matrix/draft-stream.ts
 const DEFAULT_THROTTLE_MS = 1e3;

package/dist/index.js

@@ -1,4 +1,4 @@
-import { n as registerMatrixCliMetadata } from "./cli-metadata-Mtzu5-AY.js";
+import { n as registerMatrixCliMetadata } from "./cli-metadata-B7MQjR5S.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/{messages-DlMQaC02.js → messages-C1U3b1oN.js}

@@ -1,6 +1,6 @@
 import { n as MATRIX_REACTION_EVENT_TYPE } from "./reaction-common-DkrQdBSZ.js";
-import { _ as resolvePollReferenceEventId, d as formatPollAsText, f as formatPollResultsAsText, g as parsePollStartContent, m as isPollStartType, p as isPollEventType, r as sendMessageMatrix, t as editMessageMatrix, u as buildPollResultsSummary } from "./send-DfS5ciUL.js";
-import { r as withResolvedRoomAction } from "./client-B0yMDho1.js";
+import { _ as resolvePollReferenceEventId, d as formatPollAsText, f as formatPollResultsAsText, g as parsePollStartContent, m as isPollStartType, p as isPollEventType, r as sendMessageMatrix, t as editMessageMatrix, u as buildPollResultsSummary } from "./send-DG7Bnj7_.js";
+import { r as withResolvedRoomAction } from "./client-D2utPQ1E.js";
 import { n as isMatrixNotFoundError } from "./errors-DKVS3_DO.js";
 import { asNullableObjectRecord, asNullableRecord, normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import path from "node:path";

package/dist/{monitor-U2LcVtHt.js → monitor-SNnu-0bp.js}

@@ -1,21 +1,22 @@
 import { a as resolveMatrixAccountConfig, i as resolveMatrixAccountAllowlistConfig } from "./account-config-CRsKoMqJ.js";
 import { t as getMatrixRuntime } from "./runtime-6S3DNFNv.js";
 import { n as resolveConfiguredMatrixBotUserIds } from "./accounts-DR1c4xF_.js";
-import { _ as logInboundDrop, a as resolveMatrixThreadRootId, b as summarizeMapping, c as RelationType, d as buildAllowlistResolutionSummary, f as canonicalizeAllowlistWithResolvedIds, g as getAgentScopedMediaLocalRoots, h as formatLocationText, i as resolveMatrixReplyToEventId, l as resolveMatrixRoomConfig, m as createTypingCallbacks, n as resolveMatrixStoredSessionMeta, o as resolveMatrixThreadRouting, p as createReplyPrefixOptions, r as resolveMatrixInboundRoute, s as EventType, u as addAllowlistUserEntriesFromConfigEntry, v as logTypingFailure, x as toLocationContext, y as patchAllowlistUsersInConfigEntries } from "./channel-D6-ajB_u.js";
-import { a as normalizeMatrixUserId, i as normalizeMatrixAllowList, o as resolveMatrixAllowListMatch } from "./channel.setup-OIEzCzSs.js";
+import { _ as logInboundDrop, a as resolveMatrixThreadRootId, b as summarizeMapping, c as RelationType, d as buildAllowlistResolutionSummary, f as canonicalizeAllowlistWithResolvedIds, g as getAgentScopedMediaLocalRoots, h as formatLocationText, i as resolveMatrixReplyToEventId, l as resolveMatrixRoomConfig, m as createTypingCallbacks, n as resolveMatrixStoredSessionMeta, o as resolveMatrixThreadRouting, p as createReplyPrefixOptions, r as resolveMatrixInboundRoute, s as EventType, u as addAllowlistUserEntriesFromConfigEntry, v as logTypingFailure, x as toLocationContext, y as patchAllowlistUsersInConfigEntries } from "./channel-b-jES-oi.js";
+import { a as normalizeMatrixUserId, i as normalizeMatrixAllowList, o as resolveMatrixAllowListMatch } from "./channel.setup-BY42QaL7.js";
 import { n as isMatrixRoomId, t as isMatrixQualifiedUserId } from "./target-ids-Nwx7cMVE.js";
-import { S as promoteMatrixDirectRoomCandidate, d as formatPollAsText, g as parsePollStartContent, m as isPollStartType, p as isPollEventType, r as sendMessageMatrix, w as MATRIX_OPENCLAW_FINALIZED_PREVIEW_KEY } from "./send-DfS5ciUL.js";
+import { S as promoteMatrixDirectRoomCandidate, d as formatPollAsText, g as parsePollStartContent, m as isPollStartType, p as isPollEventType, r as sendMessageMatrix, w as MATRIX_OPENCLAW_FINALIZED_PREVIEW_KEY } from "./send-DG7Bnj7_.js";
 import { i as isStrictDirectMembership, n as hasDirectMatrixMemberFlag, o as readJoinedMatrixMembers } from "./direct-room-RinHjtqX.js";
-import { t as createMatrixThreadBindingManager } from "./thread-bindings-2HN2AyLu.js";
-import { c as formatMatrixMediaTooLargeText, d as isLikelyBareFilename, f as resolveBundledMatrixReplacementContent, l as formatMatrixMediaUnavailableText, m as fetchMatrixPollSnapshot, r as readMatrixMessages, u as formatMatrixMessageText } from "./messages-DlMQaC02.js";
+import { t as createMatrixThreadBindingManager } from "./thread-bindings-DgxQEB99.js";
+import { c as formatMatrixMediaTooLargeText, d as isLikelyBareFilename, f as resolveBundledMatrixReplacementContent, l as formatMatrixMediaUnavailableText, m as fetchMatrixPollSnapshot, r as readMatrixMessages, u as formatMatrixMessageText } from "./messages-C1U3b1oN.js";
 import { t as isBunRuntime } from "./runtime-BefyhPWv.js";
-import { a as throwIfMatrixStartupAborted, c as backfillMatrixAuthDeviceIdAfterStartup, i as isMatrixStartupAbortError, l as resolveMatrixAuth, n as acquireSharedMatrixClient, o as createMatrixMonitorTaskRunner, u as resolveMatrixAuthContext } from "./client-DFsRJEgB.js";
+import { a as throwIfMatrixStartupAborted, c as backfillMatrixAuthDeviceIdAfterStartup, i as isMatrixStartupAbortError, l as resolveMatrixAuth, n as acquireSharedMatrixClient, o as createMatrixMonitorTaskRunner, u as resolveMatrixAuthContext } from "./client-Dj4mcf-s.js";
 import { i as isMatrixMediaSizeLimitError, r as MatrixMediaSizeLimitError } from "./http-client-DOmFvKvB.js";
-import { t as resolveMatrixTargets } from "./resolve-targets-D3Eakgzs.js";
+import { n as prepareMatrixReplyPayload, r as resolveMatrixExtraContent } from "./outbound-CeCEtF_q.js";
+import { t as resolveMatrixTargets } from "./resolve-targets-B64O69Nd.js";
 import { t as formatMatrixEncryptedEventDisabledWarning } from "./encryption-guidance-BNcZNQZI.js";
 import { createMatrixInboundEventDeduper } from "./inbound-dedupe-Ch33GU06.js";
 import { a as isMatrixAccessTokenInvalidatedError, d as isMatrixDisconnectedSyncState, f as isMatrixReadySyncState, p as isMatrixTerminalSyncState } from "./client-support-DLj4vDeu.js";
-import { i as setBoundedMap, r as getMatrixRoomInfo, t as createMatrixRoomInfoResolver } from "./room-info-DIU67XLP.js";
+import { i as setBoundedMap, r as getMatrixRoomInfo, t as createMatrixRoomInfoResolver } from "./room-info-DVkKDscD.js";
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 import { buildChannelProgressDraftLineForEntry, createChannelProgressDraftCompositor, createMessageReceiptFromOutboundResults, createPreviewMessageReceipt, defineFinalizableLivePreviewAdapter, deliverWithFinalizableLivePreviewAdapter, formatChannelProgressDraftLine, formatChannelProgressDraftText, listMessageReceiptPlatformIds, resolveChannelStreamingBlockEnabled, waitUntilAbort } from "openclaw/plugin-sdk/channel-outbound";
 import { normalizeLowercaseStringOrEmpty, normalizeNullableString, normalizeOptionalString, normalizeStringifiedEntries, readStringValue, uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
@@ -822,7 +823,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-DfS5ciUL.js").then((n) => n.x), import("./direct-room-RinHjtqX.js").then((n) => n.t)]).then(([directManagementModule, directRoomModule]) => ({
+const loadMatrixDirectRoomDeps = createLazyRuntimeModule(() => Promise.all([import("./send-DG7Bnj7_.js").then((n) => n.x), import("./direct-room-RinHjtqX.js").then((n) => n.t)]).then(([directManagementModule, directRoomModule]) => ({
 	inspectMatrixDirectRooms: directManagementModule.inspectMatrixDirectRooms,
 	isStrictDirectRoom: directRoomModule.isStrictDirectRoom
 })));
@@ -1640,11 +1641,11 @@ async function redactMatrixDraftEvent(client, roomId, draftEventId) {
 function buildMatrixFinalizedPreviewContent() {
 	return { [MATRIX_OPENCLAW_FINALIZED_PREVIEW_KEY]: true };
 }
-const loadMatrixSendModule = createLazyRuntimeModule(() => import("./send-DfS5ciUL.js").then((n) => n.s));
+const loadMatrixSendModule = createLazyRuntimeModule(() => import("./send-DG7Bnj7_.js").then((n) => n.s));
 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-lwNc5I1X.js"));
-const loadMatrixDraftStream = createLazyRuntimeModule(() => import("./draft-stream-DhGHVdO4.js"));
+const loadMatrixReactionEvents = createLazyRuntimeModule(() => import("./reaction-events-DveJRUaX.js"));
+const loadMatrixDraftStream = createLazyRuntimeModule(() => import("./draft-stream-DPYdv4fE.js"));
 async function matrixTextWouldActivateMentions(client, text) {
 	const { resolveMatrixMentionsForBody } = await loadMatrixSendModule();
 	const mentions = await resolveMatrixMentionsForBody({
@@ -3308,6 +3309,7 @@ async function deliverMatrixReplies(params) {
 				acceptedResults.push(result);
 				if (replyToIdForReply) hasRepliedRef.value = true;
 			};
+			const extraContent = resolveMatrixExtraContent(reply);
 			if (mediaUrls.length === 0) {
 				await sendMessageMatrix(params.roomId, rawText, {
 					client: params.client,
@@ -3315,6 +3317,7 @@ async function deliverMatrixReplies(params) {
 					replyToId: replyToIdForReply,
 					threadId: params.threadId,
 					accountId: params.accountId,
+					extraContent,
 					onDeliveryResult
 				});
 				continue;
@@ -3331,6 +3334,7 @@ async function deliverMatrixReplies(params) {
 					threadId: params.threadId,
 					audioAsVoice: reply.audioAsVoice,
 					accountId: params.accountId,
+					extraContent: first ? extraContent : void 0,
 					onDeliveryResult
 				});
 				first = false;
@@ -3452,11 +3456,18 @@ function createMatrixReplyDispatcher(config) {
 								discardPending: async () => {},
 								id: () => draftEventId
 							},
-							buildFinalEdit: () => ({
-								text: finalPreviewText,
-								finalizeLive: !(quietDraftStreaming || !draftStream.matchesPreparedText(finalPreviewText)),
-								...quietDraftStreaming ? { extraContent: buildMatrixFinalizedPreviewContent() } : {}
-							}),
+							buildFinalEdit: () => {
+								const presentationContent = resolveMatrixExtraContent(payload);
+								const extraContent = {
+									...quietDraftStreaming ? buildMatrixFinalizedPreviewContent() : {},
+									...presentationContent
+								};
+								return {
+									text: finalPreviewText,
+									finalizeLive: !(quietDraftStreaming || Boolean(presentationContent) || !draftStream.matchesPreparedText(finalPreviewText)),
+									...Object.keys(extraContent).length > 0 ? { extraContent } : {}
+								};
+							},
 							editFinal: async (_draftEventId, edit) => {
 								if (edit.finalizeLive) {
 									if (!await draftStream.finalizeLive()) throw new Error("Matrix draft live finalize failed");
@@ -4077,6 +4088,7 @@ function createMatrixRoomMessageHandler(params) {
 						},
 						delivery: {
 							observeMessageSent: true,
+							preparePayload: prepareMatrixReplyPayload,
 							deliver: deliverReply,
 							onError: (err, info) => onReplyError(err, info)
 						},

package/dist/outbound-CeCEtF_q.js

@@ -0,0 +1,220 @@
+import { i as sendPollMatrix, r as sendMessageMatrix } from "./send-DG7Bnj7_.js";
+import { createMessageReceiptFromOutboundResults, createReplyToFanout, resolveOutboundSendDep } from "openclaw/plugin-sdk/channel-outbound";
+import { asOptionalRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
+import { chunkTextForOutbound } from "openclaw/plugin-sdk/text-chunking";
+import { attachChannelToResult } from "openclaw/plugin-sdk/channel-send-result";
+import { renderMessagePresentationFallbackText, renderPresentationForDelivery } from "openclaw/plugin-sdk/interactive-runtime";
+import { resolveSendableOutboundReplyParts, sendPayloadMediaSequence } from "openclaw/plugin-sdk/reply-payload";
+//#region extensions/matrix/src/outbound.ts
+const MATRIX_OPENCLAW_PRESENTATION_KEY = "com.openclaw.presentation";
+const MATRIX_OPENCLAW_PRESENTATION_TYPE = "message.presentation";
+const MATRIX_EMPTY_PRESENTATION_FALLBACK_TEXT = "---";
+const MATRIX_PRESENTATION_CAPABILITIES = {
+	supported: true,
+	buttons: true,
+	selects: true,
+	context: true,
+	divider: true,
+	limits: { text: {
+		markdownDialect: "markdown",
+		supportsEdit: true
+	} }
+};
+function toMatrixOutboundResult(result) {
+	const { roomId, ...delivery } = result;
+	return {
+		...delivery,
+		target: {
+			kind: "room",
+			id: roomId
+		}
+	};
+}
+function resolveMatrixChannelData(payload) {
+	const raw = asOptionalRecord(payload.channelData)?.matrix;
+	return asOptionalRecord(raw) ?? {};
+}
+function buildMatrixPresentationContent(presentation) {
+	return {
+		...presentation,
+		version: 1,
+		type: MATRIX_OPENCLAW_PRESENTATION_TYPE
+	};
+}
+function resolveMatrixPresentationContent(payload) {
+	const extraContent = asOptionalRecord(resolveMatrixChannelData(payload).extraContent);
+	const presentation = asOptionalRecord(extraContent?.[MATRIX_OPENCLAW_PRESENTATION_KEY]);
+	if (!presentation || presentation.version !== 1 || presentation.type !== MATRIX_OPENCLAW_PRESENTATION_TYPE) return;
+	return presentation;
+}
+function renderMatrixPresentationPayload(params) {
+	const matrixData = resolveMatrixChannelData(params.payload);
+	const fallbackText = renderMessagePresentationFallbackText({
+		text: params.payload.text,
+		presentation: params.presentation,
+		emptyFallback: MATRIX_EMPTY_PRESENTATION_FALLBACK_TEXT
+	});
+	return {
+		...params.payload,
+		text: fallbackText,
+		channelData: {
+			...params.payload.channelData,
+			matrix: {
+				...matrixData,
+				extraContent: { [MATRIX_OPENCLAW_PRESENTATION_KEY]: buildMatrixPresentationContent(params.presentation) }
+			}
+		}
+	};
+}
+function prepareMatrixReplyPayload(payload) {
+	return renderPresentationForDelivery({
+		presentationCapabilities: MATRIX_PRESENTATION_CAPABILITIES,
+		renderPresentation: (prepared) => renderMatrixPresentationPayload({
+			payload: prepared,
+			presentation: prepared.presentation
+		})
+	}, payload);
+}
+function resolveMatrixPayloadText(payload) {
+	const text = payload.text ?? "";
+	if (text.trim() || !resolveMatrixPresentationContent(payload)) return text;
+	return MATRIX_EMPTY_PRESENTATION_FALLBACK_TEXT;
+}
+/** Matrix event fields a reply carries beyond its body, currently its presentation. */
+function resolveMatrixExtraContent(payload) {
+	const presentation = resolveMatrixPresentationContent(payload);
+	return presentation ? { [MATRIX_OPENCLAW_PRESENTATION_KEY]: presentation } : void 0;
+}
+function resolveMatrixDeliveryProgress(onDeliveryResult) {
+	return onDeliveryResult ? async (result) => {
+		await onDeliveryResult(attachChannelToResult("matrix", toMatrixOutboundResult(result)));
+	} : void 0;
+}
+const matrixOutbound = {
+	deliveryMode: "direct",
+	chunker: chunkTextForOutbound,
+	chunkerMode: "markdown",
+	textChunkLimit: 4e3,
+	presentationCapabilities: MATRIX_PRESENTATION_CAPABILITIES,
+	renderPresentation: ({ payload, presentation }) => renderMatrixPresentationPayload({
+		payload,
+		presentation
+	}),
+	sendPayload: async ({ cfg, to, payload, mediaLocalRoots, mediaReadFile, mediaAccess, deps, replyToId, replyToIdSource, replyToMode, threadId, accountId, audioAsVoice, deliveryQueueId, onPlatformSendDispatch, onDeliveryResult }) => {
+		const send = resolveOutboundSendDep(deps, "matrix") ?? sendMessageMatrix;
+		const resolvedThreadId = threadId !== void 0 && threadId !== null ? String(threadId) : void 0;
+		const resolveReplyToId = createReplyToFanout({
+			...replyToId != null ? { replyToId } : {},
+			...replyToIdSource !== void 0 ? { replyToIdSource } : {},
+			...replyToMode !== void 0 ? { replyToMode } : {}
+		});
+		const urls = resolveSendableOutboundReplyParts(payload).mediaUrls;
+		const payloadText = resolveMatrixPayloadText(payload);
+		if (urls.length > 0) {
+			const sentResults = [];
+			const lastResult = await sendPayloadMediaSequence({
+				text: payloadText,
+				mediaUrls: urls,
+				send: async ({ text, mediaUrl, index, isFirst }) => await send(to, text, {
+					cfg,
+					mediaUrl,
+					mediaAccess,
+					mediaLocalRoots,
+					mediaReadFile,
+					replyToId: resolveReplyToId(),
+					threadId: resolvedThreadId,
+					accountId: accountId ?? void 0,
+					audioAsVoice: payload.audioAsVoice ?? audioAsVoice,
+					deliveryQueueId,
+					deliveryPartIndex: index,
+					deliveryPartCount: urls.length,
+					onPlatformSendDispatch,
+					extraContent: isFirst ? resolveMatrixExtraContent(payload) : void 0,
+					onDeliveryResult: resolveMatrixDeliveryProgress(onDeliveryResult)
+				}),
+				onResult: (result) => {
+					sentResults.push(result);
+				}
+			});
+			if (lastResult !== void 0) {
+				const receipt = createMessageReceiptFromOutboundResults({ results: sentResults });
+				receipt.parts = receipt.parts.map((part, index) => ({
+					...part,
+					index
+				}));
+				return attachChannelToResult("matrix", toMatrixOutboundResult({
+					...lastResult,
+					primaryMessageId: receipt.primaryPlatformMessageId,
+					receipt,
+					content: sentResults.map((result) => result.content).join("\n")
+				}));
+			}
+		}
+		const result = await send(to, payloadText, {
+			cfg,
+			mediaAccess,
+			mediaLocalRoots,
+			mediaReadFile,
+			replyToId: resolveReplyToId(),
+			threadId: resolvedThreadId,
+			accountId: accountId ?? void 0,
+			audioAsVoice: payload.audioAsVoice ?? audioAsVoice,
+			deliveryQueueId,
+			deliveryPartIndex: 0,
+			deliveryPartCount: 1,
+			onPlatformSendDispatch,
+			extraContent: resolveMatrixExtraContent(payload),
+			onDeliveryResult: resolveMatrixDeliveryProgress(onDeliveryResult)
+		});
+		return attachChannelToResult("matrix", toMatrixOutboundResult(result));
+	},
+	sendText: async ({ cfg, to, text, deps, replyToId, threadId, accountId, audioAsVoice, deliveryQueueId, deliveryPartIndex, deliveryPartCount, onPlatformSendDispatch, onDeliveryResult }) => {
+		const result = await (resolveOutboundSendDep(deps, "matrix") ?? sendMessageMatrix)(to, text, {
+			cfg,
+			replyToId: replyToId ?? void 0,
+			threadId: threadId !== void 0 && threadId !== null ? String(threadId) : void 0,
+			accountId: accountId ?? void 0,
+			audioAsVoice,
+			deliveryQueueId,
+			deliveryPartIndex,
+			...deliveryQueueId !== void 0 ? { deliveryPartCount } : {},
+			onPlatformSendDispatch,
+			onDeliveryResult: resolveMatrixDeliveryProgress(onDeliveryResult)
+		});
+		return attachChannelToResult("matrix", toMatrixOutboundResult(result));
+	},
+	sendMedia: async ({ cfg, to, text, mediaUrl, mediaLocalRoots, mediaReadFile, mediaAccess, deps, replyToId, threadId, accountId, audioAsVoice, deliveryQueueId, deliveryPartIndex, deliveryPartCount, onPlatformSendDispatch, onDeliveryResult }) => {
+		const result = await (resolveOutboundSendDep(deps, "matrix") ?? sendMessageMatrix)(to, text, {
+			cfg,
+			mediaUrl,
+			mediaLocalRoots,
+			mediaReadFile,
+			mediaAccess,
+			replyToId: replyToId ?? void 0,
+			threadId: threadId !== void 0 && threadId !== null ? String(threadId) : void 0,
+			accountId: accountId ?? void 0,
+			audioAsVoice,
+			deliveryQueueId,
+			deliveryPartIndex,
+			...deliveryQueueId !== void 0 ? { deliveryPartCount } : {},
+			onPlatformSendDispatch,
+			onDeliveryResult: resolveMatrixDeliveryProgress(onDeliveryResult)
+		});
+		return attachChannelToResult("matrix", toMatrixOutboundResult(result));
+	},
+	sendPoll: async ({ cfg, to, poll, threadId, accountId }) => {
+		const result = await sendPollMatrix(to, poll, {
+			cfg,
+			threadId: threadId !== void 0 && threadId !== null ? threadId : void 0,
+			accountId: accountId ?? void 0
+		});
+		return {
+			channel: "matrix",
+			messageId: result.eventId,
+			roomId: result.roomId,
+			pollId: result.eventId
+		};
+	}
+};
+//#endregion
+export { prepareMatrixReplyPayload as n, resolveMatrixExtraContent as r, matrixOutbound as t };

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

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