@bitkyc08/opencodex
Version:
Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code
67 lines (58 loc) • 6.56 kB
text/typescript
/**
* What to run on a Child that a failed enrollment may have left connected. Every step is bound to the attempt's link id
* (--expect-link), so it acts only while the Child's records name that link or nothing at all, and leaves a Child that
* another link, a hub or another Home owns: a plain disconnect or detach read long after the attempt could remove a link
* the machine joined since. A build older than the flag refuses it before it acts; then a full install falls back to a
* check of that link id, and a lightweight Child is left (its status cannot show an interrupted attach of another link,
* which a plain detach would restore and then remove). Without a valid id nothing can be bound, so the Child is left.
* One source for the live apply answer, the journal's replay and the CLI.
*/
export type ResidualChild = "plant" | "ephemeral" | "full" | "enrollment";
const LINK_ID = /^lnk_[0-9a-f]{16}$/;
export const RESIDUAL_NO_LINK = "This answer does not name the attempt's link id, so no step on the Child can be bound to it: leave the Child as it is.";
const OLDER_LIGHTWEIGHT = "An ocx-child older than that flag refuses it before it acts; then leave the Child as it is: its status cannot show an interrupted attach of another link, which a plain detach would restore and then remove.";
const olderFull = (id: string): string => "An OpenCodex older than that flag refuses it before it acts on the link; then run ocx disconnect and ocx restart only if ocx connect status --json shows " + id
+ ", right after that check (an enrollment that lands between the two commands would be removed), and otherwise leave the Child as it is.";
/**
* A purge path that is not found means no planted binary is there: an uncertain journalled plant can stop before it installs
* one, and a purge removes one only after every recovery record is gone. Either way no ocx-child of this attempt holds the
* Child, which the bare "not found" of the shell does not say.
*/
const PLANT_NOT_FOUND = " If the command is not found there, the binary is not installed (the plant stopped before installing it, or it was purged since), so no ocx-child of this attempt holds the Child: nothing is left to undo on it, and you can retry.";
const bound = (id: string): string => "it acts only when the Child's records name this attempt's link (" + id + ") or nothing at all, and leaves a Child that another link, a hub or another Home owns.";
/**
* The lightweight agent's detach by the paths it can have: the managed copy (not necessarily on PATH) for the Child's platform,
* both Windows locations in Command Prompt, and a copy placed by hand: first in ~/.local/bin (%USERPROFILE%\.local\bin on
* Windows), the place the Home's discovery tries before any other and which need not be on PATH, then through the path
* command -v (where.exe) prints.
*/
function lightweightDetach(id: string, platform: "posix" | "windows" | undefined): { first: string; rest: string; prompt: boolean } {
const posix = "~/.cache/opencodex/bin/ocx-child detach --expect-link " + id;
const windows = "\"%LOCALAPPDATA%\\opencodex\\bin\\ocx-child.exe\" detach --expect-link " + id;
const windowsFallback = "\"%USERPROFILE%\\.cache\\opencodex\\bin\\ocx-child.exe\" detach --expect-link " + id;
const placed = (where: string, lookup: string) => "for a copy placed by hand, the same detach --expect-link " + id + " through " + where
+ ", which need not be on PATH, or through the path " + lookup + " prints";
const posixPlaced = "~/.local/bin/ocx-child";
const windowsPlaced = "%USERPROFILE%\\.local\\bin\\ocx-child.exe";
if (platform === "windows") return { first: windows, rest: " (or " + windowsFallback + " where LOCALAPPDATA is not set; " + placed(windowsPlaced, "where.exe ocx-child") + ")", prompt: true };
if (platform === "posix") return { first: posix, rest: " (" + placed(posixPlaced, "command -v ocx-child") + ")", prompt: false };
return { first: posix, rest: " (on Windows, in Command Prompt, " + windows + ", or " + windowsFallback + " where LOCALAPPDATA is not set; " + placed(posixPlaced + " (" + windowsPlaced + " on Windows)", "command -v ocx-child, or where.exe ocx-child on Windows,") + ")", prompt: false };
}
export function residualRecovery(kind: ResidualChild, linkId: string | undefined, platform?: "posix" | "windows"): string {
if (linkId === undefined || !LINK_ID.test(linkId)) return RESIDUAL_NO_LINK;
const id = linkId;
if (kind === "plant") {
// The Home planted this build itself, so it knows the flag. Both places the plant uses on Windows.
const posix = "~/.cache/opencodex/bin/ocx-child detach --purge --expect-link " + id;
const windows = "\"%LOCALAPPDATA%\\opencodex\\bin\\ocx-child.exe\" detach --purge --expect-link " + id;
const windowsFallback = "\"%USERPROFILE%\\.cache\\opencodex\\bin\\ocx-child.exe\" detach --purge --expect-link " + id;
if (platform === "windows") return "In Command Prompt on the Child, run " + windows + " (or " + windowsFallback + " where LOCALAPPDATA is not set) before retrying: " + bound(id) + PLANT_NOT_FOUND;
if (platform === "posix") return "Run " + posix + " on the Child before retrying: " + bound(id) + PLANT_NOT_FOUND;
return "Run " + posix + " on the Child before retrying (on Windows, in Command Prompt, " + windows + ", or " + windowsFallback + " where LOCALAPPDATA is not set): " + bound(id) + PLANT_NOT_FOUND;
}
const light = lightweightDetach(id, platform);
if (kind === "ephemeral") return (light.prompt ? "In Command Prompt on the Child, run " + light.first + " before retrying" : "Run " + light.first + " on the Child before retrying") + light.rest + ": " + bound(id) + " " + OLDER_LIGHTWEIGHT;
if (kind === "full") return "Run ocx disconnect --expect-link " + id + " on the Child and, if it disconnected, ocx restart, before retrying: it disconnects only while the Child is connected to this attempt's link (" + id + "). " + olderFull(id);
return "Run ocx disconnect --expect-link " + id + " and, if it disconnected, ocx restart on a full install, or " + (light.prompt ? "in Command Prompt " : "") + light.first + " on a lightweight Child" + light.rest + ", before retrying: either acts only while the Child belongs to this attempt's link (" + id + "). "
+ "A build older than that flag refuses it before it acts; then leave a lightweight Child as it is, and on a full install run ocx disconnect and ocx restart only if ocx connect status --json shows " + id + ", right after that check, and otherwise leave it as it is.";
}