UNPKG

@bitkyc08/opencodex

Version:

Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code

258 lines (240 loc) • 9.89 kB
import { execFile } from "node:child_process"; import { basename } from "node:path"; import { resolveTrustedWindowsPowerShellExe } from "../lib/windows-elevation"; import { listProcessSnapshots, tokenizeCommandLine, type ProcessSnapshot, } from "./app-server-processes"; const PROCESS_LIST_MAX_BUFFER = 16 * 1024 * 1024; const DIRECT_CODEX_BASENAMES = new Set(["codex", "codex.exe"]); const CODEX_INTERPRETER_BASENAMES = new Set(["node", "nodejs", "bun"]); const CODEX_ENTRYPOINT_BASENAMES = new Set([ "codex", "codex.js", "codex.mjs", "codex.cjs", "codex.ts", ]); export interface NativeProcessExecOptions { encoding: "utf8"; timeout: number; maxBuffer: number; windowsHide?: boolean; shell: false; killSignal: "SIGKILL"; } export type NativeProcessExecutor = ( file: string, args: string[], options: NativeProcessExecOptions, ) => Promise<string>; export interface NativeCodexProcessProbeOptions { platform?: NodeJS.Platform; execFile?: NativeProcessExecutor; pid?: number; } export type NativeCodexProcessProbe = | { status: "clear"; count: 0 } | { status: "busy"; count: number } | { status: "unknown"; count: 0 }; export interface CodexClientProcess { pid: number; commandLine: string; } /** * Synchronous Codex-CLI process list for routing-adoption (#4550). * * "enumerated" is a successful read, including the empty list, which means * no matching client is running. "unavailable" means we could not name PIDs: * a failed snapshot walk. The two must not collapse. An empty array is * "none running" and would otherwise produce a false adopted. Windows is * enumerable here: listProcessSnapshots already returns CLI command lines. * Do not route through listCodexAppServerProcesses; that maps a failed * walk to [] for the #476 kill contract. */ export type CodexClientProcessList = | { status: "enumerated"; processes: CodexClientProcess[] } | { status: "unavailable" }; export interface ListCodexClientProcessesOptions { platform?: NodeJS.Platform; pid?: number; getuid?: () => number | undefined; /** Test seam: raw snapshots. Enumeration failure is thrown, not []. */ listSnapshots?: () => ProcessSnapshot[]; } /** * True when a ps comm field plus args string is a Codex CLI client. * * Direct "codex" / "codex.exe" basenames, or a known interpreter whose * immediate entrypoint is a Codex CLI script. The busy-count probe and the * routing-adoption lister both call this so the rules cannot drift (#2457). */ export function isCodexClientProcess(command: string, args: string): boolean { const comm = basename(command).toLowerCase(); if (DIRECT_CODEX_BASENAMES.has(comm)) return true; // A full executable path is stronger evidence than ps's unquoted args. // Splitting ".../Codex Framework.framework/.../browser_crashpad_handler" // at its first space would otherwise manufacture an argv0 named Codex. if (command.includes("/") && !CODEX_INTERPRETER_BASENAMES.has(comm)) return false; const trimmedArgs = args.trim(); const hasExecutablePrefix = command && trimmedArgs.startsWith(command) && /^(?:\s|$)/.test(trimmedArgs.slice(command.length)); const remainingArgs = hasExecutablePrefix ? trimmedArgs.slice(command.length).trim() : trimmedArgs; const rawTokens = remainingArgs.split(/\s+/, 2); // Even with only a comm basename, this initial token pair is the split // Codex.app framework path, not a CLI executable plus an argument. Only // inspect the executable or immediate script, never a later argument. if (rawTokens[0]?.endsWith("/Codex.app/Contents/Frameworks/Codex") && rawTokens[1]?.startsWith("Framework.framework/")) return false; const quotedTokens = tokenizeCommandLine(remainingArgs); // ps/procfs also leave literal apostrophes unescaped. Preserve a matching // immediate raw entrypoint before interpreting shell-like quotes. return [rawTokens, quotedTokens].some(tokens => { const [rawArgv0 = "", rawEntrypoint = ""] = hasExecutablePrefix ? [command, ...tokens] : tokens; const argv0 = basename(rawArgv0).toLowerCase(); const entrypoint = basename(rawEntrypoint).toLowerCase(); return DIRECT_CODEX_BASENAMES.has(argv0) || (CODEX_INTERPRETER_BASENAMES.has(argv0) && CODEX_ENTRYPOINT_BASENAMES.has(entrypoint)); }); } function parseUnixPsLine(line: string): { pid: number; command: string; args: string } | null { const match = line.trim().match(/^(\d+)\s+(\S+)\s*(.*)$/); if (!match) return null; const pid = Number(match[1]); if (!Number.isSafeInteger(pid)) return null; return { pid, command: match[2]!, args: match[3]! }; } function unixCodexClientsFromPs(output: string, selfPid: number): CodexClientProcess[] { const processes: CodexClientProcess[] = []; for (const line of output.split("\n")) { const parsed = parseUnixPsLine(line); if (!parsed || parsed.pid === selfPid) continue; if (!isCodexClientProcess(parsed.command, parsed.args)) continue; processes.push({ pid: parsed.pid, commandLine: parsed.args.trim() || parsed.command, }); } return processes; } /** * Name running Codex CLI processes so status can tell a pre-injection client * from one that had a chance to read the injected route (#4550). * * probeNativeCodexProcesses is async and count-only; collectStartupHealth is * synchronous, so this path cannot reuse it. Snapshots come from * listProcessSnapshots so Windows CLI PIDs are named too; a thrown walk * stays unavailable rather than an empty adopted list. */ export function listCodexClientProcesses({ platform = process.platform, pid = process.pid, getuid, listSnapshots, }: ListCodexClientProcessesOptions = {}): CodexClientProcessList { try { const snapshots = listSnapshots ? listSnapshots() : listProcessSnapshots({ platform, getuid }); const seen = new Set<number>(); const processes: CodexClientProcess[] = []; for (const snapshot of snapshots) { if (snapshot.pid === pid || seen.has(snapshot.pid)) continue; if (!snapshotIsCodexClient(snapshot)) continue; seen.add(snapshot.pid); processes.push({ pid: snapshot.pid, commandLine: snapshot.commandLine }); } return { status: "enumerated", processes }; } catch { return { status: "unavailable" }; } } function snapshotIsCodexClient(snapshot: ProcessSnapshot): boolean { return isCodexClientProcess(snapshot.executable ?? "", snapshot.commandLine); } /** Async, shell-free child execution with runtime-enforced timeout and output bounds. */ export const executeNativeProcess: NativeProcessExecutor = (file, args, options) => new Promise((resolve, reject) => { execFile(file, args, { encoding: options.encoding, timeout: options.timeout, maxBuffer: options.maxBuffer, windowsHide: options.windowsHide, shell: false, killSignal: options.killSignal, }, (error, stdout) => { if (error) { reject(error); return; } resolve(stdout); }); }); async function windowsProcessCount(run: NativeProcessExecutor): Promise<number> { const powershell = resolveTrustedWindowsPowerShellExe(); const script = [ "$ErrorActionPreference='Stop';", "$self=$PID;", "$items=Get-CimInstance Win32_Process | Where-Object { $_.ProcessId -ne $self -and ($_.Name -match '^(?i:codex)(?:\\.exe)?$' -or $_.CommandLine -match '(?i)(?:^|[\\\\/\"\\s])codex(?:\\.exe|\\.cmd)?(?:[\"\\s]|$)') };", "@($items).Count", ].join(" "); const output = (await run(powershell, ["-NoLogo", "-NoProfile", "-NonInteractive", "-Command", script], { encoding: "utf8", timeout: 12_000, maxBuffer: PROCESS_LIST_MAX_BUFFER, windowsHide: true, shell: false, killSignal: "SIGKILL", })).trim(); if (!/^\d+$/.test(output)) throw new Error("invalid process count"); const count = Number(output); if (!Number.isSafeInteger(count)) throw new Error("invalid process count"); return count; } async function unixProcessCount(run: NativeProcessExecutor, pid: number, platform: NodeJS.Platform): Promise<number> { const options: NativeProcessExecOptions = { encoding: "utf8", timeout: 5_000, maxBuffer: PROCESS_LIST_MAX_BUFFER, shell: false, killSignal: "SIGKILL", }; if (platform !== "darwin") { const output = await run("ps", ["-eo", "pid=,comm=,args="], options); return unixCodexClientsFromPs(output, pid).length; } // macOS comm is a full path and may contain spaces. Read the two fields // separately, as the routing-adoption snapshot collector does, then join by PID. const commands = new Map<number, string>(); const commOutput = await run("ps", ["-eo", "pid=,comm="], options); for (const line of commOutput.split("\n")) { const match = /^\s*(\d+)\s+(.+)$/.exec(line); if (match) commands.set(Number(match[1]), match[2]!.trim()); } const argsOutput = await run("ps", ["-eo", "pid=,args="], options); let count = 0; for (const line of argsOutput.split("\n")) { const match = /^\s*(\d+)\s+(.+)$/.exec(line); if (!match) continue; const candidatePid = Number(match[1]); const command = commands.get(candidatePid); if (Number.isSafeInteger(candidatePid) && candidatePid !== pid && command && isCodexClientProcess(command, match[2]!)) count++; } return count; } /** Best-effort, read-only process probe. It never terminates a user process. */ export async function probeNativeCodexProcesses({ platform = process.platform, execFile: run = executeNativeProcess, pid = process.pid, }: NativeCodexProcessProbeOptions = {}): Promise<NativeCodexProcessProbe> { try { const count = await (platform === "win32" ? windowsProcessCount(run) : unixProcessCount(run, pid, platform)); return count > 0 ? { status: "busy", count } : { status: "clear", count: 0 }; } catch { return { status: "unknown", count: 0 }; } }