UNPKG

@bitkyc08/opencodex

Version:

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

60 lines (56 loc) • 3.07 kB
import { constants, zstdCompressSync, zstdDecompressSync } from "node:zlib"; const MIN_BYTES = 128 * 1024; const MAX_SYNC_BYTES = 16 * 1024 * 1024; /** * The envelope marker. A dedicated key, never `version`: the payload owns `version` * (`RESPONSE_SPILL_VERSION` in spill-store.ts), so a future payload version can never be * mistaken for a compressed record. */ const CODEC_KEY = "ocxSpillCodec"; const CODEC_ZSTD = "zstd/1"; const ENVELOPE_KEYS = [CODEC_KEY, "decodedBytes", "data"]; export function responseSpillCodecInfo() { return { codec: CODEC_ZSTD, minEncodeBytes: MIN_BYTES, maxSyncEncodeBytes: MAX_SYNC_BYTES }; } type Decoded = { ok: true; payload: unknown } | { ok: false; reason: "corrupt" | "too_large" }; /** Self-contained records preserve response-id replay without parent-file dependencies. */ export function encodeResponseSpill(bytes: Buffer, decodedLimit: number): Buffer { if (bytes.byteLength < MIN_BYTES || bytes.byteLength > Math.min(MAX_SYNC_BYTES, decodedLimit)) return bytes; try { const compressed = zstdCompressSync(bytes, { params: { [constants.ZSTD_c_compressionLevel]: 1, [constants.ZSTD_c_windowLog]: 20, } }); // Include the base64 and JSON overhead in the savings decision. const envelope = Buffer.from(JSON.stringify({ [CODEC_KEY]: CODEC_ZSTD, decodedBytes: bytes.byteLength, data: compressed.toString("base64") }), "utf8"); return envelope.byteLength <= bytes.byteLength * 0.875 ? envelope : bytes; } catch { // A codec failure must not make an otherwise valid continuation unretainable. return bytes; } } /** The caller has already verified the physical file size and content digest. */ export function decodeResponseSpill(bytes: Buffer, decodedLimit: number): Decoded { try { const value: unknown = JSON.parse(bytes.toString("utf8")); if (!value || typeof value !== "object" || Array.isArray(value) || !Object.hasOwn(value, CODEC_KEY)) return { ok: true, payload: value }; const envelope = value as Record<string, unknown>; if (Object.keys(envelope).some(key => !ENVELOPE_KEYS.includes(key)) || envelope[CODEC_KEY] !== CODEC_ZSTD || typeof envelope.decodedBytes !== "number" || !Number.isSafeInteger(envelope.decodedBytes) || envelope.decodedBytes <= 0 || typeof envelope.data !== "string") return { ok: false, reason: "corrupt" }; if (envelope.decodedBytes > decodedLimit) return { ok: false, reason: "too_large" }; const data = envelope.data; if (!data.length || data.length % 4 !== 0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(data)) { return { ok: false, reason: "corrupt" }; } const decoded = zstdDecompressSync(Buffer.from(data, "base64"), { maxOutputLength: envelope.decodedBytes }); if (decoded.byteLength !== envelope.decodedBytes) return { ok: false, reason: "corrupt" }; // Only one envelope is accepted. Nested compressed records never recurse. return { ok: true, payload: JSON.parse(decoded.toString("utf8")) as unknown }; } catch { return { ok: false, reason: "corrupt" }; } }