Function scanCodexPlugins

packages/plugins/mcp/src/sdk/codex-plugins.ts:388–453

(options?: {
  readonly codexHome?: string;
  /** Explicit `codex` CLI path (tests); default resolves PATH + fallbacks. */
  readonly codexCli?: string;
})

 * as scanned and spawned directly.
 */
export const scanCodexPlugins = (options?: {
  readonly codexHome?: string;
  /** Explicit `codex` CLI path (tests); default resolves PATH + fallbacks. */
  readonly codexCli?: string;
}): readonly CodexPluginEntry[] => {
  const codexHome =
    options?.codexHome ?? process.env["CODEX_HOME"] ?? path.join(os.homedir(), ".codex");

  const codexCli = resolveCodexCli(options?.codexCli);
  const computerUseApp = isExecutableFile(clientBinaryPath(codexHome));
  const browserClient = browserClientPath(codexHome);
  const chromePlugin = isReadableFile(browserClient);

  /** Each curated card states what it needs; the `codex` CLI is required by
   *  all of them because every one is reached through `codex app-server`. */
  const requirementMet: Record<CuratedCodexPlugin["requires"], boolean> = {
    "computer-use-app": computerUseApp,
    "chrome-plugin": chromePlugin,
    codex: true,
  };

  const curated: readonly CodexPluginEntry[] = CURATED_CODEX_PLUGINS.map((entry) => {
    const display = curatedDisplayMetadata(codexHome, entry.pluginName);
    const available = codexCli !== undefined && requirementMet[entry.requires];
    return {
      id: entry.id,
      name: entry.name,
      summary: entry.summary,
      available,
      slug: entry.slug,
      source: "curated" as const,
      command: codexCli ?? "codex",
      args: ["app-server"],
      env: { CODEX_HOME: codexHome },
      appServer: {
        server: entry.server,
        ...(entry.surface === undefined ? {} : { surface: entry.surface }),
        ...(entry.surface === "browser" ? { modulePath: browserClient } : {}),
      },
      ...(available
        ? {}
        : { setupHint: setupHint(entry.requires, entry.name), setupUrl: setupUrl(entry.requires) }),
      fallbackIcon: entry.publicIcon ?? "https://integrations.sh/logo/openai.com",
      ...display,
    };
  });

  const cacheDir = path.join(codexHome, "plugins", "cache");
  const scanned = listDirs(cacheDir).flatMap((sourceName) => {
    const sourceDir = path.join(cacheDir, sourceName);
    return listDirs(sourceDir)
      .filter((pluginName) => !CURATED_PLUGIN_NAMES.has(pluginName))
      .flatMap((pluginName) =>
        scanCachedPlugin(codexHome, path.join(sourceDir, pluginName), pluginName),
      );
  });

  // One card per id: the same plugin can appear under several cache sources