@openclaw/matrix 2026.10.2 → 2026.10.5-beta.2

package/node_modules/uint8array-extras/readme.md

@@ -86,7 +86,7 @@ This can be useful for converting a `Buffer` to a pure `Uint8Array`. `Buffer` is
 
 Tip: If you want a copy, just call `.slice()` on the return value.
 
-### `concatUint8Arrays(arrays: Uint8Array[], totalLength?: number): Uint8Array`
+### `concatUint8Arrays(arrays: Array<Uint8Array | ArrayBuffer>, totalLength?: number): Uint8Array`
 
 Concatenate the given arrays into a new array.
 
@@ -106,7 +106,7 @@ console.log(concatUint8Arrays([a, b]));
 //=> Uint8Array [1, 2, 3, 4, 5, 6]
 ```
 
-### `areUint8ArraysEqual(a: Uint8Array, b: Uint8Array): boolean`
+### `areUint8ArraysEqual(a: Uint8Array | ArrayBuffer, b: Uint8Array | ArrayBuffer): boolean`
 
 Check if two arrays are identical by verifying that they contain the same bytes in the same sequence.
 
@@ -126,7 +126,7 @@ console.log(areUint8ArraysEqual(a, c));
 //=> false
 ```
 
-### `compareUint8Arrays(a: Uint8Array, b: Uint8Array): 0 | 1 | -1`
+### `compareUint8Arrays(a: Uint8Array | ArrayBuffer, b: Uint8Array | ArrayBuffer): 0 | 1 | -1`
 
 Compare two arrays and indicate their relative order or equality. Useful for sorting.
 
@@ -180,7 +180,7 @@ console.log(stringToUint8Array('Hello'));
 //=> Uint8Array [72, 101, 108, 108, 111]
 ```
 
-### `uint8ArrayToBase64(array: Uint8Array, options?: {urlSafe: boolean}): string`
+### `uint8ArrayToBase64(array: Uint8Array | ArrayBuffer, options?: {urlSafe: boolean}): string`
 
 Convert a `Uint8Array` to a Base64-encoded string.
 
@@ -242,7 +242,7 @@ console.log(base64ToString('SGVsbG8='));
 //=> 'Hello'
 ```
 
-### `uint8ArrayToHex(array: Uint8Array): string`
+### `uint8ArrayToHex(array: Uint8Array | ArrayBuffer): string`
 
 Convert a `Uint8Array` to a Hex string.
 
@@ -285,7 +285,7 @@ console.log(getUintBE(new DataView(byteArray.buffer)));
 //=> 20015998341291
 ```
 
-### `indexOf(array: Uint8Array, value: Uint8Array): number`
+### `indexOf(array: Uint8Array | ArrayBuffer, value: Uint8Array | ArrayBuffer): number`
 
 Find the index of the first occurrence of the given sequence of bytes (`value`) within the given `Uint8Array` (`array`).
 
@@ -300,7 +300,7 @@ console.log(indexOf(byteArray, new Uint8Array([0x78, 0x90])));
 //=> 3
 ```
 
-### `includes(array: Uint8Array, value: Uint8Array): boolean`
+### `includes(array: Uint8Array | ArrayBuffer, value: Uint8Array | ArrayBuffer): boolean`
 
 Checks if the given sequence of bytes (`value`) is within the given `Uint8Array` (`array`).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/matrix",
