import { resolveLegacyMatrixFlatStoreTarget } from "./migration-config.js";

import { resolveMatrixLegacyFlatStoragePaths } from "./storage-paths.js";

export type MatrixLegacyStateMigrationResult = {

type MatrixLegacyStateMigrationResult = {

migrated: boolean;

changes: string[];

warnings: string[];

export type MatrixRoomKeyBackupStatusLike = {

type MatrixRoomKeyBackupStatusLike = {

serverVersion: string | null;

activeVersion: string | null;

trusted: boolean | null;

keyLoadError: string | null;

};

export type MatrixRoomKeyBackupIssueCode =

type MatrixRoomKeyBackupIssueCode =

| "missing-server-backup"

| "key-load-failed"

| "key-not-loaded"

| "indeterminate"

| "ok";

export type MatrixRoomKeyBackupIssue = {

type MatrixRoomKeyBackupIssue = {

code: MatrixRoomKeyBackupIssueCode;

summary: string;

message: string | null;

resolveGlobalMatrixEnvConfig,

resolveMatrixEnvAuthReadiness,

resolveScopedMatrixEnvConfig,

type MatrixEnvConfig,

} from "./env-auth.js";

import { repairCurrentTokenStorageMetaDeviceId } from "./storage.js";

import type { MatrixAuth, MatrixResolvedConfig } from "./types.js";

export { getMatrixScopedEnvVarNames } from "../../env-vars.js";

export {

hasReadyMatrixEnvAuth,

resolveGlobalMatrixEnvConfig,

resolveMatrixEnvAuthReadiness,

resolveScopedMatrixEnvConfig,

type MatrixEnvConfig,

} from "./env-auth.js";

export {

resolveValidatedMatrixHomeserverUrl,

import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/account-id";

import { getMatrixScopedEnvVarNames } from "../../env-vars.js";

export type MatrixEnvConfig = {

type MatrixEnvConfig = {

homeserver: string;

userId: string;

accessToken?: string;

import type { MatrixAuth } from "./types.js";

import type { MatrixStoragePaths } from "./types.js";

export const DEFAULT_ACCOUNT_KEY = "default";

const DEFAULT_ACCOUNT_KEY = "default";

const STORAGE_META_FILENAME = "storage-meta.json";

const THREAD_BINDINGS_FILENAME = "thread-bindings.json";

const LEGACY_CRYPTO_MIGRATION_FILENAME = "legacy-crypto-migration.json";

import type { CoreConfig } from "../types.js";

import { resolveMatrixConfigFieldPath } from "./config-paths.js";

export function resolveMatrixEncryptionConfigPath(

cfg: CoreConfig,

accountId?: string | null,

): string {

function resolveMatrixEncryptionConfigPath(cfg: CoreConfig, accountId?: string | null): string {

const effectiveAccountId =

normalizeOptionalAccountId(accountId) ?? resolveMatrixDefaultOrOnlyAccountId(cfg);

return resolveMatrixConfigFieldPath(cfg, effectiveAccountId, "encryption");

export const MATRIX_MEDIA_SIZE_LIMIT_ERROR_MESSAGE = "Matrix media exceeds configured size limit";

const MATRIX_MEDIA_SIZE_LIMIT_ERROR_MESSAGE = "Matrix media exceeds configured size limit";

export class MatrixMediaSizeLimitError extends Error {

readonly code = "MATRIX_MEDIA_SIZE_LIMIT" as const;

return params.unavailable ? `[matrix ${label} unavailable]` : `[matrix ${label}]`;

}

export function isLikelyBareFilename(text: string): boolean {

function isLikelyBareFilename(text: string): boolean {

const trimmed = text.trim();

if (!trimmed || trimmed.includes("\n") || /\s/.test(trimmed)) {

return false;

return attachment.caption;

}

export function formatMatrixAttachmentText(params: {

function formatMatrixAttachmentText(params: {

attachment?: MatrixMessageAttachmentSummary;

tooLarge?: boolean;

unavailable?: boolean;

matchSource?: "wildcard" | "id" | "prefixed-id" | "prefixed-user";

};

export type MatrixMonitorAccessState = {

type MatrixMonitorAccessState = {

effectiveAllowFrom: string[];

effectiveGroupAllowFrom: string[];

effectiveRoomUsers: string[];

return normalizeAllowList(list).map((entry) => normalizeMatrixAllowListEntry(entry));

}

export type MatrixAllowListMatch = AllowlistMatch<

"wildcard" | "id" | "prefixed-id" | "prefixed-user"

>;

type MatrixAllowListMatch = AllowlistMatch<"wildcard" | "id" | "prefixed-id" | "prefixed-user">;

type MatrixAllowListMatchSource = NonNullable<MatrixAllowListMatch["matchSource"]>;