@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
text/typescript
/**
* 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;
}