UNPKG

@bitkyc08/opencodex

Version:

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

59 lines (52 loc) • 2.99 kB
import { COMBO_NAMESPACE } from "../../combos/identifiers"; import { isPlainObject } from "../../lib/plain-data"; import { CODEX_NATIVE_ALIAS_CATALOG_KIND } from "./kinds"; import { SUPPORTED_NATIVE_OPENAI_SLUGS } from "./native-models"; import { hasOcxRoutedAuthorship } from "./ownership"; import type { RawCatalog, RawEntry } from "./parsing"; /** Internal source evidence, outside the emitted model collection. */ export const NATIVE_INHERITANCE_TEMPLATE_FIELD = "opencodex_native_inheritance_template"; function isSupportedNativeTemplate(row: RawEntry): boolean { return typeof row.slug === "string" && SUPPORTED_NATIVE_OPENAI_SLUGS.has(row.slug) && !row.slug.includes("/") && "base_instructions" in row && row.opencodex_catalog_kind !== CODEX_NATIVE_ALIAS_CATALOG_KIND && row.owned_by !== COMBO_NAMESPACE && !hasOcxRoutedAuthorship(row); } export function retainedNativeInheritanceTemplate(catalog: RawCatalog | null): RawEntry | null { const retained = catalog?.[NATIVE_INHERITANCE_TEMPLATE_FIELD]; return isPlainObject(retained) && isSupportedNativeTemplate(retained) ? retained : null; } /** * Inheritance is stricter than catalog validity: unknown bare rows must never lend native * eligibility to routed rows (#2813). Retained source evidence uses exactly the same rule. * Prefer it over emitted rows so omission of the first native cannot change the next build. * No supported source still returns null, preserving the existing null-template behavior. */ export function findSupportedNativeTemplate(catalog: RawCatalog | null): RawEntry | null { return retainedNativeInheritanceTemplate(catalog) ?? catalog?.models?.find(isSupportedNativeTemplate) ?? null; } /** Capture before any visibility, capability or ordering projection mutates emitted rows. */ export function captureNativeInheritanceTemplate(catalog: RawCatalog, enabled: boolean): RawEntry | null { const template = findSupportedNativeTemplate(catalog); if (enabled && template) catalog[NATIVE_INHERITANCE_TEMPLATE_FIELD] = structuredClone(template); else delete catalog[NATIVE_INHERITANCE_TEMPLATE_FIELD]; return template; } /** * Replace upgradeable source evidence with the writer's fully normalized native result. * Non-upgraded source evidence stays pristine, preserving existing byte-idempotent builds. * The writer passes its upgrade rule in: importing it from `metadata.ts` here would close a * load-time cycle through `bundled.ts`, which reads this module's retained template. */ export function advanceNativeInheritanceTemplate( catalog: RawCatalog, entries: readonly RawEntry[], shouldUpgrade: (entry: RawEntry) => boolean, ): void { const retained = retainedNativeInheritanceTemplate(catalog); if (!retained || !shouldUpgrade(retained)) return; const upgraded = entries.find(row => row.slug === retained.slug && isSupportedNativeTemplate(row)); if (upgraded) catalog[NATIVE_INHERITANCE_TEMPLATE_FIELD] = structuredClone(upgraded); }