UNPKG

@bitkyc08/opencodex

Version:

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

129 lines (115 loc) • 7.32 kB
/** * `ocx connect|disconnect antigravity|agy` and `ocx connect antigravity|agy status`. * * Points Google's Antigravity desktop app and `agy` CLI at this proxy. The running proxy owns the * work (`/api/gateway-clients`); when none is running the same connectors run in this process, so * a first-time setup does not need `ocx start` first. */ import { loadConfig } from "../config"; import { connectGatewayClient, disconnectGatewayClient, gatewayActionBody, gatewayClientsStatus, isGatewayClientId, productionGatewayClientContext, resolveGatewayTarget, type GatewayClientContext, type GatewayClientId, type GatewayClientStatus, type GatewayNote, } from "../integrations/gateway-clients"; import { CliUsageError, RuntimeApiError, printData, rejectArgs, runCliAction, runtimeRequest, takeJsonFlag, takeOption, terminalSafeText, type RuntimeApiDeps } from "./runtime-api"; type GatewayClientVerb = "connect" | "disconnect" | "status"; export interface GatewayClientCommandDeps extends RuntimeApiDeps { /** Local-fallback seams; production reads the real home and config. */ context?: () => GatewayClientContext; loadConfig?: typeof loadConfig; } const USAGE: Record<GatewayClientVerb, string> = { connect: "ocx connect antigravity [--model <id>] [--json]", disconnect: "ocx disconnect antigravity|agy [--json]", status: "ocx connect antigravity|agy status [--json]", }; /** True when the first operand after `connect` or `disconnect` names a gateway client. */ export const isGatewayClientOperand = (operand: string | undefined): operand is GatewayClientId => isGatewayClientId(operand); type Body = Record<string, unknown> & { ok: boolean; message?: string; notes?: GatewayNote[]; changedFiles?: string[]; restore?: string; status?: GatewayClientStatus }; function actionLines(body: Body, offlinePort: number | null): string[] { const out = [body.message ?? (body.ok ? "Done." : "Failed.")]; for (const file of body.changedFiles ?? []) out.push(` changed: ${file}`); if (body.restore) out.push(` restore: ${body.restore}`); for (const override of body.status?.overrides ?? []) out.push(` warning (${override.source}): ${override.detail}`); for (const note of body.notes ?? []) out.push(` ${note.text}`); if (offlinePort !== null && body.ok) out.push(` The proxy is not running. Start it so the client has something to talk to: ocx start (port ${offlinePort}).`); return out; } function statusLines(status: GatewayClientStatus, offline: boolean): string[] { const out = [`${status.label}: ${status.state}`]; for (const file of status.files) out.push(` ${file.exists ? "found " : "missing"} ${file.role}: ${file.path}`); for (const override of status.overrides) out.push(` warning (${override.source}): ${override.detail}`); for (const note of status.notes) out.push(` ${note.text}`); if (offline) out.push(" The proxy is not running."); return out; } const isOffline = (error: unknown): boolean => error instanceof RuntimeApiError && error.code === "proxy_not_running"; function refusalBody(error: unknown): Body | null { if (!(error instanceof RuntimeApiError) || error.status !== 409) return null; const body = error.body as Body | null; return body && typeof body === "object" && body.ok === false ? body : null; } /** Exit 5 is the CLI's "refused" code, the same one runCliAction gives any 409. */ function refuse(body: Body, wantsJson: boolean): void { if (wantsJson) console.log(JSON.stringify(body, null, 2)); else console.error(`Error: ${terminalSafeText(String(body.message ?? "refused"))}`); } async function runLocally(verb: GatewayClientVerb, id: GatewayClientId, model: string | undefined, wantsJson: boolean, deps: GatewayClientCommandDeps): Promise<number> { const config = (deps.loadConfig ?? loadConfig)(); const ctx = (deps.context ?? productionGatewayClientContext)(); const resolved = resolveGatewayTarget(config, config.port, model); const target = resolved.ok ? resolved.target : undefined; if (verb === "status") { const mine = gatewayClientsStatus(ctx, target).find(client => client.id === id)!; printData(mine, wantsJson, statusLines(mine, true)); return 0; } // Port 0 asks the OS for a port at start; writing it into client files would name no listener. if (verb === "connect" && target && new URL(target.url).port === "0") { refuse({ ok: false, code: "no-fixed-port", message: "The configured port is 0, so the proxy has no fixed address to write. Start the proxy (ocx start), then connect again." }, wantsJson); return 5; } const outcome = verb === "connect" ? connectGatewayClient(id, ctx, config, config.port, model) : disconnectGatewayClient(id, ctx, target); const body = gatewayActionBody(outcome) as Body; if (!outcome.ok) { refuse(body, wantsJson); return 5; } printData(body, wantsJson, actionLines(body, verb === "connect" ? config.port : null)); return 0; } export async function runGatewayClientCommand(verb: GatewayClientVerb, id: GatewayClientId, argv: string[], deps: GatewayClientCommandDeps = {}): Promise<number> { const args = [...argv]; const usage = verb === "connect" && id === "agy" ? "ocx connect agy [--json]" : USAGE[verb]; let exit = 0; const code = await runCliAction(async () => { const wantsJson = takeJsonFlag(args); if (verb === "connect" && id === "agy" && args.some(arg => arg === "--model" || arg.startsWith("--model="))) { throw new CliUsageError("--model is only supported by ocx connect antigravity", usage); } const model = verb === "connect" && id === "antigravity" ? takeOption(args, "--model") : undefined; rejectArgs(args, usage, { redactValues: true }); if (model !== undefined && model.trim() === "") throw new CliUsageError("--model requires a non-empty value", usage); try { if (verb === "status") { const { clients } = await runtimeRequest<{ clients: GatewayClientStatus[] }>("/api/gateway-clients", {}, deps); const mine = clients.find(client => client.id === id); if (!mine) throw new RuntimeApiError(`The proxy did not report ${id}.`, 404, null); printData(mine, wantsJson, statusLines(mine, false)); return; } const init: RequestInit = { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify(verb === "connect" && model ? { model } : {}) }; const body = await runtimeRequest<Body>(`/api/gateway-clients/${id}/${verb}`, init, deps); printData(body, wantsJson, actionLines(body, null)); } catch (error) { const refusal = refusalBody(error); if (refusal) { refuse(refusal, wantsJson); exit = 5; return; } if (!isOffline(error)) throw error; exit = await runLocally(verb, id, model, wantsJson, deps); } }); return code !== 0 ? code : exit; } /** Route `connect|disconnect <client> ...` here; `args` is argv after the command word. */ export function runGatewayClientFromArgs(command: "connect" | "disconnect", args: string[], deps: GatewayClientCommandDeps = {}): Promise<number> { const id = args[0] as GatewayClientId; const rest = args.slice(1); if (command === "connect" && rest[0] === "status") return runGatewayClientCommand("status", id, rest.slice(1), deps); return runGatewayClientCommand(command, id, rest, deps); }