Examine short circuit AJAX abstraction

[kpdecker]

Take a look at how we are defining metadata, caching info in particular, and see if there is a better way for implementers to provide this information.

Additionally we should revisit the documentation for the method as the data structure that needs to be returned is not as clear as it could be.