Skip to content

feat: add API warning reporting and retire Research API - #285

Merged
wlue merged 1 commit into
masterfrom
oss-publish/exa-py
Oct 19, 2026
Merged

wlue merged 1 commit into
masterfrom
oss-publish/exa-py

Conversation

@exa-oss-publish

@exa-oss-publish exa-oss-publish Bot commented Oct 19, 2026 •

Copy link
Copy Markdown
Contributor
  • Add ApiWarning response parsing and caller-attributed ExaWarning reporting for /search, plus deprecation warnings for deprecated crawl-date and highlights fields.
  • Retire the Research API so all synchronous and asynchronous research methods raise ValueError without sending requests.
  • Add lite search type, structured UserLocation exports, expanded person entity properties, preserved content-status errors, and updated search API coverage.
  • Improve timeout validation and reporting, preserve connect timeouts during address failover, disable read timeouts after streams begin, and describe non-JSON successful responses.
  • Document Agent budget defaults and Agent Monitor field, entity, and backtest semantics, including rejected mode request values.
  • Encode boolean list query values consistently, omit None list elements, remove the legacy asynchronous Websets client module, and update Websets client documentation.
  • Include search notices in tool output, resolve installed package versions from distribution metadata, and expand package and integration coverage.
  • Document api_warnings.py generation support and remove deprecated search subpage examples.

Changes by Wen-Hao Lue.

This pull request was opened by the automated sync of this repository.

Staged commit fa8f5a6
Change digest 70109b75039aa137983420ce938de6c1ca2369d37dbbc22203e57b6da847e067

The synced files are generated at the source and overwritten by every sync, so please do not push to this branch.

BEGIN_COMMIT_OVERRIDE
feat: add the lite search type
feat: accept any search type string, keeping known types for autocomplete
feat: return typed search warnings on responses and streams
feat: report API warnings as ExaWarning and warn on deprecated options
feat: show search notices to the model in the web search tools
feat: accept latitude and longitude in user_location
fix: send filter_empty_results inside contents
fix: stream and connect timeouts, query encoding, and AsyncExa typing and lifecycle
fix: fail Research API calls at once with a retirement error
docs: point deep-reasoning callers at deep or Exa Agent
docs: deprecate search subpages, extras rich links and code blocks, and summary max tokens
END_COMMIT_OVERRIDE

- Add `ApiWarning` response parsing and caller-attributed `ExaWarning` reporting for `/search`, plus deprecation warnings for deprecated crawl-date and highlights fields.
- Retire the Research API so all synchronous and asynchronous research methods raise `ValueError` without sending requests.
- Add `lite` search type, structured `UserLocation` exports, expanded person entity properties, preserved content-status errors, and updated search API coverage.
- Improve timeout validation and reporting, preserve connect timeouts during address failover, disable read timeouts after streams begin, and describe non-JSON successful responses.
- Document Agent budget defaults and Agent Monitor field, entity, and backtest semantics, including rejected `mode` request values.
- Encode boolean list query values consistently, omit `None` list elements, remove the legacy asynchronous Websets client module, and update Websets client documentation.
- Include search notices in tool output, resolve installed package versions from distribution metadata, and expand package and integration coverage.
- Document `api_warnings.py` generation support and remove deprecated search subpage examples.

GitOrigin-RevId: 9a865488ae3eedc3ad52df860cc79bf6bef57f66
Co-authored-by: Wen-Hao Lue <wlue@users.noreply.github.com>
@exa-oss-publish exa-oss-publish Bot changed the title feat: retire the Research API feat: add API warning reporting and retire Research API Oct 19, 2026
@wlue
wlue merged commit bcc2f8f into master Oct 19, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant