@bitkyc08/opencodex
Version:
Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI/App/SDK and Claude Code
109 lines (99 loc) • 5.24 kB
text/typescript
import type { RawEntry } from "./parsing";
import { trustedAccountBoundNativeCatalogSlug } from "./account-models";
import { NATIVE_GPT6_ASTRA_MODEL, NATIVE_GPT61_SOL_MODEL, NATIVE_GPT62_ASTRA_MODEL, NATIVE_GPT62_SOL_MODEL } from "./native-models";
/**
* The Ultrafast speed choice OpenAI documents for GPT-6 Astra, GPT-6.1 Sol and GPT-6.2 Astra/Sol
* (https://developers.openai.com/api/docs/guides/ultrafast-mode and
* https://learn.chatgpt.com/docs/agent-configuration/speed#ultrafast-mode, checked 2026-11-20).
*
* The upstream bundled catalog lists only `priority` for these models; ChatGPT's live model
* list adds Ultrafast for eligible plans. Codex stops consulting that live list once
* `model_catalog_json` points at our generated catalog, so without this row the speed picker
* never offers Ultrafast. The `ultraFastTier` switch is the operator's statement that their
* plan is eligible; the description still says the tier requires one.
*/
export const NATIVE_ULTRAFAST_SERVICE_TIER: Readonly<{ id: string; name: string; description: string }> = Object.freeze({
id: "ultrafast",
name: "Ultrafast",
description: "Lower latency, increased usage; requires an eligible plan",
});
export const NATIVE_ULTRAFAST_MODELS: ReadonlySet<string> = new Set([
NATIVE_GPT6_ASTRA_MODEL, NATIVE_GPT61_SOL_MODEL, NATIVE_GPT62_ASTRA_MODEL, NATIVE_GPT62_SOL_MODEL,
]);
function isUltraFastId(value: unknown): boolean {
return typeof value === "string" && value.trim().toLowerCase() === "ultrafast";
}
function isUltraFastDescriptor(value: unknown): boolean {
return value !== null && typeof value === "object" && "id" in value && isUltraFastId((value as { id: unknown }).id);
}
/**
* Provenance marker naming the tier fields this module added to a row. Ownership is never
* inferred from a descriptor's text: an operator may have written the very same entry, and only
* a row carrying this marker has anything for the switch to withdraw.
*/
export const NATIVE_ULTRAFAST_PROVENANCE_FIELD = "opencodex_generated_service_tiers";
type TierField = "service_tiers" | "additional_speed_tiers";
function generatedFields(entry: RawEntry): Set<TierField> {
const raw = entry[NATIVE_ULTRAFAST_PROVENANCE_FIELD];
const fields = new Set<TierField>();
if (Array.isArray(raw)) {
for (const value of raw) if (value === "service_tiers" || value === "additional_speed_tiers") fields.add(value);
}
return fields;
}
function isGeneratedDescriptor(value: unknown): boolean {
if (!isUltraFastDescriptor(value)) return false;
const tier = value as Record<string, unknown>;
return Object.keys(tier).length === 3
&& tier.id === NATIVE_ULTRAFAST_SERVICE_TIER.id
&& tier.name === NATIVE_ULTRAFAST_SERVICE_TIER.name
&& tier.description === NATIVE_ULTRAFAST_SERVICE_TIER.description;
}
/** Bare native rows and trusted account-bound clones of the documented Ultrafast models. */
export function nativeUltraFastSlug(entry: RawEntry): string | undefined {
const slug = trustedAccountBoundNativeCatalogSlug(entry)
?? (typeof entry.slug === "string" && !entry.slug.includes("/") ? entry.slug : undefined);
return slug !== undefined && NATIVE_ULTRAFAST_MODELS.has(slug) ? slug : undefined;
}
/**
* Add (enabled) or withdraw (disabled) the documented Ultrafast choice on an eligible native row.
*
* Enabling appends the descriptor to `service_tiers` and "ultrafast" to the deprecated
* `additional_speed_tiers` mirror, after the existing Fast tier and only when absent, and records
* each field it filled in the provenance marker. A repeated sync is a no-op and an
* operator-written Ultrafast entry wins. Disabling removes only what the marker names (and only
* the unedited generated descriptor), then drops the marker; rows without it are left as they
* are. The catalog default tier is never set.
*/
export function applyNativeUltraFastTier(entry: RawEntry, enabled: boolean): void {
const owned = generatedFields(entry);
if (nativeUltraFastSlug(entry) === undefined) {
delete entry[NATIVE_ULTRAFAST_PROVENANCE_FIELD];
return;
}
const tiers = Array.isArray(entry.service_tiers) ? entry.service_tiers : undefined;
const speeds = Array.isArray(entry.additional_speed_tiers) ? entry.additional_speed_tiers : undefined;
if (enabled) {
if (!tiers?.some(isUltraFastDescriptor)) {
entry.service_tiers = [...(tiers ?? []), { ...NATIVE_ULTRAFAST_SERVICE_TIER }];
owned.add("service_tiers");
}
if (!speeds?.some(isUltraFastId)) {
entry.additional_speed_tiers = [...(speeds ?? []), NATIVE_ULTRAFAST_SERVICE_TIER.id];
owned.add("additional_speed_tiers");
}
if (owned.size > 0) entry[NATIVE_ULTRAFAST_PROVENANCE_FIELD] = [...owned].sort();
return;
}
delete entry[NATIVE_ULTRAFAST_PROVENANCE_FIELD];
if (owned.has("service_tiers") && tiers) {
const kept = tiers.filter(tier => !isGeneratedDescriptor(tier));
if (kept.length > 0) entry.service_tiers = kept;
else delete entry.service_tiers;
}
if (owned.has("additional_speed_tiers") && speeds) {
const kept = speeds.filter(speed => !isUltraFastId(speed));
if (kept.length > 0) entry.additional_speed_tiers = kept;
else delete entry.additional_speed_tiers;
}
}