UNPKG

@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
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, }; }