Also add an API method for exposing new promises.

Update the plugin and API documentation, specifically concerning the above
changes.