@spec get_attempts(String.t() | PromptRunner.Plan.t(), String.t()) :: {:ok, [map()]}

@spec get_failures(String.t() | PromptRunner.Plan.t(), String.t()) :: {:ok, [map()]}

@spec get_status(String.t() | PromptRunner.Plan.t()) :: {:ok, state()}

@spec mark_status(String.t() | PromptRunner.Plan.t(), String.t(), String.t(), map()) ::
  :ok

@spec prompt_state(String.t() | PromptRunner.Plan.t(), String.t()) :: {:ok, map()}

@spec record_attempt_result(
  String.t() | PromptRunner.Plan.t(),
  String.t(),
  integer(),
  map()
) :: :ok

@spec record_attempt_started(
  String.t() | PromptRunner.Plan.t(),
  map(),
  integer(),
  String.t()
) :: :ok

@spec state_path(String.t() | PromptRunner.Plan.t()) :: String.t()