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

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

@@ -1,6 +1,6 @@
 import { t as buildTimeoutAbortSignal } from "./timeout-abort-signal-DMrgRFIy.js";
-import { truncateUtf16Safe } from "openclaw/plugin-sdk/text-utility-runtime";
 import { parseMediaContentLength } from "openclaw/plugin-sdk/media-runtime";
+import { truncateUtf16Safe } from "openclaw/plugin-sdk/text-utility-runtime";
 import { readResponseWithLimit } from "openclaw/plugin-sdk/response-limit-runtime";
 import { fetchWithRuntimeDispatcherOrMockedGlobal } from "openclaw/plugin-sdk/runtime-fetch";
 import { closeDispatcher, createPinnedDispatcher, resolvePinnedHostnameWithPolicy } from "openclaw/plugin-sdk/ssrf-dispatcher";
@@ -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-BiHEEzD7.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-DD-EnNJE.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 fs from "node:fs";
 import path from "node:path";
-import { indexedDB } from "fake-indexeddb";
+import fs from "node:fs";
 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-9Naf7in0.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-DPCtdFjk.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-yre1krm8.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-DCRbGLMh.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-yre1krm8.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-DPCtdFjk.js";
-import { r as withResolvedRoomAction } from "./client-BUai6s29.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-C5EOF9et.js → monitor-2BjKS9RV.js}

@@ -1,22 +1,22 @@
 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-CYQRY2oG.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-B1woOUgk.js";
-import { a as normalizeMatrixUserId, i as normalizeMatrixAllowList, o as resolveMatrixAllowListMatch } from "./config-schema-BTSatSY3.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-yre1krm8.js";
-import { t as createMatrixThreadBindingManager } from "./thread-bindings-U5ZroBeZ.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-DPCtdFjk.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-BfW4lxGu.js";
-import "./client-CPuYbNL8.js";
-import { i as isMatrixMediaSizeLimitError, r as MatrixMediaSizeLimitError } from "./http-client-Jw5_bwQo.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-Cx1VVArA.js";
-import { t as formatMatrixEncryptedEventDisabledWarning } from "./encryption-guidance-BFfgq7c7.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";
 import { t as createMatrixRoomInfoResolver } from "./room-info-B6vKD5DF.js";
@@ -25,8 +25,8 @@ import { buildChannelProgressDraftLineForEntry, createChannelProgressDraftGate,
 import { normalizeLowercaseStringOrEmpty, normalizeOptionalString, normalizeStringifiedEntries, uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { CHANNEL_APPROVAL_NATIVE_RUNTIME_CONTEXT_CAPABILITY } from "openclaw/plugin-sdk/approval-handler-adapter-runtime";
 import { resolveInboundLastRouteSessionKey } from "openclaw/plugin-sdk/routing";
-import { buildChannelInboundEventContext, hasFinalInboundReplyDispatch, toInboundMediaFacts } from "openclaw/plugin-sdk/channel-inbound";
-import { getSessionEntry } from "openclaw/plugin-sdk/session-store-runtime";
+import { buildChannelInboundEventContext, createChannelInboundEnvelopeBuilder, hasFinalInboundReplyDispatch, resolveInboundMentionDecision, toInboundMediaFacts } from "openclaw/plugin-sdk/channel-inbound";
+import { getSessionEntry, resolveStorePath } from "openclaw/plugin-sdk/session-store-runtime";
 import { isFutureDateTimestampMs, parseStrictFiniteNumber, resolveExpiresAtMsFromDurationMs, resolveOptionalIntegerOption } from "openclaw/plugin-sdk/number-runtime";
 import { KeyedAsyncQueue } from "openclaw/plugin-sdk/keyed-async-queue";
 import { format } from "node:util";
@@ -36,6 +36,7 @@ import { resolveAckReaction } from "openclaw/plugin-sdk/channel-feedback";
 import { registerChannelRuntimeContext } from "openclaw/plugin-sdk/channel-runtime-context";
 import { isDangerousNameMatchingEnabled } from "openclaw/plugin-sdk/dangerous-name-runtime";
 import { createChannelIngressResolver, defineStableChannelIngressIdentity } from "openclaw/plugin-sdk/channel-ingress-runtime";
+import { resolveHumanDelayConfig } from "openclaw/plugin-sdk/agent-runtime";
 import { evaluateSupplementalContextVisibility, resolveChannelContextVisibilityMode } from "openclaw/plugin-sdk/context-visibility-runtime";
 import { mergePairLoopGuardConfig } from "openclaw/plugin-sdk/pair-loop-guard-runtime";
 import { buildInboundHistoryFromEntries } from "openclaw/plugin-sdk/reply-history";
@@ -817,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-yre1krm8.js").then((n) => n.d), import("./send-yre1krm8.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
 })));
