UNPKG

@bitkyc08/opencodex

Version:

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

142 lines (130 loc) • 6.37 kB
/** * Claude Desktop picker mode: narrowly rewrite the Code bootstrap catalog. * A failed or inapplicable transform leaves the upstream bytes untouched. */ import { brotliDecompressSync, gunzipSync, inflateSync } from "node:zlib"; /** One opencodex model offered in Desktop's Code-tab picker. */ export interface PickerModelEntry { id: string; name: string; contextWindow?: number; } export const BOOTSTRAP_MAX_ENCODED_BYTES = 4 * 1024 * 1024; export const BOOTSTRAP_MAX_DECODED_BYTES = 16 * 1024 * 1024; const BOOTSTRAP_PATH = /^\/(?:edge-api|api)\/bootstrap(?:\/[A-Za-z0-9-]+\/app_start)?\/?$/; const REWRITE_REMOVED_HEADERS = new Set([ "content-encoding", "content-length", "etag", "digest", "content-md5", "transfer-encoding", ]); export function isPickerBootstrapRequest(method: string, pathname: string): boolean { return method === "GET" && BOOTSTRAP_PATH.test(pathname); } export function narrowBootstrapAcceptEncoding(): string { return "gzip, deflate, br"; } function record(value: unknown): Record<string, unknown> | null { return value !== null && typeof value === "object" && !Array.isArray(value) ? value as Record<string, unknown> : null; } /** Why a bootstrap was left unchanged, for the metadata-only picker log. Never carries values. */ export type PickerInjectionOutcome = | { kind: "rewritten"; added: number } | { kind: "unchanged"; reason: string }; /** * Surfaces whose picker the local Desktop Code tab can show. Desktop reads "ccd" and falls back to * "code" only when "ccd" carries no catalog; "ccr" (remote sessions) is left alone because a * remote session never reaches this machine's proxy, so an opencodex route could not run there. */ export const PICKER_SURFACE_IDS = ["ccd", "code"] as const; /** Surface names the log may print; anything else from the body is counted, never echoed. */ const KNOWN_SURFACE_IDS = new Set(["ccd", "code", "cc", "ccr", "cowork", "chat", "design"]); function injectIntoSurface(surface: Record<string, unknown>, models: readonly PickerModelEntry[]): number | string { if (!Array.isArray(surface.models)) return "no_models"; const entries = surface.models as unknown[]; const template = entries.map(record).find(entry => typeof entry?.id === "string" && entry.id.startsWith("claude-") && !entry.disabled && !entry.disabled_reason && entry.section !== "deprecated"); if (!template) return `no_template(models=${entries.length})`; const existing = new Set(entries.map(record).map(entry => entry?.id)); let added = 0; for (const model of models) { if (existing.has(model.id)) continue; const copy = structuredClone(template); copy.id = model.id; copy.name = model.name; copy.section = "main"; if (model.contextWindow === undefined) delete copy.context_window; else copy.context_window = model.contextWindow; for (const key of Object.keys(copy)) { if (["disabled", "disabled_reason", "badge", "tooltip", "description", "fast_mode"].includes(key) || /version/i.test(key)) delete copy[key]; } entries.push(copy); existing.add(model.id); added++; } return added; } export function injectPickerModels( bootstrap: unknown, models: readonly PickerModelEntry[], explain?: (outcome: PickerInjectionOutcome) => void, ): number { const unchanged = (reason: string): number => { explain?.({ kind: "unchanged", reason }); return 0; }; const surfaces = record(bootstrap)?.model_selector_config; if (!Array.isArray(surfaces)) return unchanged("no_model_selector_config"); const rows = surfaces.map(record); const targets = rows.filter((entry): entry is Record<string, unknown> => entry !== null && (PICKER_SURFACE_IDS as readonly unknown[]).includes(entry.id)); if (targets.length === 0) { // Only known surface names reach the log; any other body-derived value is counted. const known = rows.flatMap(entry => typeof entry?.id === "string" && KNOWN_SURFACE_IDS.has(entry.id) ? [entry.id] : []); const other = rows.length - known.length; return unchanged(`no_code_surface(${[...known, ...(other > 0 ? [`other:${other}`] : [])].join(",")})`); } let added = 0; const skipped: string[] = []; for (const surface of targets) { const result = injectIntoSurface(surface, models); if (typeof result === "number") added += result; else skipped.push(`${String(surface.id)}:${result}`); } if (added === 0) return unchanged(skipped.length > 0 ? skipped.join(";") : models.length === 0 ? "no_routes" : "all_present"); explain?.({ kind: "rewritten", added }); return added; } export function rewriteBootstrapBody( encoded: Buffer, contentEncoding: string | undefined, models: readonly PickerModelEntry[], explain?: (outcome: PickerInjectionOutcome) => void, ): Buffer | null { const unchanged = (reason: string): null => { explain?.({ kind: "unchanged", reason }); return null; }; if (encoded.length > BOOTSTRAP_MAX_ENCODED_BYTES) return unchanged("encoded_cap"); const encoding = contentEncoding?.trim().toLowerCase() || "identity"; let decoded: Buffer; try { switch (encoding) { case "identity": decoded = encoded; break; case "gzip": case "x-gzip": decoded = gunzipSync(encoded, { maxOutputLength: BOOTSTRAP_MAX_DECODED_BYTES }); break; case "deflate": decoded = inflateSync(encoded, { maxOutputLength: BOOTSTRAP_MAX_DECODED_BYTES }); break; case "br": decoded = brotliDecompressSync(encoded, { maxOutputLength: BOOTSTRAP_MAX_DECODED_BYTES }); break; default: return unchanged("unsupported_encoding"); } if (decoded.length > BOOTSTRAP_MAX_DECODED_BYTES) return unchanged("decoded_cap"); const parsed: unknown = JSON.parse(decoded.toString("utf8")); if (injectPickerModels(parsed, models, explain) === 0) return null; return Buffer.from(JSON.stringify(parsed), "utf8"); } catch { return unchanged("decode_or_parse_failed"); } } /** Rewritten payloads are identity encoded, so stale validators and sizes must go. */ export function rewrittenHeaders(raw: readonly string[], bodyLength: number): string[] { const result: string[] = []; for (let i = 0; i + 1 < raw.length; i += 2) { if (!REWRITE_REMOVED_HEADERS.has(raw[i]!.toLowerCase())) result.push(raw[i]!, raw[i + 1]!); } result.push("Content-Length", String(bodyLength)); return result; }