Function scanCachedPlugin

packages/plugins/mcp/src/sdk/codex-plugins.ts:297–376

(
  codexHome: string,
  pluginDir: string,
  pluginName: string,
)

// ---------------------------------------------------------------------------

const scanCachedPlugin = (
  codexHome: string,
  pluginDir: string,
  pluginName: string,
): readonly CodexPluginEntry[] => {
  const versions = [...listDirs(pluginDir)].sort(compareVersionsDesc);
  const version = versions[0];
  if (version === undefined) return [];
  const versionDir = path.join(pluginDir, version);

  const manifest = Option.getOrUndefined(
    decodeManifestJson(readText(path.join(versionDir, ".codex-plugin", "plugin.json"))),
  );
  if (manifest?.mcpServers === undefined) return [];

  // `mcpServers` is a relative path to an `.mcp.json` in every known manifest;
  // tolerate an inline object of the same shape.
  const servers = Option.getOrUndefined(
    typeof manifest.mcpServers === "string"
      ? decodeServersFileJson(readText(path.resolve(versionDir, manifest.mcpServers)))
      : decodeServersFile({ mcpServers: manifest.mcpServers }),
  );
  if (servers === undefined) return [];

  const displayName = manifest.interface?.displayName ?? manifest.name;
  const summary =
    manifest.interface?.shortDescription ??
    manifest.description?.split("\n")[0] ??
    `Local MCP server from the Codex plugin "${manifest.name}".`;
  const icon =
    manifest.interface?.logo === undefined
      ? undefined
      : readIconDataUri(path.resolve(versionDir, manifest.interface.logo));
  const display: CodexPluginDisplay = {
    ...(icon === undefined ? {} : { icon }),
    ...(manifest.interface?.displayName === undefined
      ? {}
      : { displayName: manifest.interface.displayName }),
    ...(manifest.interface?.shortDescription === undefined
      ? {}
      : { tagline: manifest.interface.shortDescription }),
    ...(manifest.interface?.longDescription === undefined
      ? {}
      : { description: manifest.interface.longDescription }),
  };

  const localServers = Object.entries(servers.mcpServers).flatMap(([serverKey, spec]) =>
    spec.command !== undefined && spec.type !== "http" && spec.url === undefined
      ? [{ serverKey, command: spec.command, args: spec.args, cwd: spec.cwd }]
      : [],
  );

  return localServers.map(({ serverKey, ...spec }) => {
    // Manifest paths are relative to the versioned plugin dir. The versioned
    // dir moves on plugin updates — the connection health check surfaces that
    // as "command missing" and the card re-adds against the new path.
    const command = path.resolve(versionDir, spec.command);
    const cwd = path.resolve(versionDir, spec.cwd ?? ".");