UNPKG

@bitkyc08/opencodex

Version:

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

167 lines (154 loc) • 7.51 kB
import { win32 } from "node:path"; import { SHIM_MARKER } from "./shim-templates"; import type { CodexCliInstallationIdentityInput } from "./cli-installation-identity"; /** * The proof-captured launcher snapshot used to identify the selected candidate. * Every field is optional because older launchers and direct Bun/source runs * supply no snapshot at all; derivation fails closed rather than reading the * ambient environment. */ export interface CodexCliInstallationSnapshot { readonly codexCliPath?: string | null; readonly path?: string | null; readonly pathExt?: string | null; } export type CodexCliInstallationTargetRefusal = | "unsupported_platform" | "candidate_unavailable" | "unsupported_layout" | "toolchain_unresolved"; export type CodexCliInstallationTargetDerivation = | { readonly kind: "derived"; readonly input: CodexCliInstallationIdentityInput } | { readonly kind: "unavailable"; readonly reason: CodexCliInstallationTargetRefusal }; export interface CodexCliInstallationTargetDeps { readonly platform?: NodeJS.Platform; /** `refused` means the probe could not decide; a PATH scan must stop rather than * attest a later candidate that the real launcher would never reach. */ readonly exists?: (path: string) => boolean | "refused" | "volume-unavailable" | Promise<boolean | "refused" | "volume-unavailable">; /** Bounded prefix read used only to recognize an OpenCodex-owned wrapper. */ readonly fileContains?: (path: string, marker: string) => boolean | "unavailable" | Promise<boolean | "unavailable">; } const DEFAULT_PATH_EXT = ".COM;.EXE;.BAT;.CMD;.PS1"; const SHIM_PROBE_BYTES = 8 * 1024; const CODEX_PACKAGE_SUFFIX = "\\node_modules\\@openai\\codex\\bin\\codex.js"; /** * First match wins, mirroring PATH resolution: directories in order, and within * each directory every PATHEXT suffix in order (or the exact name when it * already carries an extension). Skipping a hit to keep scanning would attest * something other than the launcher that actually resolves. */ async function scanPath( name: string, pathValue: string | null | undefined, pathExt: string | null | undefined, exists: (path: string) => boolean | "refused" | "volume-unavailable" | Promise<boolean | "refused" | "volume-unavailable">, ): Promise<string | null> { const extensions = (pathExt ?? DEFAULT_PATH_EXT).split(";").map(value => value.trim()).filter(Boolean); const names = /\.[a-z0-9]+$/i.test(name) ? [name] : extensions.map(ext => name + ext.toLowerCase()); for (const entry of (pathValue ?? "").split(";")) { const dir = entry.trim().replace(/^"+|"+$/g, ""); if (!dir) continue; for (const candidateName of names) { const candidate = win32.join(dir, candidateName); const found = await exists(candidate); if (found === "volume-unavailable") break; if (found === "refused") return null; if (found) return candidate; } } return null; } /** * Derive the four attestation inputs from the proof-captured launcher snapshot. * Discovery only proposes candidate paths; the held-handle observation remains * the authority, so a stale or racing probe can only produce a refusal, never a * false identity. No ambient environment is read: without a snapshot the result * is unavailable rather than silently trusting the child's environment. */ export async function deriveCodexCliInstallationInput( snapshot: CodexCliInstallationSnapshot, deps: CodexCliInstallationTargetDeps = {}, ): Promise<CodexCliInstallationTargetDerivation> { if ((deps.platform ?? process.platform) !== "win32") { return { kind: "unavailable", reason: "unsupported_platform" }; } const safeRead = async (path: string, maxBytes: number, prefixOnly = false) => { const { inspectWindowsInstallationFiles } = await import("./windows-installation-files"); return inspectWindowsInstallationFiles([{ path, maxBytes, metadataOnly: maxBytes === 0, prefixOnly }]); }; const exists = deps.exists ?? (async (path: string) => { const result = await safeRead(path, 0); if (result.kind === "observed") return true; return result.reason === "not-found" ? false : result.reason === "volume-unavailable" ? "volume-unavailable" : "refused"; }); const fileContains = deps.fileContains ?? (async (path: string, marker: string) => { const result = await safeRead(path, SHIM_PROBE_BYTES, true); if (result.kind !== "observed") return "unavailable"; return Buffer.from(result.files[0]!.bytes).toString("utf8").includes(marker); }); const configured = snapshot.codexCliPath; let candidate: string | null; if (configured) { if (/^[a-z]:[\\/]/i.test(configured)) { if (await exists(configured) !== true) return { kind: "unavailable", reason: "candidate_unavailable" }; candidate = win32.normalize(configured); } else { if (configured.includes("/") || configured.includes("\\")) { return { kind: "unavailable", reason: "candidate_unavailable" }; } candidate = await scanPath(configured, snapshot.path, snapshot.pathExt, exists); if (!candidate) return { kind: "unavailable", reason: "candidate_unavailable" }; } } else { candidate = await scanPath("codex", snapshot.path, snapshot.pathExt, exists); if (!candidate) return { kind: "unavailable", reason: "candidate_unavailable" }; } // An OpenCodex wrapper at the npm prefix is our own launcher, not the npm // artifact. The renamed original beside it is the file npm wrote. if (/\.cmd$/i.test(candidate)) { const marker = await fileContains(candidate, SHIM_MARKER); if (marker === "unavailable") return { kind: "unavailable", reason: "candidate_unavailable" }; if (marker) { const backing = candidate.slice(0, -".cmd".length) + ".opencodex-real.cmd"; if (await exists(backing) !== true) return { kind: "unavailable", reason: "unsupported_layout" }; candidate = backing; } } const base = win32.basename(candidate).toLowerCase(); let prefix: string; if (base === "codex.cmd" || base === "codex.opencodex-real.cmd") { prefix = win32.dirname(candidate); } else if (candidate.toLowerCase().endsWith(CODEX_PACKAGE_SUFFIX)) { prefix = candidate.slice(0, candidate.length - CODEX_PACKAGE_SUFFIX.length); } else { return { kind: "unavailable", reason: "unsupported_layout" }; } if (await exists(win32.join(prefix, "node_modules", "@openai", "codex", "package.json")) !== true) { return { kind: "unavailable", reason: "unsupported_layout" }; } // The npm cmd-shim itself prefers %dp0%\node.exe before falling back to PATH. let node = win32.join(prefix, "node.exe"); const localNode = await exists(node); if (localNode === false) { const resolved = await scanPath("node.exe", snapshot.path, null, exists); if (!resolved) return { kind: "unavailable", reason: "toolchain_unresolved" }; node = resolved; } else if (localNode !== true) { // A refused local probe is not proof of absence and must not fall through to PATH. return { kind: "unavailable", reason: "toolchain_unresolved" }; } const npmCli = win32.join(win32.dirname(node), "node_modules", "npm", "bin", "npm-cli.js"); if (await exists(npmCli) !== true) return { kind: "unavailable", reason: "toolchain_unresolved" }; return { kind: "derived", input: Object.freeze({ candidate, npmPrefix: prefix, npmCli, node, candidateSource: "selected", }), }; }