関数は値です:関数を別の関数に渡し、新しい関数を返してもらえます。デコレーターは、関数を受け取り、それを包んだものを返す関数です。defの上の@log_callsは、f = log_calls(f)の省略形です。
ラッパーはふつう*args, **kwargsを受け取るので、どの関数にも合い、前後で何かを行い、元の関数の結果を返します。そのreturnを忘れるのが定番のバグです:デコレートされた関数が突然Noneを返すようになります。
デコレートされた関数が名前とdocstringを保つように、ラッパーに@functools.wraps(func)を付けてください。そうしないと、デコレートされた関数はどれもwrapperという名前になります。
@retry(times=3)のようにデコレーターにオプションを与えるには、層をもう1つ加えます:オプションを受け取り、デコレーターを返す関数です。
標準ライブラリのデコレーターはすでに使っています:@functools.lru_cacheと@dataclassです。