import { BadRequestError } from 'helpful-errors';
import type { BrainAtomSlugFireworksPinned } from '../BrainAtom.config';
/**
 * .what = builds the error that names a caller's successor choice, or null
 * .why = a model retired with no single successor must fail LOUD and NAMED.
 *        the opaque `404 Model not found` fireworks returns tells a caller
 *        naught about what to reach for instead
 *
 * .note = returns null when no enrichment applies, so the call site rethrows
 *         the original untouched. this never swallows an error
 *         (`rule.forbid.failhide`) — it only adds the fix to one it recognizes.
 *
 * .note = fires only for an AMBIGUOUS retirement. a ROUTED one never reaches
 *         the api under its old slug, because the resolver re-aimed it first.
 */
export declare const getOneRetirementError: (input: {
    slug: BrainAtomSlugFireworksPinned;
    error: Error;
}) => BadRequestError | null;