@bitkyc08/opencodex
Version:
Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code
101 lines (91 loc) • 4.61 kB
text/typescript
/** Backend path and opt-in config compatibility for native Codex history/notes. */
import { readFileSync, statSync } from "node:fs";
import { join } from "node:path";
import { getCodexHome } from "./paths";
export const CONTEXT_BACKEND_PREFIX = "/backend-api/codex";
/** The single definition of the opt-in, shared by injection and the runtime gate. */
export function contextExperimentalEnabled(configContent: string): boolean {
let parsed: { features?: { context_management?: boolean | { experimental_mode?: boolean } } };
try {
parsed = Bun.TOML.parse(configContent) as typeof parsed;
} catch {
// Injection tolerates incomplete user config; malformed TOML is not an opt-in.
return false;
}
// Codex FeatureToml accepts either a boolean or the experimental_mode table.
// Keep strict true checks: malformed values must not activate a credentialed relay.
const setting = parsed.features?.context_management;
return setting === true || (typeof setting === "object" && setting?.experimental_mode === true);
}
let activation: { key: string; active: boolean } | undefined;
/**
* Whether this proxy may serve the context relay at all, decided by opencodex reading Codex own
* config rather than by anything a caller sends.
*
* Rewriting the injected base URL is what makes the feature REACHABLE, and gating only that would
* leave the ownership registry and both endpoint prefixes live for anyone who can already reach
* the data plane. An opt-in that a direct POST walks around is not an opt-in, so the same
* predicate guards recording and dispatch. An absent, unreadable or malformed config is not an
* opt-in. The result is cached against the config identity and re-read when the file changes, so
* turning the feature off takes effect without a restart and steady-state traffic does not parse
* TOML per request.
*/
export function contextRelayActivated(configPath?: string): boolean {
let key: string;
let path: string;
try {
// Resolved here, not in a default parameter: those are evaluated before the body, so a
// CODEX_HOME that became unreadable while the proxy runs would throw past this try. This
// function is now on the model path, where that would abort a turn upstream already served.
path = configPath ?? join(getCodexHome(), "config.toml");
const seen = statSync(path);
key = `${path}:${seen.mtimeMs}:${seen.size}:${String(seen.ino)}`;
} catch {
activation = undefined;
return false;
}
if (activation?.key === key) return activation.active;
let active = false;
try {
active = contextExperimentalEnabled(readFileSync(path, "utf8"));
} catch {
// A readable stat with an unreadable body caches false under that identity, so the feature
// stays off until the content itself changes. Fail-closed is the right direction here.
active = false;
}
activation = { key, active };
return active;
}
/** Test seam: the cache is keyed by config identity, which a temp home reuses across cases. */
export function resetContextRelayActivationForTests(): void {
activation = undefined;
}
const CONTEXT_ENDPOINTS = new Set([
"alpha/history/v2/list_windows", "alpha/history/v2/list_items",
"alpha/history/v2/read_item", "alpha/history/v2/search_contents",
"alpha/notes/v2/thread_hint", "alpha/notes/v2/list_files_by_prefix",
"alpha/notes/v2/read_file", "alpha/notes/v2/search_contents",
"alpha/notes/v2/append_to_file", "alpha/notes/v2/write_file",
]);
export function contextEndpoint(path: string): string | undefined {
const endpoint = path.startsWith("/v1/") ? path.slice(4) : "";
return CONTEXT_ENDPOINTS.has(endpoint) ? endpoint : undefined;
}
/** Alias only the data-plane prefix. Existing auth/origin and route gates still run. */
export function codexCompatibleUrl(rawUrl: string): URL {
const url = new URL(rawUrl);
if (url.pathname === CONTEXT_BACKEND_PREFIX || url.pathname.startsWith(CONTEXT_BACKEND_PREFIX + "/")) {
url.pathname = "/v1" + url.pathname.slice(CONTEXT_BACKEND_PREFIX.length);
}
return url;
}
/** Change only marker-managed built-in routing, and only with an explicit context opt-in. */
export function contextCompatibleBaseLine(content: string, line: string): string {
if (!contextExperimentalEnabled(content)) return line;
const match = /^openai_base_url = "([^"]+)"$/.exec(line);
if (!match) return line;
const url = new URL(match[1]);
if (url.pathname !== "/v1" || !["127.0.0.1", "localhost", "[::1]"].includes(url.hostname)) return line;
url.pathname = CONTEXT_BACKEND_PREFIX;
return `openai_base_url = "${url.href}"`;
}