/**
 * Thinking metadata: runtime field-read helpers.
 *
 * Derivation lives in the compat engine (`compat/resolve`) and runs exactly
 * once per model — from `buildModel` for dynamic specs and from the catalog
 * generator for bundled entries. Everything here reads baked fields only: no
 * id parsing, no host matching, no compat detection per request.
 */
import { Effort } from "./effort.js";
import type { Api, Model, ModelSpec, ThinkingConfig } from "./types.js";
/**
 * Runtime helpers read baked metadata only, so they accept both pre-build
 * specs and built models.
 */
type ApiModel<TApi extends Api = Api> = ModelSpec<TApi> | Model<TApi>;
/**
 * Returns the supported thinking efforts declared on the model metadata.
 * Empty for non-reasoning models and for reasoning models without a
 * controllable effort surface (`thinking: undefined`).
 */
export declare function getSupportedEfforts<TApi extends Api>(model: ApiModel<TApi>): readonly Effort[];
/**
 * Neutral view of a model whose thinking ladder is unverified: `reasoning: false`
 * and no ladder. Re-entering policy resolution starts from it (the ladder is
 * derived output, not authored input), and requests without an effort send it so
 * no reasoning or disable fields reach an upstream that may reject them.
 */
export declare function withoutUnverifiedThinking<T extends {
    reasoning: boolean;
    thinking?: ThinkingConfig;
}>(model: T): T;
/**
 * Clamps a requested thinking level against explicit model metadata.
 *
 * An unserved level first follows `thinking.effortMap` when the map sends it to
 * a served tier that reaches the wire unchanged (a gateway answering `medium`
 * as `high`); otherwise it climbs down to the nearest lower tier.
 *
 * Non-reasoning models always resolve to `undefined`.
 */
export declare function clampThinkingLevelForModel<TApi extends Api>(model: ApiModel<TApi> | undefined, requested: Effort | undefined): Effort | undefined;
export declare function requireSupportedEffort<TApi extends Api>(model: ApiModel<TApi>, effort: Effort): Effort;
/** Maps a normalized thinking effort to Google's `thinkingLevel` enum values.
 * When a collapsed family routes `minimal` onto the same wire id as `low`
 * (Antigravity Gemini 3.6/3.7 Flash), emit `LOW` — Cloud Code Assist rejects
 * `MINIMAL` on those `-low` SKUs.
 */
export declare function mapEffortToGoogleThinkingLevel<TApi extends Api>(effort: Effort, model?: ApiModel<TApi>): "MINIMAL" | "LOW" | "MEDIUM" | "HIGH";
/**
 * Maps a normalized thinking effort to Anthropic adaptive effort values via
 * the model's baked `thinking.effortMap` (identity for unmapped efforts).
 *
 * The Anthropic adaptive wire vocabulary has no `minimal` tier (valid values:
 * `low`, `medium`, `high`, `xhigh`, `max`); a model ladder that exposes
 * `minimal` — custom `anthropic-messages` providers do, unlike the built-in
 * Claude ladders — would otherwise serialize `output_config.effort: "minimal"`
 * and 400 (`level "minimal" not supported`). Clamp it to the lowest real tier,
 * mirroring {@link mapEffortToGoogleThinkingLevel}'s `minimal` handling.
 */
export declare function mapEffortToAnthropicAdaptiveEffort<TApi extends Api>(model: ApiModel<TApi>, effort: Effort): "low" | "medium" | "high" | "xhigh" | "max" | "adaptive";
/**
 * Resolves the upstream wire model id for a request at the given effort
 * (`undefined` = thinking off). Collapsed effort-tier variants route through
 * `thinking.effortRouting`; everything else falls back to
 * `requestModelId ?? id`.
 */
export declare function resolveWireModelId<TApi extends Api>(model: ApiModel<TApi>, effort: Effort | undefined): string;
/**
 * Lowest supported effort in canonical order — the clamp target for
 * thinking-off requests on `thinking.requiresEffort` models.
 */
export declare function minimumSupportedEffort<TApi extends Api>(model: ApiModel<TApi>): Effort | undefined;
/**
 * Clamp target for effort-less requests on `thinking.requiresEffort` models:
 * the effort whose wire route equals the model's default wire id
 * (`requestModelId`), so a collapsed row clamps to the tier it already
 * advertises as its default rather than the numerically lowest supported tier
 * (e.g. Cursor Grok 4.5/4.6 default to `medium`, the only tier the Start plan
 * serves). Falls back to {@link minimumSupportedEffort} when no route matches
 * the default id — families whose default already is the minimum, or that
 * expose no routing, are unaffected.
 */
export declare function defaultSupportedEffort<TApi extends Api>(model: ApiModel<TApi>): Effort | undefined;
export {};