openclaw/scripts/lib/docker-plugin-selection.mjs

import fs from "node:fs";
import path from "node:path";
import { pathToFileURL } from "node:url";

const PLUGIN_ID_RE = /^[a-z0-9][a-z0-9-]*$/u;

function readManifestId(pluginDir) {
  const manifestPath = path.join(pluginDir, "openclaw.plugin.json");
  if (!fs.existsSync(manifestPath)) {
    return null;
  }
  const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
  return typeof manifest.id === "string" && manifest.id.length > 0 ? manifest.id : null;
}

function collectPluginIdentities(extensionsRoot) {
  return fs
    .readdirSync(extensionsRoot, { withFileTypes: true })
    .filter((entry) => entry.isDirectory())
    .map((entry) => {
      const pluginDir = path.join(extensionsRoot, entry.name);
      const hasPackageJson = fs.existsSync(path.join(pluginDir, "package.json"));
      const manifestId = readManifestId(pluginDir);
      return {
        dirName: entry.name,
        manifestId,
        known: hasPackageJson || manifestId !== null,
      };
    })
    .filter((entry) => entry.known)
    .toSorted((left, right) => left.dirName.localeCompare(right.dirName));
}

/** Resolve public Docker selections to the source directories used by build and prune steps. */
export function resolveDockerPluginSelection(params) {
  const selection = typeof params.selection === "string" ? params.selection : "";
  const selectedIds = new Set(
    selection
      .split(/[\s,]+/u)
      .map((entry) => entry.trim())
      .filter(Boolean),
  );
  const plugins = collectPluginIdentities(params.extensionsRoot);
  const resolvedDirs = new Set();

  for (const selectedId of selectedIds) {
    if (!PLUGIN_ID_RE.test(selectedId)) {
      throw new Error(`invalid OPENCLAW_EXTENSIONS plugin id: ${selectedId}`);
    }
    const matches = plugins.filter(
      (plugin) => plugin.dirName === selectedId || plugin.manifestId === selectedId,
    );
    if (matches.length === 0) {
      throw new Error(`unknown OPENCLAW_EXTENSIONS plugin id: ${selectedId}`);
    }
    if (matches.length > 1) {
      throw new Error(
        `ambiguous OPENCLAW_EXTENSIONS plugin id: ${selectedId} (${matches
          .map((plugin) => plugin.dirName)
          .join(", ")})`,
      );
    }
    resolvedDirs.add(matches[0].dirName);
  }

  return [...resolvedDirs].toSorted((left, right) => left.localeCompare(right));
}

if (import.meta.url === pathToFileURL(process.argv[1] ?? "").href) {
  try {
    const resolved = resolveDockerPluginSelection({
      extensionsRoot: process.argv[2],
      selection: process.argv[3] ?? "",
    });
    if (resolved.length > 0) {
      process.stdout.write(`${resolved.join("\n")}\n`);
    }
  } catch (error) {
    const message = error instanceof Error ? error.message : String(error);
    console.error(`ERROR: ${message}`);
    process.exitCode = 1;
  }
}