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

package/openclaw.plugin.json

@@ -1,5 +1,9 @@
 {
   "id": "matrix",
+  "doctorContract": {
+    "configRepair": true,
+    "stateMigrations": true
+  },
   "name": "Matrix",
   "description": "OpenClaw Matrix channel plugin for rooms and direct messages.",
   "icon": "https://cdn.simpleicons.org/matrix",
@@ -34,6 +38,9 @@
           "enabled": {
             "type": "boolean"
           },
+          "configWrites": {
+            "type": "boolean"
+          },
           "defaultAccount": {
             "type": "string"
           },
@@ -107,6 +114,29 @@
                     ],
                     "additionalProperties": false
                   },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "source": {
+                        "type": "string",
+                        "const": "store"
+                      },
+                      "provider": {
+                        "type": "string",
+                        "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                      },
+                      "id": {
+                        "type": "string",
+                        "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
+                      }
+                    },
+                    "required": [
+                      "source",
+                      "provider",
+                      "id"
+                    ],
+                    "additionalProperties": false
+                  },
                   {
                     "type": "object",
                     "properties": {
@@ -185,6 +215,29 @@
                     ],
                     "additionalProperties": false
                   },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "source": {
+                        "type": "string",
+                        "const": "store"
+                      },
+                      "provider": {
+                        "type": "string",
+                        "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                      },
+                      "id": {
+                        "type": "string",
+                        "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
+                      }
+                    },
+                    "required": [
+                      "source",
+                      "provider",
+                      "id"
+                    ],
+                    "additionalProperties": false
+                  },
                   {
                     "type": "object",
                     "properties": {
@@ -963,7 +1016,7 @@
         },
         "streaming.progress.commandText": {
           "label": "Matrix Progress Command Text",
-          "help": "Command/exec detail in progress draft lines: \"raw\" preserves released behavior; \"status\" shows only the tool label."
+          "help": "Command/exec detail in progress draft lines: \"status\" is the safe default; \"raw\" opts into command text."
         }
       }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/matrix",