-  "version": "2026.10.2",
+  "version": "2026.10.5-beta.2",
   "description": "OpenClaw Matrix channel plugin for rooms and direct messages.",
   "repository": {
     "type": "git",
@@ -9,17 +9,17 @@
   "type": "module",
   "dependencies": {
     "@matrix-org/matrix-sdk-crypto-nodejs": "0.6.6",
-    "@matrix-org/matrix-sdk-crypto-wasm": "18.8.0",
-    "@openclaw/fs-safe": "0.24.2",
+    "@matrix-org/matrix-sdk-crypto-wasm": "18.9.0",
+    "@openclaw/fs-safe": "0.25.0",
     "fake-indexeddb": "6.2.5",
     "markdown-it": "15.0.2",
     "matrix-js-sdk": "42.4.0",
-    "music-metadata": "11.15.0",
+    "music-metadata": "11.16.1",
     "typebox": "1.3.34",
     "zod": "4.6.5"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.10.2"
+    "openclaw": ">=2026.10.5-beta.2"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -169,11 +169,11 @@
       "allowInvalidConfigRecovery": true
     },
     "compat": {
-      "pluginApi": ">=2026.10.2"
+      "pluginApi": ">=2026.10.5-beta.2"
     },
     "build": {
       "bundledDist": false,
-      "openclawVersion": "2026.10.2"
+      "openclawVersion": "2026.10.5-beta.2"
     },
     "release": {
       "publishToClawHub": true,

package/dist/.setup/accounts-C_r0UlEm.mjs

@@ -1,138 +0,0 @@
-import { a as resolveConfiguredMatrixAccountIds, d as resolveScopedMatrixEnvConfig, f as resolveMatrixAccountStringValues, l as resolveGlobalMatrixEnvConfig, s as resolveMatrixDefaultOrOnlyAccountId } from "./account-selection-BDeeqwwR.mjs";
-import { a as resolveMatrixAccountConfig, o as resolveMatrixBaseConfig, t as findMatrixAccountConfig } from "./account-config-CRsKoMqJ.mjs";
-import { a as loadMatrixCredentials, o as loadMatrixCredentialsAsync, r as credentialsMatchConfig, t as captureMatrixCredentialsEnv } from "./credentials-read-CqRiEAQa.mjs";
-import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/account-id";
-import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
-import { hasConfiguredSecretInput } from "openclaw/plugin-sdk/secret-input";
-//#region extensions/matrix/src/matrix/accounts.ts
-function clean(value) {
-	return normalizeOptionalString(value) ?? "";
-}
-function resolveMatrixAccountAuthView(params) {
-	const normalizedAccountId = normalizeAccountId(params.accountId);
-	const matrix = resolveMatrixBaseConfig(params.cfg);
-	const account = findMatrixAccountConfig(params.cfg, normalizedAccountId) ?? {};
-	const resolvedStrings = resolveMatrixAccountStringValues({
-		accountId: normalizedAccountId,
-		account: {
-			homeserver: clean(account.homeserver),
-			userId: clean(account.userId),
-			accessToken: typeof account.accessToken === "string" ? clean(account.accessToken) : "",
-			password: typeof account.password === "string" ? clean(account.password) : "",
-			deviceId: clean(account.deviceId),
-			deviceName: clean(account.deviceName)
-		},
-		scopedEnv: resolveScopedMatrixEnvConfig(normalizedAccountId, params.env),
-		channel: {
-			homeserver: clean(matrix.homeserver),
-			userId: clean(matrix.userId),
-			accessToken: typeof matrix.accessToken === "string" ? clean(matrix.accessToken) : "",
-			password: typeof matrix.password === "string" ? clean(matrix.password) : "",
-			deviceId: clean(matrix.deviceId),
-			deviceName: clean(matrix.deviceName)
-		},
-		globalEnv: resolveGlobalMatrixEnvConfig(params.env)
-	});
-	return {
-		homeserver: resolvedStrings.homeserver,
-		userId: resolvedStrings.userId,
-		accessToken: resolvedStrings.accessToken || void 0,
-		password: resolvedStrings.password || void 0
-	};
-}
-function resolveMatrixAccountUserId(authView, stored) {
-	const configuredUserId = authView.userId.trim();
-	if (configuredUserId) return configuredUserId;
-	if (!stored) return null;
-	if (authView.homeserver && stored.homeserver !== authView.homeserver) return null;
-	if (authView.accessToken && stored.accessToken !== authView.accessToken) return null;
-	return stored.userId.trim() || null;
-}
-function listMatrixAccountIds(cfg) {
-	const ids = resolveConfiguredMatrixAccountIds(cfg, process.env);
-	return ids.length > 0 ? ids : [DEFAULT_ACCOUNT_ID];
-}
-function resolveDefaultMatrixAccountId(cfg, env = process.env) {
-	return normalizeAccountId(resolveMatrixDefaultOrOnlyAccountId(cfg, env));
-}
-async function resolveConfiguredMatrixBotUserIds(params) {
-	const env = params.env ?? process.env;
-	const currentAccountId = normalizeAccountId(params.accountId);
-	const accounts = [.../* @__PURE__ */ new Set([...resolveConfiguredMatrixAccountIds(params.cfg, env), DEFAULT_ACCOUNT_ID])].filter((accountId) => normalizeAccountId(accountId) !== currentAccountId).map((accountId) => prepareMatrixAccount({
-		cfg: params.cfg,
-		accountId,
-		env
-	}));
-	const ids = /* @__PURE__ */ new Set();
-	if (accounts.length === 0 || params.abortSignal?.aborted) return ids;
-	const credentialsEnv = captureMatrixCredentialsEnv(env);
-	for (const prepared of accounts) {
-		if (params.abortSignal?.aborted) break;
-		const stored = await loadMatrixCredentialsAsync(credentialsEnv, prepared.account.accountId);
-		if (!isMatrixAccountConfigured(prepared, stored)) continue;
-		const userId = resolveMatrixAccountUserId(prepared.authView, stored);
-		if (userId) ids.add(userId);
-	}
-	return ids;
-}
-function prepareMatrixAccount(params) {
-	const env = params.env ?? process.env;
-	const accountId = normalizeAccountId(params.accountId ?? resolveDefaultMatrixAccountId(params.cfg, env));
-	const matrixBase = resolveMatrixBaseConfig(params.cfg);
-	const base = resolveMatrixAccountConfig({
-		cfg: params.cfg,
-		accountId,
-		env
-	});
-	const explicitAuthConfig = accountId === DEFAULT_ACCOUNT_ID ? base : findMatrixAccountConfig(params.cfg, accountId) ?? {};
-	const enabled = base.enabled !== false && matrixBase.enabled !== false;
-	const authView = resolveMatrixAccountAuthView({
-		cfg: params.cfg,
-		accountId,
-		env
-	});
-	const hasHomeserver = Boolean(authView.homeserver);
-	const hasUserId = Boolean(authView.userId);
-	const hasAccessToken = Boolean(authView.accessToken) || hasConfiguredSecretInput(explicitAuthConfig.accessToken);
-	const hasPassword = Boolean(authView.password);
-	const hasPasswordAuth = hasUserId && (hasPassword || hasConfiguredSecretInput(explicitAuthConfig.password));
-	return {
-		authView,
-		hasHomeserver,
-		hasConfiguredAuth: hasAccessToken || hasPasswordAuth,
-		account: {
-			accountId,
-			enabled,
-			name: normalizeOptionalString(base.name),
-			homeserver: authView.homeserver || void 0,
-			userId: authView.userId || void 0,
-			config: base
-		}
-	};
-}
-function isMatrixAccountConfigured(prepared, stored) {
-	const { authView } = prepared;
-	const hasStored = stored && authView.homeserver ? credentialsMatchConfig(stored, {
-		homeserver: authView.homeserver,
-		userId: authView.userId || ""
-	}) : false;
-	return prepared.hasHomeserver && (prepared.hasConfiguredAuth || hasStored);
-}
-function resolveMatrixAccount(params) {
-	const prepared = prepareMatrixAccount(params);
-	const stored = prepared.hasHomeserver && !prepared.hasConfiguredAuth ? loadMatrixCredentials(params.env ?? process.env, prepared.account.accountId) : null;
-	return {
-		...prepared.account,
-		configured: isMatrixAccountConfigured(prepared, stored)
-	};
-}
-async function resolveMatrixAccountAsync(params) {
-	const prepared = prepareMatrixAccount(params);
-	const stored = prepared.hasHomeserver && !prepared.hasConfiguredAuth ? await loadMatrixCredentialsAsync(captureMatrixCredentialsEnv(params.env ?? process.env), prepared.account.accountId) : null;
-	return {
-		...prepared.account,
-		configured: isMatrixAccountConfigured(prepared, stored)
-	};
-}
-//#endregion
-export { resolveMatrixAccountAsync as a, resolveMatrixAccount as i, resolveConfiguredMatrixBotUserIds as n, resolveDefaultMatrixAccountId as r, listMatrixAccountIds as t };

package/dist/.setup/config-update-CZndPxNd.mjs

@@ -1,102 +0,0 @@
-import { i as __exportAll } from "./doctor-contract-CsTNmbMa.mjs";
-import { t as findMatrixAccountConfig } from "./account-config-CRsKoMqJ.mjs";
-import { n as resolveMatrixConfigPath, r as shouldStoreMatrixAccountAtTopLevel, t as resolveMatrixConfigFieldPath } from "./config-paths-CnREYb1Y.mjs";
-import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/account-id";
-import { coerceSecretRef, normalizeSecretInputString } from "openclaw/plugin-sdk/secret-input";
-import { resolveOptionalIntegerOption } from "openclaw/plugin-sdk/number-runtime";
-//#region extensions/matrix/src/matrix/config-update.ts
-var config_update_exports = /* @__PURE__ */ __exportAll({
-	resolveMatrixConfigFieldPath: () => resolveMatrixConfigFieldPath,
-	resolveMatrixConfigPath: () => resolveMatrixConfigPath,
-	shouldStoreMatrixAccountAtTopLevel: () => shouldStoreMatrixAccountAtTopLevel,
-	updateMatrixAccountConfig: () => updateMatrixAccountConfig
-});
-function applyNullableField(target, key, value, normalize = (entry) => entry) {
-	if (value === void 0) return;
-	const normalized = value === null ? void 0 : normalize(value);
-	if (normalized === void 0) delete target[key];
-	else target[key] = normalized;
-}
-function normalizeMatrixSecretInput(value, key, defaults) {
-	if (typeof value === "string") return normalizeSecretInputString(value) || void 0;
-	const ref = coerceSecretRef(value, defaults);
-	if (!ref) throw new Error(`Invalid Matrix ${key} SecretInput.`);
-	return ref;
-}
-function cloneMatrixDmConfig(dm) {
-	return {
-		...dm,
-		...dm.allowFrom ? { allowFrom: [...dm.allowFrom] } : {}
-	};
-}
-function cloneMatrixRoomMap(rooms) {
-	if (!rooms) return rooms;
-	return Object.fromEntries(Object.entries(rooms).map(([roomId, roomCfg]) => [roomId, roomCfg ? { ...roomCfg } : roomCfg]));
-}
-function updateMatrixAccountConfig(cfg, accountId, patch) {
-	const matrix = cfg.channels?.matrix ?? {};
-	const normalizedAccountId = normalizeAccountId(accountId);
-	const nextAccount = { ...findMatrixAccountConfig(cfg, normalizedAccountId) ?? (normalizedAccountId === DEFAULT_ACCOUNT_ID ? matrix : {}) };
-	const trimString = (value) => value.trim() || void 0;
-	applyNullableField(nextAccount, "name", patch.name, trimString);
-	if (typeof patch.enabled === "boolean") nextAccount.enabled = patch.enabled;
-	else if (typeof nextAccount.enabled !== "boolean") nextAccount.enabled = true;
-	applyNullableField(nextAccount, "homeserver", patch.homeserver, trimString);
-	applyNullableField(nextAccount, "proxy", patch.proxy, trimString);
-	applyNullableField(nextAccount, "userId", patch.userId, trimString);
-	for (const key of ["accessToken", "password"]) applyNullableField(nextAccount, key, patch[key], (value) => normalizeMatrixSecretInput(value, key, cfg.secrets?.defaults));
-	applyNullableField(nextAccount, "deviceId", patch.deviceId, trimString);
-	applyNullableField(nextAccount, "deviceName", patch.deviceName, trimString);
-	applyNullableField(nextAccount, "avatarUrl", patch.avatarUrl, trimString);
-	if (patch.allowPrivateNetwork !== void 0) {
-		const nextNetwork = nextAccount.network && typeof nextAccount.network === "object" ? { ...nextAccount.network } : {};
-		if (patch.allowPrivateNetwork === null) delete nextNetwork.dangerouslyAllowPrivateNetwork;
-		else nextNetwork.dangerouslyAllowPrivateNetwork = patch.allowPrivateNetwork;
-		if (Object.keys(nextNetwork).length > 0) nextAccount.network = nextNetwork;
-		else delete nextAccount.network;
-	}
-	applyNullableField(nextAccount, "initialSyncLimit", patch.initialSyncLimit, (value) => resolveOptionalIntegerOption(value, { min: 0 }));
-	applyNullableField(nextAccount, "encryption", patch.encryption);
-	applyNullableField(nextAccount, "allowBots", patch.allowBots);
-	applyNullableField(nextAccount, "autoJoin", patch.autoJoin);
-	applyNullableField(nextAccount, "autoJoinAllowlist", patch.autoJoinAllowlist, (value) => [...value]);
-	applyNullableField(nextAccount, "dm", patch.dm, (value) => cloneMatrixDmConfig({
-		...nextAccount.dm,
-		...value
-	}));
-	applyNullableField(nextAccount, "groupPolicy", patch.groupPolicy);
-	applyNullableField(nextAccount, "groupAllowFrom", patch.groupAllowFrom, (value) => [...value]);
-	for (const key of ["groups", "rooms"]) applyNullableField(nextAccount, key, patch[key], cloneMatrixRoomMap);
-	const nextAccounts = Object.fromEntries(Object.entries(matrix.accounts ?? {}).filter(([rawAccountId]) => rawAccountId === normalizedAccountId || normalizeAccountId(rawAccountId) !== normalizedAccountId));
-	if (shouldStoreMatrixAccountAtTopLevel(cfg, normalizedAccountId)) {
-		const { accounts: _ignoredAccounts, defaultAccount } = matrix;
-		const { accounts: _ignoredNextAccounts, defaultAccount: _ignoredNextDefaultAccount, ...topLevelAccount } = nextAccount;
-		return {
-			...cfg,
-			channels: {
-				...cfg.channels,
-				matrix: {
-					...defaultAccount ? { defaultAccount } : {},
-					enabled: true,
-					...topLevelAccount
-				}
-			}
-		};
-	}
-	return {
-		...cfg,
-		channels: {
-			...cfg.channels,
-			matrix: {
-				...matrix,
-				enabled: true,
-				accounts: {
-					...nextAccounts,
-					[normalizedAccountId]: nextAccount
-				}
-			}
-		}
-	};
-}
-//#endregion
-export { updateMatrixAccountConfig as n, config_update_exports as t };

package/dist/.setup/profile-DS0xdJAi.mjs

@@ -1,80 +0,0 @@
-import { i as __exportAll } from "./doctor-contract-CsTNmbMa.mjs";
-import { normalizeLowercaseStringOrEmpty, normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
-//#region extensions/matrix/src/matrix/profile.ts
-var profile_exports = /* @__PURE__ */ __exportAll({
-	isSupportedMatrixAvatarSource: () => isSupportedMatrixAvatarSource,
-	syncMatrixOwnProfile: () => syncMatrixOwnProfile
-});
-const MATRIX_PROFILE_AVATAR_MAX_BYTES = 10485760;
-function isMatrixMxcUri(value) {
-	return normalizeLowercaseStringOrEmpty(value).startsWith("mxc://");
-}
-function isMatrixHttpAvatarUri(value) {
-	const normalized = normalizeLowercaseStringOrEmpty(value);
-	return normalized.startsWith("https://") || normalized.startsWith("http://");
-}
-function isSupportedMatrixAvatarSource(value) {
-	return isMatrixMxcUri(value) || isMatrixHttpAvatarUri(value);
-}
-async function resolveAvatarUrl(params) {
-	const avatarPath = normalizeOptionalString(params.avatarPath) ?? null;
-	const avatarSource = avatarPath ?? normalizeOptionalString(params.avatarUrl) ?? null;
-	if (!avatarSource || !avatarPath && isMatrixMxcUri(avatarSource)) return {
-		resolvedAvatarUrl: avatarSource,
-		uploadedAvatarSource: null,
-		convertedAvatarFromHttp: false
-	};
-	if (!avatarPath && !isMatrixHttpAvatarUri(avatarSource)) throw new Error("Matrix avatar URL must be an mxc:// URI or an http(s) URL.");
-	const loadAvatar = avatarPath ? params.loadAvatarFromPath : params.loadAvatarFromUrl;
-	if (!loadAvatar) throw new Error(avatarPath ? "Matrix avatar path upload requires a media loader." : "Matrix avatar URL conversion requires a media loader.");
-	const media = await loadAvatar(avatarSource, params.avatarMaxBytes);
-	return {
-		resolvedAvatarUrl: await params.client.uploadContent(media.buffer, media.contentType, media.fileName || "avatar"),
-		uploadedAvatarSource: avatarPath ? "path" : "http",
-		convertedAvatarFromHttp: !avatarPath
-	};
-}
-async function syncMatrixOwnProfile(params) {
-	const desiredDisplayName = normalizeOptionalString(params.displayName) ?? null;
-	const avatar = await resolveAvatarUrl({
-		client: params.client,
-		avatarUrl: params.avatarUrl ?? null,
-		avatarPath: params.avatarPath ?? null,
-		avatarMaxBytes: params.avatarMaxBytes ?? MATRIX_PROFILE_AVATAR_MAX_BYTES,
-		loadAvatarFromUrl: params.loadAvatarFromUrl,
-		loadAvatarFromPath: params.loadAvatarFromPath
-	});
-	const desiredAvatarUrl = avatar.resolvedAvatarUrl;
-	if (!desiredDisplayName && !desiredAvatarUrl) return {
-		skipped: true,
-		displayNameUpdated: false,
-		avatarUpdated: false,
-		...avatar,
-		resolvedAvatarUrl: null
-	};
-	let currentDisplayName;
-	let currentAvatarUrl;
-	try {
-		const currentProfile = await params.client.getUserProfile(params.userId);
-		currentDisplayName = normalizeOptionalString(currentProfile.displayname);
-		currentAvatarUrl = normalizeOptionalString(currentProfile.avatar_url);
-	} catch {}
-	let displayNameUpdated = false;
-	let avatarUpdated = false;
-	if (desiredDisplayName && currentDisplayName !== desiredDisplayName) {
-		await params.client.setDisplayName(desiredDisplayName);
-		displayNameUpdated = true;
-	}
-	if (desiredAvatarUrl && currentAvatarUrl !== desiredAvatarUrl) {
-		await params.client.setAvatarUrl(desiredAvatarUrl);
-		avatarUpdated = true;
-	}
-	return {
-		skipped: false,
-		displayNameUpdated,
-		avatarUpdated,
-		...avatar
-	};
-}
-//#endregion
-export { profile_exports as n, syncMatrixOwnProfile as r, isSupportedMatrixAvatarSource as t };