UNPKG

@bitkyc08/opencodex

Version:

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

107 lines (101 loc) • 6.89 kB
/** Read-only Cursor integration observations; never downloads or configures Cursor. */ import type { CursorIntegrationStatus } from "../server/management/cursor-integration-routes"; import type { CursorLocalInstallerHint } from "../integrations/cursor-local-installer"; import { runCatalogAction } from "./catalog-command-result"; import { CliUsageError, printData, runtimeRequest, takeFlag, type RuntimeApiDeps } from "./runtime-api"; const USAGE = "Usage: ocx integration native cursor [status|local-installer] [--json]"; const GUIDE_URL = "https://lidge-jun.github.io/opencodex/guides/cursor-private-inference/"; const PLACEHOLDER = "opencodex-loopback"; function record(value: unknown): Record<string, unknown> { if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error("Invalid Cursor response"); return value as Record<string, unknown>; } function text(value: unknown): string { if (typeof value !== "string" || !value.length) throw new Error("Invalid Cursor text"); return value; } function nullableText(value: unknown): string | null { return value === null ? null : text(value); } function boolean(value: unknown): boolean { if (typeof value !== "boolean") throw new Error("Invalid Cursor flag"); return value; } function integer(value: unknown): number { if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0) throw new Error("Invalid Cursor number"); return value; } function strings(value: unknown): string[] { if (!Array.isArray(value)) throw new Error("Invalid Cursor list"); return value.map(text); } function statusDto(raw: unknown): CursorIntegrationStatus { const value = record(raw), privateInference = record(value.privateInference), regular = record(value.regularCursor); const gateway = record(value.gateway), table = record(value.effortTable); if (!Array.isArray(value.models) || (gateway.apiKeyMode !== "credential" && gateway.apiKeyMode !== "placeholder") || gateway.placeholder !== PLACEHOLDER || (table.source !== "bundle" && table.source !== "static") || value.guideUrl !== GUIDE_URL) throw new Error("Invalid Cursor status"); const baseUrl = text(gateway.baseUrl), parsedUrl = new URL(baseUrl); if (!["http:", "https:"].includes(parsedUrl.protocol) || parsedUrl.username || parsedUrl.password || parsedUrl.search || parsedUrl.hash || parsedUrl.pathname !== "/v1") throw new Error("Invalid Cursor gateway"); const last = value.lastSeen === null ? null : record(value.lastSeen); return { privateInference: { installed: boolean(privateInference.installed), path: nullableText(privateInference.path), version: nullableText(privateInference.version) }, regularCursor: { installed: boolean(regular.installed), path: nullableText(regular.path) }, gateway: { baseUrl, apiKeyMode: gateway.apiKeyMode, placeholder: PLACEHOLDER }, lastSeen: last === null ? null : { at: integer(last.at), userAgent: text(last.userAgent) }, effortTable: { source: table.source, version: nullableText(table.version), families: table.families === null ? null : integer(table.families) }, models: value.models.map(rawModel => { const model = record(rawModel), context = model.context === null ? null : record(model.context); return { id: text(model.id), reasoning: model.reasoning === null ? null : strings(model.reasoning), family: nullableText(model.family), tableLess: boolean(model.tableLess), effortRows: strings(model.effortRows), context: context === null ? null : { defaultWindow: integer(context.defaultWindow), longWindow: integer(context.longWindow) } }; }), guideUrl: GUIDE_URL, }; } function installerDto(raw: unknown): CursorLocalInstallerHint { const value = record(raw), available = boolean(value.available); if (value.reason !== null && (typeof value.reason !== "string" || !["no-regular-install", "unsupported-platform", "unreachable", "unusable-response"].includes(value.reason))) { throw new Error("Invalid Cursor installer reason"); } const url = nullableText(value.url), version = nullableText(value.version); if (available) { if (url === null || version === null || value.reason !== null || url.length > 4096 || version.length > 256) throw new Error("Invalid Cursor installer"); const parsed = new URL(url); if (parsed.protocol !== "https:" || parsed.hostname !== "downloads.cursor.com" || parsed.port || parsed.username || parsed.password || !parsed.pathname.startsWith("/local-mode/")) throw new Error("Invalid Cursor installer URL"); } else if (url !== null || version !== null) throw new Error("Invalid unavailable installer"); return { available, url, version, reason: value.reason as CursorLocalInstallerHint["reason"] }; } /** Arguments start immediately after `integration native cursor`. */ export async function handleCursorIntegrationCommand(argv: string[], deps: RuntimeApiDeps = {}): Promise<number> { return runCatalogAction(async () => { const args = [...argv], wantsJson = takeFlag(args, "--json"), action = args.shift() ?? "status"; if (args.length || (action !== "status" && action !== "local-installer")) { throw new CliUsageError("Cursor supports only status and local-installer reads.", USAGE); } const raw = await runtimeRequest(`/api/native-integrations/cursor${action === "local-installer" ? "/local-installer" : ""}`, { method: "GET", redirect: "error" }, deps); if (action === "local-installer") { const result = installerDto(raw); printData(result, wantsJson, result.available ? [`Cursor installer available: ${result.version}`, `URL: ${result.url}`, "Nothing was downloaded or installed."] : [`No installer advertised. Reason: ${result.reason ?? "none (Private Inference is already installed)"}.`, "Nothing was downloaded or installed."]); } else { const result = statusDto(raw); printData(result, wantsJson, [ `Cursor Private Inference: ${result.privateInference.installed ? "installed" : "not found"}`, `Regular Cursor: ${result.regularCursor.installed ? "installed" : "not found"}`, `Gateway: ${result.gateway.baseUrl}`, result.gateway.apiKeyMode === "credential" ? "API key: an existing proxy credential is required. The placeholder is not an access credential." : `API key placeholder: ${PLACEHOLDER} (not a secret).`, `Last seen: ${result.lastSeen ? `${result.lastSeen.userAgent} at ${result.lastSeen.at}` : "no Cursor request observed since proxy startup"}`, `Models: ${result.models.length}`, ...result.models.map(model => `${model.id}: reasoning ${model.reasoning?.join(", ") ?? "not advertised"}`), `Guide: ${result.guideUrl}`, ...(!result.privateInference.installed ? ["Next: ocx integration native cursor local-installer"] : []), ]); } return 0; }); }