A local plugin for image-heavy chats in Codex, Claude Code and other agents: earlier images stop going out with every message, and the model fetches the one it needs by its ID, also after compaction.
TypeScript ai-agentsclaude-codeclaude-code-plugincodexcodex-plugincontext-managementdeveloper-toolsimage-generationmcpmultimodal
// Purpose: P3-4 — installing writes every managed block (and .env only when needed); uninstalling restores both
// files byte for byte; a conflict leaves everything untouched.
// P5 — the MCP server comes with the plugin: installing writes no server block and removes one an earlier install
// left; the plugin's own entries in config.toml (written by Codex) are read correctly.
// Input: synthetic config and .env texts; output: Node test assertions only.
import assert from "node:assert/strict";
import test from "node:test";
import { enableMcpServer } from "../../plugin/src/adapters/codex/codexconfig.ts";
import { needsNoProxy, planInstall, planUninstall, pluginStatus, SERVER_NAME } from "../../plugin/src/adapters/codex/install.ts";
// These tests check the Chinese wording: the language is fixed, so neither the system's language nor one a panel
// reported on this machine decides it (v0.1-14).
process.env.CAM_LANG = "zh";
const CONFIG = 'model = "gpt-6-sol"\n\n[features]\nview_image = true\n\n[projects.\'d:\\\\work\']\ntrust_level = "trusted"\n';
const base = { port: 17891 };
const proxied = { httpProxy: "http://127.0.0.1:8888", noProxy: null };
const direct = { httpProxy: null, noProxy: null };
test(".env is needed only when an environment proxy would swallow loopback requests", () => {
assert.equal(needsNoProxy(proxied), true);
assert.equal(needsNoProxy(direct), false);
assert.equal(needsNoProxy({ httpProxy: "http://p:1", noProxy: "localhost,127.0.0.1,::1" }), false);
assert.equal(needsNoProxy({ httpProxy: "http://p:1", noProxy: "*" }), false);
});
test("install writes the proxy settings and, with an environment proxy, .env; the plugin brings the MCP server", () => {
const plan = planInstall({ ...base, configText: CONFIG, envText: null, env: proxied });
assert.equal(plan.configChanged, true);
assert.match(plan.configText, /^# >>> codex-attachment-manager: managed proxy setting/);
assert.match(plan.configText, /openai_base_url = "http:\/\/localhost:17891\/backend-api\/codex"/);
assert.match(plan.configText, /respect_system_proxy = true/);
assert.doesNotMatch(plan.configText, /\[mcp_servers\./);
assert.equal(plan.envChanged, true);
assert.match(plan.envText!, /NO_PROXY=localhost,127\.0\.0\.1,::1/);
const again = planInstall({ ...base, configText: plan.configText, envText: plan.envText, env: proxied });
assert.deepEqual([again.configChanged, again.envChanged], [false, false], "installing twice changes nothing");
});
test("an MCP server block from an install before the plugin is removed", () => {
const legacy = enableMcpServer(CONFIG, SERVER_NAME, "C:\\node.exe", ["D:\\cam\\plugin-server.ts"]).text;
const plan = planInstall({ ...base, configText: legacy, envText: null, env: direct });
assert.doesNotMatch(plan.configText, new RegExp(`\\[mcp_servers\\.${SERVER_NAME}\\]`));
assert.ok(plan.notes.some((note) => note.includes("旧版")));
assert.equal(planUninstall({ configText: plan.configText, envText: null }).configText, CONFIG);
});
test("without an environment proxy no .env is written, and an old block is cleared", () => {
const plan = planInstall({ ...base, configText: CONFIG, envText: null, env: direct });
assert.deepEqual([plan.envText, plan.envChanged], [null, false]);
const withOld = planInstall({ ...base, configText: CONFIG, envText: planInstall({ ...base, configText: CONFIG, envText: "KEEP=1\n", env: proxied }).envText, env: direct });
assert.deepEqual([withOld.envText, withOld.envChanged], ["KEEP=1\n", true]);
});
test("uninstall restores config.toml and .env byte for byte, deleting a .env that only held our block", () => {
for (const envText of [null, "OPENAI_API_KEY=not-a-real-key\n"]) {
const installed = planInstall({ ...base, configText: CONFIG, envText, env: proxied });
const removed = planUninstall({ configText: installed.configText, envText: installed.envText });
assert.equal(removed.configText, CONFIG);
assert.equal(removed.envText, envText);
}
});
test("a conflict stops the whole install before anything is written", () => {
const mine = 'openai_base_url = "https://example.test/v1"\n' + CONFIG;
assert.throws(() => planInstall({ ...base, configText: mine, envText: null, env: proxied }), /already sets openai_base_url/);
assert.throws(() => planInstall({ ...base, configText: CONFIG, envText: "NO_PROXY=corp\n", env: proxied }), /already sets NO_PROXY/);
});
test("the plugin's marketplace and install state are read from what Codex wrote", () => {
assert.deepEqual(pluginStatus(CONFIG), { marketplace: null, installed: false, enabled: false });
const written = CONFIG + '\n[marketplaces.codex-attachment-manager]\nsource_type = "local"\nsource = \'\\\\?\\D:\\repos\\cam\'\n\n[plugins."codex-attachment-manager@codex-attachment-manager"]\nenabled = true\n';
assert.deepEqual(pluginStatus(written), { marketplace: "\\\\?\\D:\\repos\\cam", installed: true, enabled: true });
assert.equal(pluginStatus(written.replace("enabled = true", "enabled = false")).enabled, false);
});
test("installation registers custom endpoints before replacing them and uninstall restores them", () => {
const config = 'openai_base_url = "https://relay.example/custom/v1"\n' + CONFIG;
const targets: string[] = [];
let installed: ReturnType<typeof planInstall>;
assert.doesNotThrow(() => { installed = planInstall({ ...base, configText: config, envText: null, env: direct, routeBaseUrl: (target: string) => { targets.push(target); return "http://localhost:17891/__cam/routes/relay"; } }); });
assert.deepEqual(targets, ["https://relay.example/custom/v1"]);
assert.match(installed!.configText, /^openai_base_url = "http:\/\/localhost:17891\/__cam\/routes\/relay"$/m);
assert.equal(planUninstall({ configText: installed!.configText, envText: null }).configText, config);
});