Make `getstats` interface more specific

[yebai]

I'd hope we have more specific guidelines on how samplers should implement or use this API.

Originally posted by @yebai in #182 (comment)

[penelopeysm]

One day when the interface has settled I'll write docs with an example, although it will probably go on the docs repo, not here.