/** Where the learning harness lives inside a metaharness repo checkout. */
export declare const LEARN_MJS_REL: string;
export declare const GATEWAY_BASE_URL = "https://apicompletions-63rzcdswba-uc.a.run.app/v1";
export declare const GATEWAY_API_KEY_ENV = "COGNITUM_DEV_KEY";
/** Packaged seed aliases → tarball-shipped genome files (resolved against GENOMES_ROOT). */
export declare const PACKAGED_SEEDS: Record<string, string>;
export interface LearnArgs {
    host?: string;
    model?: string;
    slice?: string;
    seed?: string;
    trainFirst?: string;
    maxCost?: string;
    viaGateway: boolean;
    run: boolean;
    /** Unrecognized `--flag [value]` pairs, forwarded to learn.mjs verbatim. */
    passthrough: string[];
    errors: string[];
}
/** Parse `metaharness learn` argv. Pure. */
export declare function parseLearnArgs(rest: string[]): LearnArgs;
/**
 * Locate the GEPA learning harness. Honors `env.METAHARNESS_REPO` first, then walks up
 * from `startDir` looking for LEARN_MJS_REL. Returns the absolute learn.mjs path or null.
 * Pure given the injected `exists` predicate.
 */
export declare function findLearnHarness(startDir: string, env?: Record<string, string | undefined>, exists?: (p: string) => boolean): string | null;
/**
 * Resolve `--seed`. `cand6` (any case) → the packaged promoted genome; any other value
 * passes through unchanged (learn.mjs resolves relative paths against its bench dir);
 * undefined → undefined (learn.mjs uses its default frozen seed). Pure.
 */
export declare function resolveSeed(seed: string | undefined, genomesRoot?: string): string | undefined;
/**
 * Assemble the argv for `node learn.mjs`. Pure.
 *
 * $0-default rule: `--dry-run` is appended UNLESS args.run is true. `--via-gateway`
 * expands to `--base-url` + `--api-key-env` (cognitum meta-llm Completions API) unless the
 * caller already supplied either flag explicitly.
 */
export declare function buildLearnArgs(args: LearnArgs, seedPath?: string): string[];
/** The actionable no-repo message (no stack trace — printed and exited cleanly). Pure. */
export declare function repoRequiredMessage(): string[];
/**
 * `metaharness learn` entrypoint: gate on a repo checkout, resolve the seed, then spawn
 * `node learn.mjs <args>` with stdio inherited, propagating its exit code.
 */
export declare function learnCmd(rest: string[], opts?: {
    cwd?: string;
    env?: Record<string, string | undefined>;
}): Promise<number>;
//# sourceMappingURL=learn.d.ts.map