#204
feat(connectors): add Tavily connector
Tavily is missing from the public connector catalog. This adds Search, Extract, Crawl, Map, asynchronous Research, and a free reader for existing research jobs.
The connector shares bearer authentication and request settings, mirrors the documented REST inputs, requires explicit Crawl/Map limits, and polls Research with streaming disabled. Billable runs settle from Tavily’s native credit receipt, including zero; reading an existing job does not charge for its historical usage again. No engine, compiler, or dependency changes.
Validation
- Full offline suite: 1,337 passed, 0 failed, 226 credential-gated skips.
- Tavily contract/replay suite: 39 passed, 0 failed.
- All five live provider smoke tests passed: Search, Extract, Crawl, Map, and one mini Research job. Results and native usage were checked; Research returned a cited report.
- Full typecheck, scoped formatting/lint, engine version gate, and deterministic compilation passed.
No actionable comments were generated in the recent review.
bb875023-ab0e-4e4a-960f-4bffc7e7ba1dReviewing files that changed from the base of the PR and between 09d54479142e36eff876383beacfbd37b33b5908 and 5001d350e31162f110112c204a4ae7631fe3d0a7.
connectors/ids.lock.jsonconnectors/tavily/README.mdconnectors/tavily/connector.test.tsconnectors/tavily/endpoints/crawl/endpoint.test.tsconnectors/tavily/endpoints/crawl/endpoint.tsconnectors/tavily/endpoints/crawl/schema/inputs.tsconnectors/tavily/endpoints/extract/endpoint.test.tsconnectors/tavily/endpoints/extract/endpoint.tsconnectors/tavily/endpoints/extract/schema/inputs.tsconnectors/tavily/endpoints/map/endpoint.test.tsconnectors/tavily/endpoints/map/endpoint.tsconnectors/tavily/endpoints/map/schema/inputs.tsconnectors/tavily/endpoints/research-status/endpoint.test.tsconnectors/tavily/endpoints/research-status/endpoint.tsconnectors/tavily/endpoints/research-status/schema/inputs.tsconnectors/tavily/endpoints/research/endpoint.test.tsconnectors/tavily/endpoints/research/endpoint.tsconnectors/tavily/endpoints/research/schema/inputs.tsconnectors/tavily/endpoints/search/endpoint.test.tsconnectors/tavily/endpoints/search/endpoint.tsconnectors/tavily/endpoints/search/schema/inputs.tsconnectors/tavily/fixtures/synthetic-crawl.jsonconnectors/tavily/fixtures/synthetic-extract.jsonconnectors/tavily/fixtures/synthetic-map.jsonconnectors/tavily/fixtures/synthetic-provider-error.jsonconnectors/tavily/fixtures/synthetic-research.jsonconnectors/tavily/fixtures/synthetic-search.jsonconnectors/tavily/parameters.test.tsconnectors/tavily/provider.tsconnectors/tavily/schema/common.tsopenspec/changes/add-connector-tavily/proposal.mdopenspec/changes/add-connector-tavily/specs/tavily-connector/spec.mdopenspec/changes/add-connector-tavily/tasks.mdIncluded review availability: This review used your included allowance. Your plan provides up to 8 included reviews per hour; 7 remain after this review.
Walkthrough
Adds a Tavily connector with Search, Extract, Crawl, Map, Research, and research-status endpoints. The change defines request schemas, bearer authentication, usage-credit estimates and settlement, and research polling behavior. It also adds synthetic fixtures, endpoint and transport tests, documentation, specifications, and six catalog IDs.
Priority: Normal
Merge Risk: Minimal · up to
5001dNo concrete issue in the Tavily connector evidence blocks merging after normal checks; hosted end-to-end verification remains pending.
Pre-merge checks: 4
Full details: Title check
Explanation
The title names the main change: adding a Tavily connector. The changeset adds Tavily Search, Extract, Crawl, Map, Research, and a Research status reader, along with fixtures, tests, and docs. The title is specific and matches the PR objectives.
Comment
@coderabbitai helpto get the list of available commands.