UNPKG

openclaw

Version:

Multi-channel AI gateway with extensible messaging integrations

138 lines (137 loc) 7.19 kB
import { c as resolveUserPath } from "./home-dir-BPhrG-aM.js"; import "./utils-P__uGsPB.js"; import { a as pluginCacheRealpathSync, r as pluginCacheExistsSync } from "./plugin-cache-files-DLPF_Tw2.js"; import { i as resolveBundledPluginsDir, t as areBundledPluginsDisabled } from "./bundled-dir-BEfbEeCF.js"; import { t as resolvePluginRootArtifactPath } from "./root-artifact-path-BqN5KCyd.js"; import path from "node:path"; //#region src/plugins/public-surface-runtime.ts const PUBLIC_SURFACE_SOURCE_EXTENSIONS = [ ".ts", ".mts", ".js", ".mjs", ".cts", ".cjs" ]; /** Normalizes a bundled public artifact subpath and rejects traversal/absolute paths. */ function normalizeBundledPluginArtifactSubpath(artifactBasename) { if (path.posix.isAbsolute(artifactBasename) || path.win32.isAbsolute(artifactBasename) || artifactBasename.includes("\\")) throw new Error(`Bundled plugin artifact path must stay plugin-local: ${artifactBasename}`); const normalized = artifactBasename.replace(/^\.\//u, ""); if (!normalized) throw new Error("Bundled plugin artifact path must not be empty"); if (normalized.split("/").some((segment) => segment.length === 0 || segment === "." || segment === ".." || segment.includes(":"))) throw new Error(`Bundled plugin artifact path must stay plugin-local: ${artifactBasename}`); return normalized; } /** Normalizes a bundled plugin directory name and rejects path-like values. */ function normalizeBundledPluginDirName(dirName) { const normalized = dirName.trim(); if (!normalized || normalized === "." || normalized === ".." || normalized.includes("/") || normalized.includes("\\") || normalized.includes(":")) throw new Error(`Bundled plugin dirName must be a single directory: ${dirName}`); return normalized; } /** Resolves a source-tree public surface artifact path for bundled plugin development. */ function resolveBundledPluginSourcePublicSurfacePath(params) { const artifactBasename = normalizeBundledPluginArtifactSubpath(params.artifactBasename); const dirName = normalizeBundledPluginDirName(params.dirName); const sourceBaseName = artifactBasename.replace(/\.js$/u, ""); for (const ext of PUBLIC_SURFACE_SOURCE_EXTENSIONS) { const sourceCandidate = path.resolve(params.sourceRoot, dirName, `${sourceBaseName}${ext}`); if (pluginCacheExistsSync(sourceCandidate)) return sourceCandidate; } return null; } /** Resolves a public surface artifact within one installed plugin root. */ function resolvePluginRootPublicSurfacePath(params) { const artifactBasename = normalizeBundledPluginArtifactSubpath(params.artifactBasename); const pluginRoot = path.resolve(params.pluginRoot); const builtCandidate = resolvePluginRootArtifactPath(pluginRoot, [artifactBasename, path.join("dist", artifactBasename)]); if (builtCandidate) return builtCandidate; const sourceBaseName = artifactBasename.replace(/\.js$/u, ""); for (const ext of PUBLIC_SURFACE_SOURCE_EXTENSIONS) { const candidate = path.join(pluginRoot, `${sourceBaseName}${ext}`); if (pluginCacheExistsSync(candidate)) return candidate; } return null; } function resolvePackageFallbackForBundledDir(params) { const normalizedBundledDir = path.resolve(params.bundledPluginsDir); const normalizedRootDir = path.resolve(params.rootDir); const packageBundledDirs = [path.join(normalizedRootDir, "dist", "extensions"), path.join(normalizedRootDir, "dist-runtime", "extensions")]; if (!packageBundledDirs.includes(normalizedBundledDir)) return null; for (const packageBundledDir of packageBundledDirs) { if (packageBundledDir === normalizedBundledDir) continue; const builtCandidate = path.join(packageBundledDir, params.dirName, params.artifactBasename); if (pluginCacheExistsSync(builtCandidate)) return builtCandidate; } return resolveRetainedConfigDoctorPath(params) ?? resolveBundledPluginSourcePublicSurfacePath({ sourceRoot: path.join(normalizedRootDir, "extensions"), dirName: params.dirName, artifactBasename: params.artifactBasename }); } function resolveRetainedConfigDoctorPath(params) { if (params.artifactBasename !== "config-doctor-api.js") return null; for (const dist of ["dist", "dist-runtime"]) { const candidate = path.resolve(params.rootDir, dist, "config-doctor", `${params.dirName}.js`); if (pluginCacheExistsSync(candidate)) return candidate; } return null; } function sameExistingPath(left, right) { const canonicalLeft = pluginCacheRealpathSync(left); return canonicalLeft !== null && canonicalLeft === pluginCacheRealpathSync(right); } function resolveExplicitEnvBundledPluginsDir(env) { const envOverride = env.OPENCLAW_BUNDLED_PLUGINS_DIR?.trim(); if (!envOverride) return; const bundledPluginsDir = resolveBundledPluginsDir(env); if (!bundledPluginsDir) return; return sameExistingPath(resolveUserPath(envOverride, env), bundledPluginsDir) ? bundledPluginsDir : void 0; } function resolvePublicSurfaceFromBundledDir(params) { return resolvePluginRootPublicSurfacePath({ pluginRoot: path.resolve(params.bundledPluginsDir, params.dirName), artifactBasename: params.artifactBasename }) ?? resolvePackageFallbackForBundledDir({ rootDir: params.rootDir, bundledPluginsDir: params.bundledPluginsDir, dirName: params.dirName, artifactBasename: params.artifactBasename }); } /** Resolves a bundled plugin public surface artifact across source, dist, and package layouts. */ function resolveBundledPluginPublicSurfacePath(params) { const artifactBasename = normalizeBundledPluginArtifactSubpath(params.artifactBasename); const dirName = normalizeBundledPluginDirName(params.dirName); const env = params.env ?? process.env; const explicitBundledPluginsDir = params.bundledPluginsDirMode === "auto" ? resolveExplicitEnvBundledPluginsDir(env) : params.bundledPluginsDir ?? resolveExplicitEnvBundledPluginsDir(env); if (explicitBundledPluginsDir) return resolvePublicSurfaceFromBundledDir({ rootDir: params.rootDir, bundledPluginsDir: explicitBundledPluginsDir, dirName, artifactBasename }); if (areBundledPluginsDisabled(env)) return null; const sourceCandidate = resolveBundledPluginSourcePublicSurfacePath({ sourceRoot: path.resolve(params.rootDir, "extensions"), dirName, artifactBasename }); if (sourceCandidate) return sourceCandidate; const bundledPluginsDir = params.bundledPluginsDirMode === "auto" ? params.bundledPluginsDir : resolveBundledPluginsDir(env); if (bundledPluginsDir) { const bundledCandidate = resolvePublicSurfaceFromBundledDir({ rootDir: params.rootDir, bundledPluginsDir, dirName, artifactBasename }); if (bundledCandidate) return bundledCandidate; } for (const candidate of [path.resolve(params.rootDir, "dist", "extensions", dirName, artifactBasename), path.resolve(params.rootDir, "dist-runtime", "extensions", dirName, artifactBasename)]) if (pluginCacheExistsSync(candidate)) return candidate; return resolveRetainedConfigDoctorPath({ ...params, dirName, artifactBasename }); } //#endregion export { resolvePluginRootPublicSurfacePath as a, resolveBundledPluginSourcePublicSurfacePath as i, normalizeBundledPluginArtifactSubpath as n, resolveBundledPluginPublicSurfacePath as r, PUBLIC_SURFACE_SOURCE_EXTENSIONS as t };