Add 'smtp_required' option to Python SDK hosted auth

[pengfeiye]

License

I confirm that this contribution is made under the terms of the MIT license and that I have the authority necessary to make this contribution on behalf of its copyright owner.

---

Note

Low Risk
Small, additive change limited to auth URL query construction and typed config; main risk is unintended mutation/parameter differences in generated URLs.

Overview
Adds an optional smtp_required flag to hosted authentication URL configuration, allowing IMAP flows to force SMTP settings entry by emitting options=smtp_required in the generated query string.

Updates _build_query (and PKCE variant) to translate and strip the flag from URL params, adds targeted unit tests for true/false/omitted cases, and documents the new option in the changelog and config docstring.

^{Written by Cursor Bugbot for commit 55e7b5f. This will update automatically on new commits. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.}

This PR is being reviewed by Cursor Bugbot

Details

Your team is on the Bugbot Free tier. On this plan, Bugbot will review limited PRs each billing cycle for each member of your team.

To receive Bugbot reviews on all of your PRs, visit the Cursor dashboard to activate Pro and start your 14-day free trial.