-  "version": "2026.7.2-beta.7",
+  "version": "2026.8.1-beta.2",
   "description": "OpenClaw Matrix channel plugin for rooms and direct messages.",
   "repository": {
     "type": "git",
@@ -18,7 +18,7 @@
     "zod": "4.4.3"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.7.2-beta.7"
+    "openclaw": ">=2026.8.1-beta.2"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -167,10 +167,10 @@
       "allowInvalidConfigRecovery": true
     },
     "compat": {
-      "pluginApi": ">=2026.7.2-beta.7"
+      "pluginApi": ">=2026.8.1-beta.2"
     },
     "build": {
-      "openclawVersion": "2026.7.2-beta.7"
+      "openclawVersion": "2026.8.1-beta.2"
     },
     "release": {
       "publishToClawHub": true,

package/dist/active-client-DXvz2gCo.js

@@ -1,20 +0,0 @@
-import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/account-id";
-//#region extensions/matrix/src/matrix/active-client.ts
-const activeClients = /* @__PURE__ */ new Map();
-function resolveAccountKey(accountId) {
-	return normalizeAccountId(accountId) || DEFAULT_ACCOUNT_ID;
-}
-function setActiveMatrixClient(client, accountId) {
-	const key = resolveAccountKey(accountId);
-	if (!client) {
-		activeClients.delete(key);
-		return;
-	}
-	activeClients.set(key, client);
-}
-function getActiveMatrixClient(accountId) {
-	const key = resolveAccountKey(accountId);
-	return activeClients.get(key) ?? null;
-}
-//#endregion
-export { setActiveMatrixClient as n, getActiveMatrixClient as t };

package/dist/client-Dbso3-0V.js

@@ -1,30 +0,0 @@
-import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
-import { t as getMatrixScopedEnvVarNames } from "./env-vars-B0NxQnPk.js";
-import { i as resolveScopedMatrixEnvConfig, r as resolveMatrixEnvAuthReadiness, t as hasReadyMatrixEnvAuth } from "./env-auth-CQsYbz-p.js";
-import { n as validateMatrixHomeserverUrl, t as resolveValidatedMatrixHomeserverUrl } from "./url-validation-GRHde6lq.js";
-import { t as isBunRuntime } from "./runtime-BefyhPWv.js";
-import { d as backfillMatrixAuthDeviceIdAfterStartup, f as resolveMatrixAuth, i as resolveSharedMatrixClient, m as resolveMatrixConfigForAccount, n as releaseSharedClientInstance, o as stopSharedClientForAccount, p as resolveMatrixAuthContext, r as removeSharedClientInstance, s as stopSharedClientInstance, t as acquireSharedMatrixClient } from "./shared-CUMWxcMz.js";
-import { t as createMatrixClient } from "./create-client-BmSU-q-D.js";
-//#region extensions/matrix/src/matrix/client.ts
-var client_exports = /* @__PURE__ */ __exportAll({
-	acquireSharedMatrixClient: () => acquireSharedMatrixClient,
-	backfillMatrixAuthDeviceIdAfterStartup: () => backfillMatrixAuthDeviceIdAfterStartup,
-	createMatrixClient: () => createMatrixClient,
-	getMatrixScopedEnvVarNames: () => getMatrixScopedEnvVarNames,
-	hasReadyMatrixEnvAuth: () => hasReadyMatrixEnvAuth,
-	isBunRuntime: () => isBunRuntime,
-	releaseSharedClientInstance: () => releaseSharedClientInstance,
-	removeSharedClientInstance: () => removeSharedClientInstance,
-	resolveMatrixAuth: () => resolveMatrixAuth,
-	resolveMatrixAuthContext: () => resolveMatrixAuthContext,
-	resolveMatrixConfigForAccount: () => resolveMatrixConfigForAccount,
-	resolveMatrixEnvAuthReadiness: () => resolveMatrixEnvAuthReadiness,
-	resolveScopedMatrixEnvConfig: () => resolveScopedMatrixEnvConfig,
-	resolveSharedMatrixClient: () => resolveSharedMatrixClient,
-	resolveValidatedMatrixHomeserverUrl: () => resolveValidatedMatrixHomeserverUrl,
-	stopSharedClientForAccount: () => stopSharedClientForAccount,
-	stopSharedClientInstance: () => stopSharedClientInstance,
-	validateMatrixHomeserverUrl: () => validateMatrixHomeserverUrl
-});
-//#endregion
-export { client_exports as t };

package/dist/create-client-BmSU-q-D.js

@@ -1,61 +0,0 @@
-import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
-import { t as resolveValidatedMatrixHomeserverUrl } from "./url-validation-GRHde6lq.js";
-import { d as writeStorageMeta, l as resolveMatrixStoragePaths, r as maybeMigrateLegacyStorage } from "./storage-BvAkgzvT.js";
-import "./shared-CUMWxcMz.js";
-import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
-import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
-import { ssrfPolicyFromDangerouslyAllowPrivateNetwork } from "openclaw/plugin-sdk/ssrf-runtime";
-import fs from "node:fs";
-//#region extensions/matrix/src/matrix/client/create-client.ts
-var create_client_exports = /* @__PURE__ */ __exportAll({ createMatrixClient: () => createMatrixClient });
-const loadMatrixCreateClientRuntimeDeps = createLazyRuntimeModule(() => Promise.all([import("./sdk-bUytQHx7.js"), import("./logging-DV-p52N0.js").then((n) => n.n)]).then(([sdkModule, loggingModule]) => ({
-	MatrixClient: sdkModule.MatrixClient,
-	ensureMatrixSdkLoggingConfigured: loggingModule.ensureMatrixSdkLoggingConfigured
-})));
-async function createMatrixClient(params) {
-	const { MatrixClient, ensureMatrixSdkLoggingConfigured } = await loadMatrixCreateClientRuntimeDeps();
-	ensureMatrixSdkLoggingConfigured();
-	const homeserver = await resolveValidatedMatrixHomeserverUrl(params.homeserver, { dangerouslyAllowPrivateNetwork: params.allowPrivateNetwork });
-	const matrixClientUserId = normalizeOptionalString(params.userId);
-	const userId = matrixClientUserId ?? "unknown";
-	const storagePaths = params.persistStorage !== false ? resolveMatrixStoragePaths({
-		homeserver,
-		userId,
-		accessToken: params.accessToken,
-		accountId: params.accountId,
-		deviceId: params.deviceId,
-		env: process.env
-	}) : null;
-	if (storagePaths) {
-		await maybeMigrateLegacyStorage({
-			storagePaths,
-			env: process.env
-		});
-		fs.mkdirSync(storagePaths.rootDir, { recursive: true });
-		writeStorageMeta({
-			storagePaths,
-			homeserver,
-			userId,
-			accountId: params.accountId,
-			deviceId: params.deviceId
-		});
-	}
-	const cryptoDatabasePrefix = storagePaths ? `openclaw-matrix-${storagePaths.accountKey}-${storagePaths.tokenHash}` : void 0;
-	return new MatrixClient(homeserver, params.accessToken, {
-		userId: matrixClientUserId,
-		password: params.password,
-		deviceId: params.deviceId,
-		encryption: params.encryption,
-		localTimeoutMs: params.localTimeoutMs,
-		initialSyncLimit: params.initialSyncLimit,
-		storageRootDir: storagePaths?.rootDir,
-		recoveryKeyPath: storagePaths?.recoveryKeyPath,
-		idbSnapshotPath: storagePaths?.idbSnapshotPath,
-		cryptoDatabasePrefix,
-		autoBootstrapCrypto: params.autoBootstrapCrypto,
-		ssrfPolicy: params.ssrfPolicy ?? ssrfPolicyFromDangerouslyAllowPrivateNetwork(params.allowPrivateNetwork),
-		dispatcherPolicy: params.dispatcherPolicy
-	});
-}
-//#endregion
-export { create_client_exports as n, createMatrixClient as t };

package/dist/credentials-read-DVmFCm7X.js

@@ -1,77 +0,0 @@
-import { t as __exportAll } from "./rolldown-runtime-8H4AJuhK.js";
-import { n as getOptionalMatrixRuntime } from "./runtime-6S3DNFNv.js";
-import "./storage-paths-gUmSydsW.js";
-import { normalizeAccountId } from "openclaw/plugin-sdk/account-id";
-import { createPluginStateSyncKeyedStore } from "openclaw/plugin-sdk/runtime-doctor";
-//#region extensions/matrix/src/matrix/credentials-read.ts
-var credentials_read_exports = /* @__PURE__ */ __exportAll({
-	MATRIX_CREDENTIALS_MAX_ENTRIES: () => 256,
-	MATRIX_CREDENTIALS_NAMESPACE: () => MATRIX_CREDENTIALS_NAMESPACE,
-	clearMatrixCredentials: () => clearMatrixCredentials,
-	credentialsMatchConfig: () => credentialsMatchConfig,
-	isMatrixCredentialRevocation: () => isMatrixCredentialRevocation,
-	loadMatrixCredentials: () => loadMatrixCredentials,
-	matrixCredentialsStoreKey: () => matrixCredentialsStoreKey,
-	normalizeMatrixStoredCredentials: () => normalizeMatrixStoredCredentials,
-	openMatrixCredentialsStore: () => openMatrixCredentialsStore
-});
-const MATRIX_CREDENTIALS_NAMESPACE = "credentials";
-function matrixCredentialsStoreKey(accountId) {
-	return `account:${normalizeAccountId(accountId)}`;
-}
-function normalizeMatrixStoredCredentials(value, accountId) {
-	if (!value || typeof value !== "object") return null;
-	const parsed = value;
-	if (typeof parsed.homeserver !== "string" || !parsed.homeserver || typeof parsed.userId !== "string" || !parsed.userId || typeof parsed.accessToken !== "string" || !parsed.accessToken || typeof parsed.createdAt !== "string" || !parsed.createdAt) return null;
-	return {
-		accountId: normalizeAccountId(accountId ?? parsed.accountId),
-		homeserver: parsed.homeserver,
-		userId: parsed.userId,
-		accessToken: parsed.accessToken,
-		...typeof parsed.deviceId === "string" ? { deviceId: parsed.deviceId } : {},
-		createdAt: parsed.createdAt,
-		...typeof parsed.lastUsedAt === "string" ? { lastUsedAt: parsed.lastUsedAt } : {}
-	};
-}
-function isMatrixCredentialRevocation(value, accountId) {
-	if (!value || typeof value !== "object") return false;
-	const parsed = value;
-	return parsed.kind === "revoked" && typeof parsed.revokedAt === "string" && parsed.revokedAt.length > 0 && normalizeAccountId(parsed.accountId) === normalizeAccountId(accountId ?? parsed.accountId);
-}
-function openMatrixCredentialsStore(env = process.env) {
-	const runtime = getOptionalMatrixRuntime();
-	const resolvedEnv = env.OPENCLAW_STATE_DIR?.trim() || !runtime ? env : {
-		...env,
-		OPENCLAW_STATE_DIR: runtime.state.resolveStateDir(env)
-	};
-	return createPluginStateSyncKeyedStore("matrix", {
-		namespace: MATRIX_CREDENTIALS_NAMESPACE,
-		maxEntries: 256,
-		overflowPolicy: "reject-new",
-		env: resolvedEnv
-	});
-}
-function loadMatrixCredentials(env = process.env, accountId) {
-	const normalizedAccountId = normalizeAccountId(accountId);
-	const parsed = normalizeMatrixStoredCredentials(openMatrixCredentialsStore(env).lookup(matrixCredentialsStoreKey(accountId)), normalizedAccountId);
-	if (!parsed || parsed.accountId !== normalizedAccountId) return null;
-	const { accountId: _accountId, ...credentials } = parsed;
-	return credentials;
-}
-function clearMatrixCredentials(env = process.env, accountId) {
-	const normalizedAccountId = normalizeAccountId(accountId);
-	openMatrixCredentialsStore(env).register(matrixCredentialsStoreKey(normalizedAccountId), {
-		accountId: normalizedAccountId,
-		kind: "revoked",
-		revokedAt: (/* @__PURE__ */ new Date()).toISOString()
-	});
-}
-function credentialsMatchConfig(stored, config) {
-	if (!config.userId) {
-		if (!config.accessToken) return false;
-		return stored.homeserver === config.homeserver && stored.accessToken === config.accessToken;
-	}
-	return stored.homeserver === config.homeserver && stored.userId === config.userId;
-}
-//#endregion
-export { isMatrixCredentialRevocation as a, normalizeMatrixStoredCredentials as c, credentials_read_exports as i, openMatrixCredentialsStore as l, clearMatrixCredentials as n, loadMatrixCredentials as o, credentialsMatchConfig as r, matrixCredentialsStoreKey as s, MATRIX_CREDENTIALS_NAMESPACE as t };

package/dist/exec-approval-resolver-BCgqRtZS.js

@@ -1,16 +0,0 @@
-import { isApprovalNotFoundError } from "openclaw/plugin-sdk/error-runtime";
-import { resolveApprovalOverGateway } from "openclaw/plugin-sdk/approval-gateway-runtime";
-//#region extensions/matrix/src/exec-approval-resolver.ts
-async function resolveMatrixApproval(params) {
-	return await resolveApprovalOverGateway({
-		cfg: params.cfg,
-		approvalId: params.approvalId,
-		approvalKind: params.approvalKind,
-		decision: params.decision,
-		senderId: params.senderId,
-		gatewayUrl: params.gatewayUrl,
-		clientDisplayName: `Matrix approval (${params.senderId?.trim() || "unknown"})`
-	});
-}
-//#endregion
-export { isApprovalNotFoundError, resolveMatrixApproval };

package/dist/preflight-audio.runtime-BZxxQsxY.js

@@ -1,11 +0,0 @@
-import { sendDurableMessageBatch as sendDurableMessageBatch$1 } from "openclaw/plugin-sdk/channel-outbound";
-import { transcribeFirstAudio as transcribeFirstAudio$1 } from "openclaw/plugin-sdk/media-runtime";
-//#region extensions/matrix/src/matrix/monitor/preflight-audio.runtime.ts
-async function transcribeFirstAudio(...args) {
-	return await transcribeFirstAudio$1(...args);
-}
-async function sendDurableMessageBatch(...args) {
-	return await sendDurableMessageBatch$1(...args);
-}
-//#endregion
-export { sendDurableMessageBatch, transcribeFirstAudio };

package/dist/probe.runtime-BuieqmS3.js

@@ -1,3 +0,0 @@
-import { t as createMatrixClient } from "./create-client-BmSU-q-D.js";
-import "./client-Dbso3-0V.js";
-export { createMatrixClient };

package/dist/record-shared-CWWx6fvI.js

@@ -1,2 +0,0 @@
-import { isRecord as isRecord$1 } from "openclaw/plugin-sdk/string-coerce-runtime";
-export { isRecord$1 as t };