docs: sync OpenAPI spec from trails-api (2026-06-01)

Sync the trails-api OpenAPI YAML from the trails-api release branch.
The previous copy was several commits behind, missing six endpoints
and the full Yield protocol schema set.

Endpoints added:
- /rpc/Trails/RetryIntent
- /rpc/Trails/PrepareIntentRecovery
- /rpc/Trails/BuildIntentRecoveryTransaction
- /rpc/Trails/YieldGetProvider
- /rpc/Trails/YieldGetNetworks
- /rpc/Trails/YieldGetMarketById

Also adds the Yield* schema types referenced by these endpoints, fixes
out-of-date QuoteIntentArgs fields, and adds the trailsUtilsAddress
field to TrailsContracts. before-annotations-trails-api.gen.json is
regenerated by the convert-openapi script.

Author: claude