Add Tavily toolkit with Search, Extract, Crawl, and Map

[pushpak1300]

Currently there isn't a way to interact with Tavily's APIs in the toolkit. This PR adds a complete Tavily toolkit with four tools aligned with the official @tavily/ai-sdk package.

use Shipfastlabs\Toolkit\Tavily\TavilySearch;
use Shipfastlabs\Toolkit\Tavily\TavilyExtract;
use Shipfastlabs\Toolkit\Tavily\TavilyCrawl;
use Shipfastlabs\Toolkit\Tavily\TavilyMap;

$tools = [
    new TavilySearch,   // real-time web search
    new TavilyExtract,  // content extraction from URLs
    new TavilyCrawl,    // intelligent website crawling
    new TavilyMap,      // website structure discovery
];

All tools read credentials from services.tavily.key and support per-tool defaults under ai.toolkit.tavily.*. Search uses body-based auth; Extract, Crawl, and Map use Bearer tokens per the Tavily API specs.

Includes 49 tests covering validation, defaults, boundary clamping, explicit null handling, invalid enum fallback, and error cases. All quality gates pass (Pint, Rector, PHPStan max, 100% type coverage, 100% code coverage).

API reference:

• Search: https://docs.tavily.com/documentation/api-reference/endpoint/search
• Extract: https://docs.tavily.com/documentation/api-reference/endpoint/extract
• Crawl: https://docs.tavily.com/documentation/api-reference/endpoint/crawl
• Map: https://docs.tavily.com/documentation/api-reference/endpoint/map

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
toolkit	Ready	Preview, Comment	Jun 7, 2026 4:12pm