Skip to content

OpenAI's Codex Security CLI and TypeScript SDK for finding, validating, and fixing security vulnerabilities. npm: https://www.npmjs.com/package/@openai/codex-security

refactor(plugin): store each MCP runtime in one Brotli file (#2469)

Michael D'Angelof8edafd5dcf6
diff --git a/plugins/codex-security/mcp-app/scripts/build_mcp_app.mjs b/plugins/codex-security/mcp-app/scripts/build_mcp_app.mjs
index 82b2e33ff..7d60d4f91 100644
--- a/plugins/codex-security/mcp-app/scripts/build_mcp_app.mjs
+++ b/plugins/codex-security/mcp-app/scripts/build_mcp_app.mjs
@@ -8,7 +8,6 @@ import { build } from "esbuild";
import { buildNativeWrappers } from "./build_native_wrappers.mjs";
const root = resolve(import.meta.dirname, "..");
-const maxChunkBytes = 140_000;
export async function buildMcpApp({ output, native = "universal" }) {
if (native !== "universal" && native !== "host") {
@@ -133,18 +132,9 @@ export async function buildMcpApp({ output, native = "universal" }) {
const runtime = brotliCompressSync(result.outputFiles[0].contents, {
params: { [zlibConstants.BROTLI_PARAM_QUALITY]: 10 },
});
- const chunkPrefix = name + ".mjs.br.part-";
- await writeFile(join(mcpDir, name + ".mjs"), loader(chunkPrefix), "utf8");
- for (
- let offset = 0, index = 0;
- offset < runtime.length;
- offset += maxChunkBytes, index += 1
- ) {
- await writeFile(
- join(mcpDir, chunkPrefix + String(index).padStart(3, "0")),
- runtime.subarray(offset, offset + maxChunkBytes),
- );
- }
+ const payload = name + ".mjs.br";
+ await writeFile(join(mcpDir, payload), runtime);
+ await writeFile(join(mcpDir, name + ".mjs"), loader(payload), "utf8");
}
}
@@ -186,23 +176,14 @@ if (isMain()) {
}
}
-function loader(chunkPrefix) {
- return `import { Buffer } from "node:buffer";
-import { readFile, readdir } from "node:fs/promises";
+function loader(payload) {
+ return `import { readFile } from "node:fs/promises";
import { dirname } from "node:path";
import { createRequire } from "node:module";
import { fileURLToPath } from "node:url";
import { brotliDecompressSync } from "node:zlib";
-const runtimeChunkNames = (await readdir(new URL("./", import.meta.url)))
- .filter((name) => name.startsWith("${chunkPrefix}"))
- .sort();
-if (!runtimeChunkNames.length) {
- throw new Error("Missing compressed Codex Security MCP server runtime chunks.");
-}
-const compressedRuntime = Buffer.concat(
- await Promise.all(runtimeChunkNames.map((name) => readFile(new URL(\`./\${name}\`, import.meta.url))))
-);
+const compressedRuntime = await readFile(new URL("./${payload}", import.meta.url));
const runtimeSource = brotliDecompressSync(compressedRuntime).toString("utf8");
const require = createRequire(import.meta.url);
const Module = require("node:module");
diff --git a/plugins/codex-security/plugin-files.json b/plugins/codex-security/plugin-files.json
index bfb747119..93139f557 100644
--- a/plugins/codex-security/plugin-files.json
+++ b/plugins/codex-security/plugin-files.json
@@ -13,8 +13,7 @@
"examples/legacy-completed-scan/scan-manifest.json",
"mcp/fzstd-LICENSE.txt",
"mcp/helpers.mjs",
- "mcp/helpers.mjs.br.part-000",
- "mcp/helpers.mjs.br.part-001",
+ "mcp/helpers.mjs.br",
"mcp/native/COPYRIGHT-library.html",
"mcp/native/THIRD_PARTY_NOTICES.txt",
"mcp/native/darwin-arm64/unix.node",
@@ -32,9 +31,7 @@
"mcp/package.json",
"mcp/permission-profile-preflight.mjs",
"mcp/server.mjs",
- "mcp/server.mjs.br.part-000",
- "mcp/server.mjs.br.part-001",
- "mcp/server.mjs.br.part-002",
+ "mcp/server.mjs.br",
"mcp/session-decompression.mjs",
"references/access-advisory.md",
"references/artifact-storage.md",
diff --git a/sdk/typescript/TESTING.md b/sdk/typescript/TESTING.md
index fd1eabe7f..00798860a 100644
--- a/sdk/typescript/TESTING.md
+++ b/sdk/typescript/TESTING.md
@@ -63,8 +63,9 @@ The authored plugin lives in `plugins/codex-security`. `pnpm pack` generates
the ignored `_bundled_plugin` runtime payload from `plugins/codex-security/plugin-files.json` during
`prepack`, including the MCP runtime built from `mcp-app`; do not edit generated
files there. Run `pnpm run build:plugin` when you need to inspect the staged
-payload locally. `plugins/codex-security` contains authored source and assets,
-not the generated `mcp/server.mjs` or compressed runtime chunks.
+payload locally. Rebuilding replaces the entire generated directory, including
+any numbered Brotli parts from earlier builds. Each MCP entrypoint now loads
+its matching `.mjs.br` file.
`pnpm run check:plugin-source` fails if any file beneath `_bundled_plugin` is
tracked by Git. Required CI runs the same check before installing dependencies.
diff --git a/sdk/typescript/tests-ts/build-plugin.test.ts b/sdk/typescript/tests-ts/build-plugin.test.ts
index e02c08fde..0b82e255f 100644
--- a/sdk/typescript/tests-ts/build-plugin.test.ts
+++ b/sdk/typescript/tests-ts/build-plugin.test.ts
@@ -181,6 +181,7 @@ describe("bundled plugin build", () => {
if (process.platform !== "win32") await chmod(join(bin, launcher), 0o755);
const destination = join(root, "mcp");
+ await writeFixture(destination, "helpers.mjs.br.part-000", "stale");
await execFileAsync(
"node",
[
@@ -211,15 +212,8 @@ describe("bundled plugin build", () => {
.map((path) => path.slice(4))
.sort(),
);
- const chunks = (await readdir(destination))
- .filter((name) => name.startsWith("helpers.mjs.br.part-"))
- .sort();
const runtime = brotliDecompressSync(
- Buffer.concat(
- await Promise.all(
- chunks.map((name) => readFile(join(destination, name))),
- ),
- ),
+ await readFile(join(destination, "helpers.mjs.br")),
).toString("utf8");
for (const marker of [
"platform-source-marker",