import type { Api, Model } from "./types";
/**
 * Codex GPT-5.6 OAuth context-window policy.
 *
 * Authoritative source and ownership path
 * ---------------------------------------
 * The authenticated Codex backend discovery endpoint (`GET {base}/codex/models`
 * with an OAuth bearer token) is the authoritative runtime source of Codex OAuth
 * model context-window metadata (`models[].context_window`). OpenAI owns that
 * value; GJC consumes it read-only via `fetchCodexModels` and must not silently
 * invent a larger limit without upstream evidence.
 *
 * This bundled policy is a client-side conservative guard, not a primary source.
 * It exists because OpenAI temporarily reverted the GPT-5.6 Sol product context
 * limit from 372K to 272K on 2026-07-13 (staff announcement quoted in
 * gajae-code issues #2240 / #2260), while planning to restore 372K later.
 * `ceiling` must only be raised with an upstream evidence citation; an
 * unverified report that "372K is live again" is not sufficient.
 *
 * Precedence (highest -> lowest)
 * ------------------------------
 * 1. Explicit user per-model override (`contextWindow` in `modelOverrides`).
 *    The model registry merges it into `model.contextWindow` before this cap and
 *    passes it here; it is honored when a positive finite number, with
 *    diagnostics emitted at the registry. Never silently discarded.
 * 2. Live OAuth discovery metadata (`context_window`), forced to the enforced
 *    product window for the GPT-5.6 tier.
 * 3. Bundled conservative generic window (`CODEX_GENERIC_CONTEXT_WINDOW`),
 *    used when discovery metadata is absent or invalid.
 */
export interface CodexGpt56ContextCapPolicy {
    /**
     * Usable prompt budget forced for the GPT-5.6 tier on the Codex product
     * transport. The live OpenAI code backend metadata still reports the old
     * 272K budget (or the total-window figure), so this is an explicit product
     * override: the tier is forced to the enforced window regardless of what
     * discovery reports.
     */
    enforced: number;
}
export declare const CODEX_GPT_5_6_CONTEXT_CAP: CodexGpt56ContextCapPolicy;
/**
 * Generic usable prompt budget for OpenAI code backend models outside the
 * GPT-5.6 tier (e.g. gpt-5.5, gpt-5.4-codex, gpt-5.6-codex). Kept separate from
 * {@link CODEX_GPT_5_6_CONTEXT_CAP} so the forced 5.6-tier window never leaks
 * into unrelated Codex discovery rows.
 */
export declare const CODEX_GENERIC_CONTEXT_WINDOW = 272000;
export declare function isCodexProductTransport(model: Pick<Model<Api>, "api" | "provider">): boolean;
export declare function isCodexGpt56Tier(model: Pick<Model<Api>, "id">): boolean;
export declare function codexContextOverrideKey(provider: string, modelId: string): string;
export declare function resolveCodexGpt56DiscoveryContext(model: Pick<Model<Api>, "api" | "id" | "provider">, rawContextWindow: unknown, policy?: CodexGpt56ContextCapPolicy): number;
/**
 * Applies the final Codex GPT-5.6 context ceiling, honoring explicit user
 * overrides.
 *
 * `userContextWindowOverrides` maps provider-qualified composite keys
 * (`provider:modelId`, both lowercased, built by
 * {@link codexContextOverrideKey}) to the user's explicit `contextWindow` value
 * (already merged into `model.contextWindow` by the model registry). A tier
 * model present with a positive finite value keeps its value even above
 * `enforced` — the user's explicit, diagnosed choice. Every other tier
 * model is forced to `enforced`, so a stale larger live/cached observation
 * (e.g. a pre-rollback 373K cache) cannot resurface without an override.
 * Because the key is provider-qualified, an override only exempts the exact
 * provider+model pair it was configured for.
 */
export declare function applyFinalCodexGpt56ContextCap<TApi extends Api>(models: readonly Model<TApi>[], policy?: CodexGpt56ContextCapPolicy, userContextWindowOverrides?: ReadonlyMap<string, number>): Model<TApi>[];