@@ -1690,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",
@@ -2204,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-yre1krm8.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-QUgxkQKQ.js"));
-const loadMatrixDraftStream = createLazyRuntimeModule(() => import("./draft-stream-GOdPZMBm.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({
@@ -2328,7 +2331,7 @@ function formatMatrixToolProgressMarkdownCode(text) {
 	return `\`${(text.length <= MATRIX_TOOL_PROGRESS_MAX_CHARS ? text : `${truncateUtf16Safe(text, MATRIX_TOOL_PROGRESS_MAX_CHARS - 1).trimEnd()}...`).replaceAll("`", "'")}\``;
 }
 function createMatrixRoomMessageHandler(params) {
-	const { client, core, cfg, accountId, accountConfig, runtime, logger, logVerboseMessage, allowFromResolvedEntries = [], groupAllowFromResolvedEntries = [], roomsConfig, accountAllowBots, configuredBotUserIds = /* @__PURE__ */ new Set(), groupPolicy, replyToMode, threadReplies, dmThreadReplies, dmSessionScope, streaming, previewToolProgressEnabled, blockStreamingEnabled, dmEnabled, dmPolicy, textLimit, mediaMaxBytes, historyLimit, startupMs, startupGraceMs, dropPreStartupMessages, inboundDeduper, directTracker, getRoomInfo, getMemberDisplayName, needsRoomAliasesForConfig, resolveLiveUserAllowlist = resolveMatrixMonitorLiveUserAllowlist } = params;
+	const { client, core, cfg, accountId, accountConfig, runtime, logger, logVerboseMessage, allowFromResolvedEntries = [], groupAllowFromResolvedEntries = [], roomsConfig, accountAllowBots, configuredBotUserIds = /* @__PURE__ */ new Set(), groupPolicy, replyToMode, threadReplies, dmThreadReplies, dmSessionScope, streaming, previewToolProgressEnabled, blockStreamingEnabled, dmEnabled, dmPolicy, textLimit, mediaMaxBytes, historyLimit, startupMs, startupGraceMs, dropPreStartupMessages, inboundDeduper, directTracker, getRoomInfo, getMemberDisplayName, needsRoomAliasesForConfig, resolveLiveUserAllowlist = resolveMatrixMonitorLiveUserAllowlist, resolveStorePath: resolveStorePathImpl = resolveStorePath, createChannelInboundEnvelopeBuilder: createChannelInboundEnvelopeBuilderImpl = createChannelInboundEnvelopeBuilder, finalizeInboundContext, resolveHumanDelayConfig: resolveHumanDelayConfigImpl = resolveHumanDelayConfig } = params;
 	const contextVisibilityMode = resolveChannelContextVisibilityMode({
 		cfg,
 		channel: "matrix",
@@ -2796,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,
@@ -2821,9 +2824,23 @@ function createMatrixRoomMessageHandler(params) {
 					return;
 				}
 				const shouldRequireMention = isRoom ? roomConfig?.autoReply === true ? false : roomConfig?.autoReply === false ? true : typeof roomConfig?.requireMention === "boolean" ? roomConfig?.requireMention : true : false;
-				const shouldBypassMention = allowTextCommands && isRoom && shouldRequireMention && !wasMentioned && !hasExplicitMention && commandAuthorized && hasControlCommandInMessage;
+				const mentionDecision = resolveInboundMentionDecision({
+					facts: {
+						canDetectMention: true,
+						wasMentioned,
+						hasAnyMention: hasExplicitMention
+					},
+					policy: {
+						isGroup: isRoom,
+						requireMention: shouldRequireMention,
+						allowTextCommands,
+						hasControlCommand: hasControlCommandInMessage,
+						commandAuthorized
+					}
+				});
+				const { effectiveWasMentioned, shouldBypassMention } = mentionDecision;
 				const canDetectMention = agentMentionRegexes.length > 0 || hasExplicitMention;
-				if (isRoom && shouldRequireMention && !wasMentioned && !shouldBypassMention) {
+				if (mentionDecision.shouldSkip) {
 					const pendingHistoryBody = preflightAudioTranscript ? formatMatrixAudioTranscript(preflightAudioTranscript) : pendingHistoryText || pendingHistoryPollText;
 					if (historyLimit > 0 && pendingHistoryBody) {
 						const pendingEntry = {
@@ -2956,6 +2973,7 @@ function createMatrixRoomMessageHandler(params) {
 					isRoom,
 					shouldRequireMention,
 					wasMentioned,
+					effectiveWasMentioned,
 					shouldBypassMention,
 					canDetectMention,
 					commandAuthorized,
@@ -2998,7 +3016,7 @@ function createMatrixRoomMessageHandler(params) {
 			})();
 			if (!resolvedIngressResult) return;
 			if ("deferredPrefix" in resolvedIngressResult) return;
-			const { route: _route, hasExplicitSessionBinding, roomConfig, isDirectMessage, isRoom, shouldRequireMention, wasMentioned, shouldBypassMention, canDetectMention, commandAuthorized, inboundHistory, senderName, bodyText, commandBodyText, media, preflightAudioTranscript, locationPayload, messageId, triggerSnapshot, threadRootId, thread, botLoopProtection, effectiveGroupAllowFrom, effectiveRoomUsers } = resolvedIngressResult;
+			const { route: _route, hasExplicitSessionBinding, roomConfig, isDirectMessage, isRoom, shouldRequireMention, wasMentioned, effectiveWasMentioned, shouldBypassMention, canDetectMention, commandAuthorized, inboundHistory, senderName, bodyText, commandBodyText, media, preflightAudioTranscript, locationPayload, messageId, triggerSnapshot, threadRootId, thread, botLoopProtection, effectiveGroupAllowFrom, effectiveRoomUsers } = resolvedIngressResult;
 			const replyToEventId = resolveMatrixReplyToEventId(event.content);
 			const threadTarget = thread.threadId;
 			const isRoomContextSenderAllowed = (contextSenderId) => {
@@ -3046,11 +3064,10 @@ function createMatrixRoomMessageHandler(params) {
 			const roomName = (isRoom ? await getRoomInfo(roomId) : void 0)?.name;
 			const envelopeFrom = isDirectMessage ? senderName : roomName ?? roomId;
 			const textWithId = `${bodyText}\n[matrix event id: ${messageId} room: ${roomId}]`;
-			const storePath = core.channel.session.resolveStorePath(cfg.session?.store, { agentId: _route.agentId });
-			const envelopeOptions = core.channel.reply.resolveEnvelopeFormatOptions(cfg);
-			const previousTimestamp = core.channel.session.readSessionUpdatedAt({
-				storePath,
-				sessionKey: _route.sessionKey
+			const storePath = resolveStorePathImpl(cfg.session?.store, { agentId: _route.agentId });
+			const buildEnvelope = createChannelInboundEnvelopeBuilderImpl({
+				cfg,
+				route: _route
 			});
 			const sharedDmNoticeSessionKey = threadTarget ? _route.mainSessionKey || _route.sessionKey : _route.sessionKey;
 			const sharedDmContextNotice = isDirectMessage ? hasExplicitSessionBinding ? null : resolveMatrixSharedDmContextNotice({
@@ -3062,12 +3079,10 @@ function createMatrixRoomMessageHandler(params) {
 				sentRooms: sharedDmContextNoticeRooms,
 				logVerboseMessage
 			}) : null;
-			const body = core.channel.reply.formatAgentEnvelope({
+			const body = buildEnvelope({
 				channel: "Matrix",
 				from: envelopeFrom,
 				timestamp: eventTs ?? void 0,
-				previousTimestamp,
-				envelope: envelopeOptions,
 				body: textWithId
 			});
 			const groupSystemPrompt = normalizeOptionalString(roomConfig?.systemPrompt);
@@ -3078,8 +3093,8 @@ function createMatrixRoomMessageHandler(params) {
 			}).include);
 			const ctxPayload = buildChannelInboundEventContext({
 				channel: "matrix",
-				finalize: core.channel.reply.finalizeInboundContext,
 				contextVisibility: contextVisibilityMode,
+				finalize: finalizeInboundContext,
 				supplemental: {
 					quote: replyContext ? {
 						id: threadTarget ? void 0 : replyToEventId ?? void 0,
@@ -3116,6 +3131,7 @@ function createMatrixRoomMessageHandler(params) {
 				},
 				route: {
 					agentId: _route.agentId,
+					dmScope: _route.dmScope,
 					accountId: _route.accountId,
 					routeSessionKey: _route.sessionKey
 				},
@@ -3132,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,
@@ -3169,7 +3186,7 @@ function createMatrixRoomMessageHandler(params) {
 				isMentionableGroup: isRoom,
 				requireMention: shouldRequireMention,
 				canDetectMention,
-				effectiveWasMentioned: wasMentioned || shouldBypassMention,
+				effectiveWasMentioned,
 				shouldBypassMention
 			}));
 			if (shouldAckReaction() && messageId) loadMatrixSendModule().then(({ reactMatrixMessage }) => reactMatrixMessage(roomId, messageId, ackReaction, client)).catch((err) => {
@@ -3350,7 +3367,7 @@ function createMatrixRoomMessageHandler(params) {
 					},
 					onPlanUpdate: async (payload) => {
 						if (payload.phase !== "update") return;
-						await pushPlanProgress(payload.planSteps, payload.explanation);
+						await pushPlanProgress(payload.steps, payload.explanation);
 					},
 					onApprovalEvent: async (payload) => {
 						if (payload.phase !== "requested") return;
@@ -3439,9 +3456,9 @@ function createMatrixRoomMessageHandler(params) {
 				progressDraftGate.reset();
 				resetPreviewToolProgress();
 			};
-			const { dispatcher, replyOptions, markDispatchIdle, markRunComplete } = core.channel.reply.createReplyDispatcherWithTyping({
+			const { deliver: deliverReply, onError: onReplyError, ...turnDispatcherOptions } = {
 				...prefixOptions,
-				humanDelay: core.channel.reply.resolveHumanDelayConfig(cfg, _route.agentId),
+				humanDelay: resolveHumanDelayConfigImpl(cfg, _route.agentId),
 				deliver: async (payload, info) => {
 					if (draftStream && info.kind !== "tool" && !payload.isCompactionNotice) {
 						const hasMedia = Boolean(payload.mediaUrl) || (payload.mediaUrls?.length ?? 0) > 0;
@@ -3626,7 +3643,7 @@ function createMatrixRoomMessageHandler(params) {
 				},
 				onReplyStart: typingCallbacks.onReplyStart,
 				onIdle: typingCallbacks.onIdle
-			});
+			};
 			const pinnedMainDmOwner = isDirectMessage ? await (async () => {
 				const livePinnedCfg = core.config.current();
 				const livePinnedAllowlists = resolveMatrixAccountAllowlistConfig({
@@ -3665,12 +3682,14 @@ function createMatrixRoomMessageHandler(params) {
 						raw: event
 					}),
 					resolveTurn: () => ({
+						cfg,
 						channel: "matrix",
 						accountId: _route.accountId,
-						routeSessionKey: _route.sessionKey,
-						storePath,
+						route: {
+							agentId: _route.agentId,
+							sessionKey: _route.sessionKey
+						},
 						ctxPayload,
-						recordInboundSession: core.channel.session.recordInboundSession,
 						botLoopProtection,
 						record: {
 							updateLastRoute: isDirectMessage ? {
@@ -3694,14 +3713,7 @@ function createMatrixRoomMessageHandler(params) {
 								});
 							}
 						},
-						onPreDispatchFailure: () => core.channel.reply.settleReplyDispatcher({
-							dispatcher,
-							onSettled: () => {
-								markRunComplete();
-								markDispatchIdle();
-							}
-						}),
-						runDispatch: async () => {
+						afterRecord: async () => {
 							if (sharedDmContextNotice && markTrackedRoomIfFirst(sharedDmContextNoticeRooms, roomId)) try {
 								await client.sendMessage(roomId, {
 									msgtype: "m.notice",
@@ -3710,46 +3722,35 @@ function createMatrixRoomMessageHandler(params) {
 							} catch (err) {
 								logVerboseMessage(`matrix: failed sending shared DM session notice room=${roomId}: ${String(err)}`);
 							}
-							return await core.channel.reply.withReplyDispatcher({
-								dispatcher,
-								onSettled: () => {
-									markDispatchIdle();
-								},
-								run: async () => {
-									try {
-										return await core.channel.reply.dispatchReplyFromConfig({
-											ctx: ctxPayload,
-											cfg,
-											dispatcher,
-											replyOptions: {
-												...replyOptions,
-												skillFilter: roomConfig?.skills,
-												disableBlockStreaming: !blockStreamingEnabled,
-												onPartialReply: draftStream ? (payload) => {
-													if (progressDraftStreaming) return;
-													latestDraftFullText = payload.text ?? "";
-													suppressPreviewToolProgressForAnswerText(latestDraftFullText);
-													updateDraftFromLatestFullText();
-												} : void 0,
-												onBlockReplyQueued: draftStream ? (payload, context) => {
-													if (payload.isCompactionNotice === true) return;
-													queueDraftBlockBoundary(payload, context);
-												} : void 0,
-												onAssistantMessageStart: draftStream ? () => {
-													resetDraftBlockOffsets();
-													resetPreviewToolProgress();
-												} : void 0,
-												onQueuedFollowupAdmitted: draftStream ? resetDraftDeliveryState : void 0,
-												...buildPreviewToolProgressReplyOptions(),
-												onModelSelected
-											}
-										});
-									} finally {
-										progressDraftGate.cancel();
-										markRunComplete();
-									}
-								}
-							});
+						},
+						delivery: {
+							deliver: deliverReply,
+							onError: (err, info) => onReplyError(err, info)
+						},
+						dispatcherOptions: {
+							...turnDispatcherOptions,
+							onSettled: () => progressDraftGate.cancel()
+						},
+						replyOptions: {
+							skillFilter: roomConfig?.skills,
+							disableBlockStreaming: !blockStreamingEnabled,
+							onPartialReply: draftStream ? (payload) => {
+								if (progressDraftStreaming) return;
+								latestDraftFullText = payload.text ?? "";
+								suppressPreviewToolProgressForAnswerText(latestDraftFullText);
+								updateDraftFromLatestFullText();
+							} : void 0,
+							onBlockReplyQueued: draftStream ? (payload, context) => {
+								if (payload.isCompactionNotice === true) return;
+								queueDraftBlockBoundary(payload, context);
+							} : void 0,
+							onAssistantMessageStart: draftStream ? () => {
+								resetDraftBlockOffsets();
+								resetPreviewToolProgress();
+							} : void 0,
+							onQueuedFollowupAdmitted: draftStream ? resetDraftDeliveryState : void 0,
+							...buildPreviewToolProgressReplyOptions(),
+							onModelSelected
 						}
 					})
 				}
@@ -3807,10 +3808,10 @@ function shouldPromoteRecentInviteRoom(params) {
 //#endregion
 //#region extensions/matrix/src/matrix/monitor/startup.ts
 const loadMatrixStartupMaintenanceDeps = createLazyRuntimeModule(() => Promise.all([
-	import("./setup-core-CYQRY2oG.js").then((n) => n.s),
+	import("./setup-core-D6gyoyeg.js").then((n) => n.c),
 	import("./device-health-D4LBxuPq.js"),
-	import("./setup-core-CYQRY2oG.js").then((n) => n.a),
-	import("./startup-verification-DSiyDKM5.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-CGnI9k1O.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) });
 }

package/dist/probe.runtime-BWkgfbiE.js

@@ -0,0 +1,3 @@
+import { t as createMatrixClient } from "./create-client-Und1YmJ2.js";
+import "./client-Dg8dk8NW.js";
+export { createMatrixClient };

package/dist/{profile-update-DompcDyu.js → profile-update-C2My3TML.js}

@@ -1,6 +1,6 @@
 import { t as getMatrixRuntime } from "./runtime-6S3DNFNv.js";
-import { c as resolveMatrixConfigPath, l as updateMatrixAccountConfig, o as syncMatrixOwnProfile } from "./setup-core-CYQRY2oG.js";
-import { n as withResolvedActionClient } from "./client-BUai6s29.js";
+import { l as resolveMatrixConfigPath, s as syncMatrixOwnProfile, u as updateMatrixAccountConfig } from "./setup-core-D6gyoyeg.js";
+import { n as withResolvedActionClient } from "./client-BwX6rURh.js";
 import { normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 //#region extensions/matrix/src/matrix/actions/profile.ts
 async function updateMatrixOwnProfile(opts = {}) {