/**
 * Hint Registry for Compact Error Responses
 *
 * Per AX-012, provides stable, cacheable advice snippets that agents can fetch once and reuse.
 * Hints are referenced by stable IDs in compact error envelopes.
 *
 * @module shared/errors/hint-registry
 */
/**
 * Hint advice structure
 */
export interface Hint {
    /** Recommended action to resolve the error */
    action: string;
    /** Tool or command to use (optional) */
    tool?: string;
    /** Specific field to check or introspect (optional) */
    field?: string;
}
/**
 * Type for all valid hint IDs
 */
export type HintId = string;
/**
 * Hint registry mapping stable hint IDs to advice snippets
 */
export declare const HINT_REGISTRY: Record<HintId, Hint>;
/**
 * Map error codes to hint IDs
 * Supports both LexErrorCode and MCP error code strings
 */
export declare const ERROR_CODE_TO_HINT_ID: Record<string, HintId>;
/**
 * Get hint by ID
 */
export declare function getHint(hintId: HintId): Hint | undefined;
/**
 * Get multiple hints by IDs
 */
export declare function getHints(hintIds: HintId[]): Record<HintId, Hint>;
/**
 * Get hint ID for an error code
 */
export declare function getHintIdForErrorCode(code: string): HintId | undefined;
/**
 * Check if a hint ID exists in the registry
 */
export declare function isValidHintId(hintId: string): hintId is HintId;
/**
 * Get all available hint IDs
 */
export declare function getAvailableHintIds(): HintId[];
/**
 * Get hints for codes (alias for getHints with text formatting for CLI/MCP)
 * Returns hints with 'text' field combining action, tool, and field info
 */
export declare function getHintsForCodes(hintIds: HintId[]): Record<HintId, {
    text: string;
    docLink?: string;
}>;