@bitkyc08/opencodex
Version:
Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code
45 lines (41 loc) • 2.02 kB
text/typescript
/**
* 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. It is not a user-facing capability and must not become one: it exists so the
* detached restart helper is the same audited binary running the same audited ladder,
* rather than a second implementation in a shell script.
*
* 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.
*
* It 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.
*/
const USAGE = "Usage: ocx internal desktop-restart-handoff --plan <path>";
function optionValue(args: readonly string[], name: string): string | undefined {
const index = args.indexOf(name);
return index >= 0 ? args[index + 1] : undefined;
}
export async function handleInternalCommand(args: readonly string[]): Promise<number> {
const sub = args[0];
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;
}