Enhance architecture documentation: update provider support, add adaptive pacing details, and clarify error handling

Author: matt-edmondson