feat: add max_cache_age parameter to SDK

[seatedro]

feat: add max_cache_age parameter to SDK

Summary

Adds the max_cache_age parameter to the Python SDK, allowing users to control cache freshness for content retrieval. This parameter specifies the maximum age (in seconds) of cached content before triggering a live crawl.

Changes:

• Added max_cache_age to CONTENTS_OPTIONS_TYPES for validation
• Added max_cache_age: Optional[int] = None parameter to all get_contents overloads (4 signatures)
• Added max_cache_age: Optional[int] = None parameter to all find_similar_and_contents overloads (5 signatures)
• Added max_cache_age to nest_fields calls so it gets nested under "contents" in API requests

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring