docs: expand pagination and retry behavior docs (v1.0.4)

[im-voracity]

Summary

• Add page-by-page processing pattern to Pagination section (EN + PT-BR): manual page_token loop for use cases requiring per-page side effects (checkpointing, batch DB writes, progress bars)
• Add Retry behavior table to Error Handling section (EN + PT-BR): clarifies which errors are retried with backoff, which trigger transparent token refresh, and which raise immediately — preventing common misunderstandings about when RateLimitError and AuthenticationError actually surface
• Sync uv.lock to requires-python = ">=3.11" (removes Python 3.10 wheels)
• Bump version to 1.0.4

Test Plan

• All 67 unit tests pass (uv run pytest)
• No code changes — documentation and metadata only