UNPKG

@bitkyc08/opencodex

Version:

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

79 lines (74 loc) • 3.74 kB
/** * Hidden `ocx internal ...` commands. * * Deliberately NOT in `src/cli/registry.ts` and NOT in `src/cli/capabilities.ts`, so it * is absent from help, from the generated skill surface, and from the registry-parity * gate. These are implementation entrypoints for the detached restart helper and * experimental ChatGPT stdout filter; compiled builds re-enter the same CLI binary. * * It is routed before the dispatch table for the same reason `help` is - adding it as a * runner key would make it a command the registry-parity test expects to find * documented. * * The restart handoff is intentionally unauthenticated, and that is not an oversight. Any process running * as this user can invoke it with a hand-written plan file, and it gains nothing by * doing so: the helper only does what the public `--restart-codex` flag already does for * that same user, and a same-uid process could call `kill` directly. A token here would * protect nothing and would imply a boundary that does not exist. */ import type { CodexExecBoundaryAsyncDeps } from "../codex/exec-boundary"; const USAGE = "Usage: ocx internal desktop-restart-handoff --plan <path> | chatgpt-app-server-filter [--self-test] | codex-exec-target [--bundle-root <path>] -- <path>"; function optionValue(args: readonly string[], name: string): string | undefined { const index = args.indexOf(name); return index >= 0 ? args[index + 1] : undefined; } /** * Dispatch internal helpers with command-specific argument checks and exit codes. * The executable-target helper writes one trusted path to stdout only after validation. */ export async function handleInternalCommand(args: readonly string[], execBoundary: CodexExecBoundaryAsyncDeps = {}): Promise<number> { const sub = args[0]; if (sub === "codex-exec-target") { const bundled = args[1] === "--bundle-root"; const root = bundled ? args[2] : undefined; const separator = bundled ? 3 : 1; const command = args[separator + 1]; if (args.length !== separator + 2 || args[separator] !== "--" || !command || /[\r\n\0]/.test(command) || (bundled && (!root || !root.startsWith("/") || /[\r\n\0]/.test(root)))) { console.error(USAGE); return 2; } try { const { assertCodexExecTargetTrustedAsync } = await import("../codex/exec-boundary"); const target = await assertCodexExecTargetTrustedAsync(command, bundled ? { ...execBoundary, expectedBundleRoot: root } : execBoundary); if (!target || /[\r\n]/.test(target)) throw new Error("invalid executable path"); console.log(target); return 0; } catch (error) { console.error(`OpenCodex refused the app-server executable: ${error instanceof Error ? error.message : "verification failed"}`); return 1; } } if (sub === "chatgpt-app-server-filter") { if (args.length > 2 || (args[1] !== undefined && args[1] !== "--self-test")) { console.error(USAGE); return 2; } const { runChatgptAppServerFilter } = await import("../chatgpt/app-server-shim/filter"); return await runChatgptAppServerFilter({ selfTest: args[1] === "--self-test" }); } if (sub !== "desktop-restart-handoff") { console.error(`Unknown internal command: ${sub ?? "(none)"}. ${USAGE}`); return 2; } const plan = optionValue(args, "--plan"); if (!plan) { console.error(USAGE); return 2; } const { runDesktopRestartHandoff } = await import("../codex/desktop-app/handoff"); const outcome = await runDesktopRestartHandoff(plan); // The operator is not watching this process - its terminal died with the app. The // exit code exists for a supervisor, and the readable record is the handoff log. return outcome === "restarted" ? 0 : 1; }