/**
 * Shared option groups for the AILF CLI.
 *
 * Each function adds a group of related options to a Commander command.
 * This eliminates copy-paste across commands that share common flags
 * (e.g., debug options, Sanity source options, output options).
 */
import type { Command } from "commander";
/**
 * Add agentic options on `ailf run`: `--url` and `--search`. Both are
 * per-run overrides.
 *
 * **`--header` and `--allowed-origin` retired in W0077 Phase 6f** —
 * configure them in `.ailf/config.yaml`'s `agentic` block instead. The
 * `DOC_HEADERS` and `DOC_ALLOWED_ORIGIN(S)` env vars still apply.
 */
export declare function addAgenticOptions(cmd: Command): Command;
/**
 * Add debug + filter options.
 *
 * `-d, --debug` is a shortcut that runs only the first 2 tests for fast
 * feedback. `--filter-first-n`, `--filter-pattern`, and `--filter-sample`
 * narrow the test set explicitly and mirror the same-named flags on
 * `ailf eval` so the pipeline surface matches the underlying Promptfoo
 * passthrough.
 */
export declare function addDebugOptions(cmd: Command): Command;
/**
 * Add output options: --output, --format
 */
export declare function addOutputOptions(cmd: Command): Command;
/**
 * Add --output-dir option for commands that write pipeline artifacts.
 *
 * Pair with `resolveOutputDir()` from `./resolve-output-dir.js` to resolve
 * the value. When omitted, `resolveOutputDir()` defaults to
 * `$CWD/.ailf/results/latest/`.
 */
export declare function addOutputDirOption(cmd: Command): Command;
/**
 * Add the full Sanity-source CLI surface — dataset, project, perspective,
 * studio origin, document. Used by `ailf fetch-docs`, which is invoked
 * directly with explicit Sanity targeting per run.
 *
 * **Not used by `ailf run`** post-W0077 Phase 6d. The dataset, project, and
 * studio-origin trio moved to `.ailf/config.yaml`'s `source` block (with
 * `SANITY_DATASET` / `SANITY_PROJECT_ID` / `SANITY_STUDIO_ORIGIN` env-var
 * fallbacks). `ailf run` uses `addSanityScopeOptions` instead, which keeps
 * only the per-run flags (`--sanity-perspective`, `--sanity-document`).
 */
export declare function addSanitySourceOptions(cmd: Command): Command;
/**
 * Add the per-run Sanity-scope CLI surface — `--sanity-perspective` and
 * `--sanity-document`. Used by `ailf run`. The per-environment trio
 * (dataset, project, studio origin) lives in `.ailf/config.yaml`'s
 * `source` block instead (W0077 Phase 6d).
 */
export declare function addSanityScopeOptions(cmd: Command): Command;
/**
 * Collect repeatable string options into an array.
 * Used as a Commander argParser for options like --url, --header, --allowed-origin.
 */
export declare function collect(value: string, previous: string[]): string[];
