#204

feat(connectors): add Tavily connector

Openmanisrinivasan2k1wants to merge intofrom

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.

Activity

2
coderabbitai[bot]5d ago

No actionable comments were generated in the recent review.

Recent review info
Run configuration
Commits

Reviewing files that changed from the base of the PR and between 09d54479142e36eff876383beacfbd37b33b5908 and 5001d350e31162f110112c204a4ae7631fe3d0a7.

Files selected for processing: 33
  • connectors/ids.lock.json
  • connectors/tavily/README.md
  • connectors/tavily/connector.test.ts
  • connectors/tavily/endpoints/crawl/endpoint.test.ts
  • connectors/tavily/endpoints/crawl/endpoint.ts
  • connectors/tavily/endpoints/crawl/schema/inputs.ts
  • connectors/tavily/endpoints/extract/endpoint.test.ts
  • connectors/tavily/endpoints/extract/endpoint.ts
  • connectors/tavily/endpoints/extract/schema/inputs.ts
  • connectors/tavily/endpoints/map/endpoint.test.ts
  • connectors/tavily/endpoints/map/endpoint.ts
  • connectors/tavily/endpoints/map/schema/inputs.ts
  • connectors/tavily/endpoints/research-status/endpoint.test.ts
  • connectors/tavily/endpoints/research-status/endpoint.ts
  • connectors/tavily/endpoints/research-status/schema/inputs.ts
  • connectors/tavily/endpoints/research/endpoint.test.ts
  • connectors/tavily/endpoints/research/endpoint.ts
  • connectors/tavily/endpoints/research/schema/inputs.ts
  • connectors/tavily/endpoints/search/endpoint.test.ts
  • connectors/tavily/endpoints/search/endpoint.ts
  • connectors/tavily/endpoints/search/schema/inputs.ts
  • connectors/tavily/fixtures/synthetic-crawl.json
  • connectors/tavily/fixtures/synthetic-extract.json
  • connectors/tavily/fixtures/synthetic-map.json
  • connectors/tavily/fixtures/synthetic-provider-error.json
  • connectors/tavily/fixtures/synthetic-research.json
  • connectors/tavily/fixtures/synthetic-search.json
  • connectors/tavily/parameters.test.ts
  • connectors/tavily/provider.ts
  • connectors/tavily/schema/common.ts
  • openspec/changes/add-connector-tavily/proposal.md
  • openspec/changes/add-connector-tavily/specs/tavily-connector/spec.md
  • openspec/changes/add-connector-tavily/tasks.md

Included 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 5001d

No concrete issue in the Tavily connector evidence blocks merging after normal checks; hosted end-to-end verification remains pending.

Pre-merge checks: 4
Check nameStatusExplanation
Description CheckCheck skipped - CodeRabbit’s high-level summary is enabled.
Title checkThe 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 tit…
Linked Issues checkCheck skipped because no linked issues were found for this pull request.
Out of Scope Changes checkCheck skipped because no linked issues were found for this pull request.
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.

  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Comment @coderabbitai help to get the list of available commands.