/**
 * CLI boundary normalization for evaluation mode names.
 *
 * Legacy CLI users pass variant names like "baseline" or "agentic" as the
 * --mode flag. This module normalizes those to the canonical mode ("literacy")
 * plus a variant field, so downstream pipeline code only ever sees canonical
 * mode names.
 */
import { type EvalMode } from "../_vendor/ailf-shared/index.d.ts";
/**
 * Literacy variant name constants.
 *
 * Production code imports these instead of scattering legacy string literals.
 * Defined here (alongside the normalizer) so all variant name definitions
 * live in one file — the single source of truth for the legacy-to-canonical
 * mapping.
 */
export declare const LiteracyVariant: {
    /** Standard with-docs / without-docs evaluation (legacy mode name: "baseline") */
    readonly STANDARD: "baseline";
    /** Agentic evaluation — model uses tools to find docs */
    readonly AGENTIC: "agentic";
    /** Observed mode — HTTP-instrumented behavior observation */
    readonly OBSERVED: "observed";
    /** Full mode — standard + agentic combined */
    readonly FULL: "full";
};
/** Union of all literacy variant string values */
export type LiteracyVariantName = (typeof LiteracyVariant)[keyof typeof LiteracyVariant];
/**
 * The two literacy evaluation sub-modes that control entry generation.
 * "standard" (baseline) generates gold + floor entries; "agentic" generates
 * gold entries only.
 */
export type LiteracyEvalSubMode = typeof LiteracyVariant.STANDARD | typeof LiteracyVariant.AGENTIC;
export interface NormalizedMode {
    mode: EvalMode;
    variant?: LiteracyVariantName;
}
/**
 * Normalize a raw CLI mode string to a canonical mode + optional variant.
 *
 * Legacy names ("baseline", "agentic", "observed", "full") are mapped to
 * `{ mode: "literacy", variant: "<name>" }` and emit a deprecation warning
 * on stderr. Canonical names pass through unchanged.
 *
 * @throws {Error} If the input is not a recognized mode or variant name.
 */
export declare function normalizeMode(input: string): NormalizedMode;
