import fs from "node:fs";

import { createRequire } from "node:module";

import path from "node:path";

import { fileURLToPath } from "node:url";

import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";

import type { RuntimeEnv } from "openclaw/plugin-sdk/runtime";

log?: (message: string) => void;

};

function resolveMissingMatrixPackages(): string[] {

function resolveMissingMatrixPackages(resolveFn?: (id: string) => string): string[] {

try {

const req = createRequire(import.meta.url);

const resolve = resolveFn ?? defaultResolveFn;

return REQUIRED_MATRIX_PACKAGES.filter((pkg) => {

try {

req.resolve(pkg);

resolve(pkg);

return false;

} catch {

return true;

return resolveMissingMatrixPackages().length === 0;

}

function resolvePluginRoot(): string {

const currentDir = path.dirname(fileURLToPath(import.meta.url));

return path.resolve(currentDir, "..", "..");

function buildMatrixDepsMissingMessage(missing: string[]): string {

const packages = missing.length > 0 ? missing.join(", ") : REQUIRED_MATRIX_PACKAGES.join(", ");

return [

`Matrix plugin dependencies are missing: ${packages}.`,

"Repair this plugin with `openclaw plugins update matrix` or run `openclaw doctor --fix`.",

].join(" ");

}

type CommandResult = {

requireFn("@matrix-org/matrix-sdk-crypto-nodejs");

}

export async function ensureMatrixSdkInstalled(params: {

runtime: RuntimeEnv;

export async function ensureMatrixSdkInstalled(params?: {

runtime?: RuntimeEnv;

confirm?: (message: string) => Promise<boolean>;

resolveFn?: (id: string) => string;

}): Promise<void> {

if (isMatrixSdkAvailable()) {

const missing = resolveMissingMatrixPackages(params?.resolveFn);

if (missing.length === 0) {

return;

}

const confirm = params.confirm;

if (confirm) {

const ok = await confirm(

"Matrix requires matrix-js-sdk, @matrix-org/matrix-sdk-crypto-nodejs, and @matrix-org/matrix-sdk-crypto-wasm. Install now?",

);

if (!ok) {

throw new Error(

"Matrix requires matrix-js-sdk, @matrix-org/matrix-sdk-crypto-nodejs, and @matrix-org/matrix-sdk-crypto-wasm (install dependencies first).",

);

}

}

const root = resolvePluginRoot();

const command = fs.existsSync(path.join(root, "pnpm-lock.yaml"))

? ["pnpm", "install"]

: ["npm", "install", "--omit=dev", "--silent"];

params.runtime.log?.(`matrix: installing dependencies via ${command[0]} (${root})…`);

const result = await runFixedCommandWithTimeout({

argv: command,

cwd: root,

timeoutMs: 300_000,

env: { COREPACK_ENABLE_DOWNLOAD_PROMPT: "0" },

});

if (result.code !== 0) {

throw new Error(

result.stderr.trim() || result.stdout.trim() || "Matrix dependency install failed.",

);

}

if (!isMatrixSdkAvailable()) {

const missing = resolveMissingMatrixPackages();

throw new Error(

missing.length > 0

? `Matrix dependency install completed but required packages are still missing: ${missing.join(", ")}`

: "Matrix dependency install completed but Matrix dependencies are still missing.",

);

}

throw new Error(buildMatrixDepsMissingMessage(missing));

}