@bitkyc08/opencodex
Version:
Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code
264 lines (241 loc) • 11.1 kB
text/typescript
import { existsSync, readFileSync, readdirSync, realpathSync, statSync } from "node:fs";
import { homedir } from "node:os";
import { join, posix, resolve, win32 } from "node:path";
import { expandUserPath } from "../config/paths";
import { redactUserPath } from "../lib/redact";
export type CodexHomeDeps = {
env?: NodeJS.ProcessEnv;
platform?: NodeJS.Platform | string;
release?: string;
procVersion?: string | null;
homedir?: () => string;
usersRoot?: string;
/** Raw /etc/wsl.conf content override (tests); null means "no file". */
wslConf?: string | null;
existsSync?: (path: string) => boolean;
readdirSync?: (path: string) => string[];
statSync?: typeof statSync;
realpathSync?: (path: string) => string;
};
function windowsUserProfileToWslPath(value: string | undefined, automountRoot = DEFAULT_WSL_AUTOMOUNT_ROOT): string | null {
if (!value) return null;
const normalized = value.replaceAll("\\", "/");
const match = normalized.match(/^([A-Za-z]):\/Users\/([^/]+)$/);
if (!match) return null;
const root = normalizeAutomountRoot(automountRoot);
return `${root === "/" ? "" : root}/${match[1]!.toLowerCase()}/Users/${match[2]}`;
}
const DEFAULT_WSL_AUTOMOUNT_ROOT = "/mnt";
function normalizeAutomountRoot(value: string): string {
const trimmed = value.replace(/\/+$/, "");
return trimmed === "" ? "/" : trimmed;
}
function readWslConf(): string | null {
try {
return readFileSync("/etc/wsl.conf", "utf8");
} catch {
return null;
}
}
/**
* Windows drive mount root inside WSL: `[automount] root` from /etc/wsl.conf,
* default `/mnt` (https://learn.microsoft.com/en-us/windows/wsl/wsl-config).
* Returns a path without a trailing slash (or `/` itself).
*/
export function wslAutomountRoot(deps: CodexHomeDeps = {}): string {
const content = deps.wslConf !== undefined ? deps.wslConf : readWslConf();
if (!content) return DEFAULT_WSL_AUTOMOUNT_ROOT;
let section = "";
for (const rawLine of content.split("\n")) {
const line = rawLine.replace(/[#;].*$/, "").trim();
if (!line) continue;
const sect = line.match(/^\[(.+)\]$/);
if (sect) {
section = sect[1]!.trim().toLowerCase();
continue;
}
if (section !== "automount") continue;
const kv = line.match(/^root\s*=\s*(.+)$/i);
if (kv) {
const value = kv[1]!.trim().replace(/^["']|["']$/g, "");
if (!value.startsWith("/")) return DEFAULT_WSL_AUTOMOUNT_ROOT;
return normalizeAutomountRoot(value);
}
}
return DEFAULT_WSL_AUTOMOUNT_ROOT;
}
function readProcVersion(): string | null {
try {
return readFileSync("/proc/version", "utf8");
} catch {
return null;
}
}
export function isWslRuntime(deps: CodexHomeDeps = {}): boolean {
if ((deps.platform ?? process.platform) !== "linux") return false;
const env = deps.env ?? process.env;
if (env.WSL_DISTRO_NAME || env.WSL_INTEROP) return true;
const version = `${deps.release ?? ""}\n${deps.procVersion ?? readProcVersion() ?? ""}`;
return /microsoft|wsl/i.test(version);
}
/** All Windows-profile `.codex` homes (with config.toml) visible from WSL, resolved real paths. */
export function listWslWindowsCodexHomes(deps: CodexHomeDeps = {}): string[] {
if (!isWslRuntime(deps)) return [];
const exists = deps.existsSync ?? existsSync;
const stat = deps.statSync ?? statSync;
const readdir = deps.readdirSync ?? readdirSync;
const realpath = deps.realpathSync ?? realpathSync.native;
const automountRoot = wslAutomountRoot(deps);
// WSL mount paths are POSIX by definition; keep separators stable on any host.
const usersRoot = deps.usersRoot ?? posix.join(automountRoot, "c", "Users");
if (!exists(usersRoot)) return [];
const candidates = [];
try {
for (const user of readdir(usersRoot)) {
if (user === "Default" || user === "Default User" || user === "Public" || user === "All Users") continue;
const home = posix.join(usersRoot, user, ".codex");
const config = posix.join(home, "config.toml");
if (!exists(config)) continue;
try {
if (stat(home).isDirectory()) candidates.push(realpath(home));
} catch {
// Ignore unreadable Windows profiles.
}
}
} catch {
return [];
}
return candidates;
}
export function findWslWindowsCodexHome(deps: CodexHomeDeps = {}): string | null {
const env = deps.env ?? process.env;
const candidates = listWslWindowsCodexHomes(deps);
if (candidates.length === 0) return null;
const explicitProfile = windowsUserProfileToWslPath(env.USERPROFILE, wslAutomountRoot(deps));
if (explicitProfile) {
const explicitHome = posix.join(explicitProfile, ".codex");
const match = candidates.find(candidate => candidate === explicitHome || candidate.endsWith(`/${explicitProfile.split("/").pop()}/.codex`));
if (match) return match;
}
return candidates.length === 1 ? candidates[0]! : null;
}
function canonicalExistingCodexHome(path: string, deps: CodexHomeDeps): string {
const stat = deps.statSync ?? statSync;
try {
if (!stat(path).isDirectory()) return path;
// Use the portable resolver here rather than realpathSync.native. The
// Windows Bun standalone runtime can reject a valid junction through the
// native resolver, while the effective home still needs to be physical
// before callers open auth.json or native-profile state.
return (deps.realpathSync ?? realpathSync)(path);
} catch {
// Preserve the existing lexical-path behavior for missing or unreadable
// homes; callers that require the directory still fail at their boundary.
return path;
}
}
export function defaultCodexHome(deps: CodexHomeDeps = {}): string {
const home = (deps.homedir ?? homedir)();
const defaultHome = join(home, ".codex");
const canonicalDefaultHome = canonicalExistingCodexHome(defaultHome, deps);
// A local ~/.codex that Codex is already using is the user's Codex home even before
// config.toml exists (a fresh install: login writes auth.json, first use writes
// sessions/ and history.jsonl). A local directory with none of that state is not
// evidence of a local Codex: before #5441 such a home let WSL discovery pick the
// Windows home, and existing WSL users who run against that Windows home must not
// be moved to an empty local one on upgrade. Return the canonical path so a
// Windows junction cannot leak into later credential and profile writes.
if (localCodexHomeIsDirectory(defaultHome, deps) && localCodexHomeInUse(defaultHome, deps)) return canonicalDefaultHome;
return findWslWindowsCodexHome(deps) ?? canonicalDefaultHome;
}
function localCodexHomeInUse(home: string, deps: CodexHomeDeps): boolean {
// Files and directories Codex itself writes into a home it is using. Kept local: defaultCodexHome
// runs during other modules' initialisation (the storage workers reach it through an import
// cycle), and a module-level const declared below it is still in its temporal dead zone then.
return ["config.toml", "auth.json", "sessions", "history.jsonl"].some(entry => pathPresent(join(home, entry), deps));
}
/** stat-based presence: an unexpected stat error counts as present, never as a reason to switch homes. */
function pathPresent(path: string, deps: CodexHomeDeps): boolean {
const stat = deps.statSync ?? statSync;
try {
stat(path);
return true;
} catch (error) {
const code = (error as NodeJS.ErrnoException | null)?.code;
return !(code === "ENOENT" || code === "ENOTDIR");
}
}
function localCodexHomeIsDirectory(path: string, deps: CodexHomeDeps): boolean {
const stat = deps.statSync ?? statSync;
// stat, not existsSync: existsSync reports false for an access error too, and that
// must not read as "absent" and hand the user's state to a different home.
try {
return stat(path).isDirectory();
} catch (error) {
const code = (error as NodeJS.ErrnoException | null)?.code;
if (code === "ENOENT" || code === "ENOTDIR") return false;
// An unreadable local home is still the local home; never switch to a
// different Codex home because a stat failed for an unexpected reason.
return true;
}
}
export function resolveCodexHomeDir(deps: CodexHomeDeps = {}): string {
const raw = (deps.env ?? process.env).CODEX_HOME?.trim();
if (raw) return resolve(expandUserPath(raw));
return defaultCodexHome(deps);
}
export type OrcaCodexHomeDiagnostic = {
applicable: boolean;
mismatch: boolean;
effectiveCodexHome: string;
appCodexHome: string;
orcaCodexHome: string | null;
warning: string | null;
action: string | null;
};
type OrcaCodexHomeDeps = CodexHomeDeps & {
effectiveCodexHome?: string;
appCodexHome?: string;
};
function normalizedWindowsPath(path: string): string {
return path.trim().replaceAll("/", "\\").replace(/\\+$/, "").toLowerCase();
}
/**
* High-confidence Orca/ChatGPT dual-home diagnosis. Explicit CODEX_HOME remains
* authoritative; this only explains when an Orca-owned shell targets a home the
* Windows ChatGPT/Codex app does not read.
*/
export function collectOrcaCodexHomeDiagnostic(deps: OrcaCodexHomeDeps = {}): OrcaCodexHomeDiagnostic {
const platform = deps.platform ?? process.platform;
const env = deps.env ?? process.env;
const effectiveCodexHome = deps.effectiveCodexHome ?? resolveCodexHomeDir(deps);
const appCodexHome = deps.appCodexHome
?? (platform === "win32" ? win32.join((deps.homedir ?? homedir)(), ".codex") : join((deps.homedir ?? homedir)(), ".codex"));
const explicitHome = env.CODEX_HOME?.trim() ?? "";
const orcaCodexHome = env.ORCA_CODEX_HOME?.trim() || null;
const normalizedEffective = normalizedWindowsPath(effectiveCodexHome);
const normalizedOrca = orcaCodexHome ? normalizedWindowsPath(orcaCodexHome) : "";
const normalizedApp = normalizedWindowsPath(appCodexHome);
const applicable = platform === "win32"
&& !!explicitHome
&& !!orcaCodexHome
&& normalizedEffective === normalizedOrca
&& /(?:^|\\)orca\\codex-runtime-home\\home$/i.test(normalizedOrca);
const mismatch = applicable && normalizedEffective !== normalizedApp;
const displayEffective = redactUserPath(effectiveCodexHome);
const displayApp = redactUserPath(appCodexHome);
const displayOrca = orcaCodexHome ? redactUserPath(orcaCodexHome) : null;
return {
applicable,
mismatch,
effectiveCodexHome: displayEffective,
appCodexHome: displayApp,
orcaCodexHome: displayOrca,
warning: mismatch
? `CODEX_HOME targets Orca's runtime home (${displayEffective}), while the Windows ChatGPT/Codex app uses ${displayApp}; OpenCodex injection will not reach that app.`
: null,
action: mismatch
? "If a service was installed from Orca, run 'ocx service uninstall' in that original Orca shell first. Then in Command Prompt run set \"ORCA_CODEX_HOME=\" and set \"CODEX_HOME=%USERPROFILE%\\.codex\"; or in PowerShell run Remove-Item Env:ORCA_CODEX_HOME -ErrorAction SilentlyContinue; $env:CODEX_HOME = Join-Path $env:USERPROFILE '.codex'. Rerun the command, then reinstall with 'ocx service install'."
: null,
};
}