@mastra/tavily 0.0.1

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# @mastra/tavily
+
+## 0.1.0-alpha.0
+
+### Minor Changes
+
+- Initial release of `@mastra/tavily` with search, extract, crawl, and map tools for Mastra agents.
+  - `createTavilySearchTool` — Web search with full parameter support (search depth, time range, domain filtering).
+  - `createTavilyExtractTool` — Extract content from URLs in markdown or text format.
+  - `createTavilyCrawlTool` — Crawl websites with configurable depth, breadth, and domain constraints.
+  - `createTavilyMapTool` — Discover and list URLs on a website without extracting content.
+  - `createTavilyTools` — Convenience function returning all four tools with shared configuration.

package/README.md

@@ -0,0 +1,128 @@
+# @mastra/tavily
+
+Tavily web search, extract, crawl, and map tools for [Mastra](https://mastra.ai) agents.
+
+## Installation
+
+```bash
+npm install @mastra/tavily @tavily/core zod
+```
+
+## Quick Start
+
+Use `createTavilyTools()` to get all four tools with a shared configuration:
+
+```typescript
+import { Agent } from '@mastra/core/agent';
+import { createTavilyTools } from '@mastra/tavily';
+
+const tools = createTavilyTools();
+// Or pass an explicit API key:
+// const tools = createTavilyTools({ apiKey: 'tvly-...' });
+
+const agent = new Agent({
+  id: 'realtime-information-agent',
+  name: "Realtime Information Agent",
+  instructions: "You are a realtime information agent that can search the web for the latest information and provide it to the user.",
+  model: "anthropic/claude-sonnet-4-6",
+  tools,
+});
+```
+
+By default, the tools read `TAVILY_API_KEY` from your environment. You can also pass `{ apiKey }` explicitly.
+
+## Individual Tools
+
+Each tool can be created independently:
+
+```typescript
+import { createTavilySearchTool, createTavilyExtractTool } from '@mastra/tavily';
+
+const searchTool = createTavilySearchTool({ apiKey: 'tvly-...' });
+const extractTool = createTavilyExtractTool(); // uses TAVILY_API_KEY env var
+```
+
+### Search
+
+```typescript
+import { createTavilySearchTool } from '@mastra/tavily';
+
+const searchTool = createTavilySearchTool();
+
+// When called by an agent, accepts:
+// - query (required)
+// - searchDepth: 'basic' | 'advanced'
+// - maxResults: 1-20
+// - includeAnswer: boolean | 'basic' | 'advanced'
+// - includeImages, includeImageDescriptions, includeRawContent
+// - includeDomains, excludeDomains
+// - timeRange: 'day' | 'week' | 'month' | 'year'
+```
+
+### Extract
+
+```typescript
+import { createTavilyExtractTool } from '@mastra/tavily';
+
+const extractTool = createTavilyExtractTool();
+
+// Accepts: urls (1-20), extractDepth, includeImages, format ('markdown' | 'text')
+// Returns: results[] + failedResults[]
+```
+
+### Crawl
+
+```typescript
+import { createTavilyCrawlTool } from '@mastra/tavily';
+
+const crawlTool = createTavilyCrawlTool();
+
+// Accepts: url, maxDepth, maxBreadth, limit, instructions,
+//          selectPaths, selectDomains, excludePaths, excludeDomains,
+//          allowExternal, extractDepth, includeImages, format
+// Returns: baseUrl + results[]
+```
+
+### Map
+
+```typescript
+import { createTavilyMapTool } from '@mastra/tavily';
+
+const mapTool = createTavilyMapTool();
+
+// Accepts: url, maxDepth, maxBreadth, limit, instructions,
+//          selectPaths, selectDomains, excludePaths, excludeDomains, allowExternal
+// Returns: baseUrl + discovered URL strings
+```
+
+## Configuration
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `apiKey` | `string` | `process.env.TAVILY_API_KEY` | Your Tavily API key |
+
+All tools accept `TavilyClientOptions` from `@tavily/core` (includes `apiKey`, `proxies`, `apiBaseURL`, `clientSource`, `projectId`). If no API key is found, the tool throws a clear error at execution time. `clientSource` defaults to `'mastra'`.
+
+## RAG Pairing Example
+
+Combine search and extract for retrieval-augmented generation:
+
+```typescript
+import { Agent } from '@mastra/core/agent';
+import { createTavilySearchTool, createTavilyExtractTool } from '@mastra/tavily';
+
+const agent = new Agent({
+  id: 'rag-agent',
+  name: "Research Assistant",
+  model: "anthropic/claude-sonnet-4-6",
+  instructions: `You are a research assistant. Use tavily-search to find relevant pages, then use tavily-extract to get full content from the best results.`,
+  tools: {
+    search: createTavilySearchTool(),
+    extract: createTavilyExtractTool(),
+  },
+});
+```
+
+## License
+
+Apache-2.0

package/dist/client.d.ts

@@ -0,0 +1,6 @@
+import { tavily } from '@tavily/core';
+import type { TavilyClientOptions } from '@tavily/core';
+export type { TavilyClientOptions };
+export type TavilyClient = ReturnType<typeof tavily>;
+export declare function getTavilyClient(config?: TavilyClientOptions): TavilyClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAEpC,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC;AAErD,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,YAAY,CAO1E"}

package/dist/crawl.d.ts

@@ -0,0 +1,25 @@
+import type { TavilyClientOptions } from './client.js';
+export declare function createTavilyCrawlTool(config?: TavilyClientOptions): import("@mastra/core/tools").Tool<{
+    url: string;
+    maxDepth?: number | undefined;
+    maxBreadth?: number | undefined;
+    limit?: number | undefined;
+    instructions?: string | undefined;
+    selectPaths?: string[] | undefined;
+    selectDomains?: string[] | undefined;
+    excludePaths?: string[] | undefined;
+    excludeDomains?: string[] | undefined;
+    allowExternal?: boolean | undefined;
+    extractDepth?: "basic" | "advanced" | undefined;
+    includeImages?: boolean | undefined;
+    format?: "markdown" | "text" | undefined;
+}, {
+    baseUrl: string;
+    results: {
+        url: string;
+        rawContent: string;
+        images?: string[] | undefined;
+    }[];
+    responseTime: number;
+}, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "tavily-crawl", unknown>;
+//# sourceMappingURL=crawl.d.ts.map

package/dist/crawl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crawl.d.ts","sourceRoot":"","sources":["../src/crawl.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAgB,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAoCrE,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,mBAAmB;;;;;;;;;;;;;;;;;;;;;;4HA6CjE"}

package/dist/extract.d.ts

@@ -0,0 +1,20 @@
+import type { TavilyClientOptions } from './client.js';
+export declare function createTavilyExtractTool(config?: TavilyClientOptions): import("@mastra/core/tools").Tool<{
+    urls: string[];
+    extractDepth?: "basic" | "advanced" | undefined;
+    query?: string | undefined;
+    includeImages?: boolean | undefined;
+    format?: "markdown" | "text" | undefined;
+}, {
+    results: {
+        url: string;
+        rawContent: string;
+        images?: string[] | undefined;
+    }[];
+    failedResults: {
+        url: string;
+        error: string;
+    }[];
+    responseTime: number;
+}, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "tavily-extract", unknown>;
+//# sourceMappingURL=extract.d.ts.map

package/dist/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../src/extract.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAgB,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAiCrE,wBAAgB,uBAAuB,CAAC,MAAM,CAAC,EAAE,mBAAmB;;;;;;;;;;;;;;;;;8HAwCnE"}

package/dist/index.cjs

@@ -0,0 +1,287 @@
+'use strict';
+
+var core = require('@tavily/core');
+var tools = require('@mastra/core/tools');
+var zod = require('zod');
+
+// src/client.ts
+function getTavilyClient(config) {
+  const apiKey = config?.apiKey ?? process.env.TAVILY_API_KEY;
+  if (!apiKey) {
+    throw new Error("Tavily API key is required. Pass { apiKey } or set TAVILY_API_KEY env var.");
+  }
+  return core.tavily({ ...config, apiKey, clientSource: config?.clientSource ?? "mastra" });
+}
+var inputSchema = zod.z.object({
+  query: zod.z.string().describe("The search query"),
+  searchDepth: zod.z.enum(["basic", "advanced", "fast", "ultra-fast"]).optional().describe("Search depth \u2014 'basic' for standard, 'advanced' for thorough, 'fast'/'ultra-fast' for low latency"),
+  maxResults: zod.z.number().min(1).max(20).optional().describe("Maximum number of results to return (1-20)"),
+  includeAnswer: zod.z.union([zod.z.boolean(), zod.z.enum(["basic", "advanced"])]).optional().describe('Include an AI-generated answer summary. Pass true, "basic", or "advanced"'),
+  includeImages: zod.z.boolean().optional().describe("Include query-related images in the response"),
+  includeImageDescriptions: zod.z.boolean().optional().describe("Include descriptions for returned images"),
+  includeRawContent: zod.z.union([zod.z.literal(false), zod.z.enum(["markdown", "text"])]).optional().describe('Include cleaned HTML content of each result. Pass false to disable, or "markdown"/"text" for format'),
+  includeDomains: zod.z.array(zod.z.string()).optional().describe("Restrict results to these domains"),
+  excludeDomains: zod.z.array(zod.z.string()).optional().describe("Exclude results from these domains"),
+  timeRange: zod.z.enum(["day", "week", "month", "year"]).optional().describe("Time range to filter results by recency")
+});
+var outputSchema = zod.z.object({
+  query: zod.z.string(),
+  answer: zod.z.string().optional(),
+  images: zod.z.array(
+    zod.z.object({
+      url: zod.z.string(),
+      description: zod.z.string().optional()
+    })
+  ).optional(),
+  results: zod.z.array(
+    zod.z.object({
+      title: zod.z.string(),
+      url: zod.z.string(),
+      content: zod.z.string(),
+      score: zod.z.number(),
+      rawContent: zod.z.string().optional()
+    })
+  ),
+  responseTime: zod.z.number()
+});
+function createTavilySearchTool(config) {
+  let client = null;
+  function getClient() {
+    if (!client) {
+      client = getTavilyClient(config);
+    }
+    return client;
+  }
+  return tools.createTool({
+    id: "tavily-search",
+    description: "Search the web using Tavily. Returns relevant results with content snippets, optional AI-generated answers, and images. Supports filtering by domain, time range, and search depth.",
+    inputSchema,
+    outputSchema,
+    execute: async (input) => {
+      const tavilyClient = getClient();
+      const response = await tavilyClient.search(input.query, {
+        searchDepth: input.searchDepth,
+        maxResults: input.maxResults,
+        includeAnswer: input.includeAnswer,
+        includeImages: input.includeImages,
+        includeImageDescriptions: input.includeImageDescriptions,
+        includeRawContent: input.includeRawContent,
+        includeDomains: input.includeDomains,
+        excludeDomains: input.excludeDomains,
+        timeRange: input.timeRange
+      });
+      return {
+        query: response.query,
+        answer: response.answer || void 0,
+        images: response.images?.map((img) => ({
+          url: typeof img === "string" ? img : img.url,
+          description: typeof img === "string" ? void 0 : img.description
+        })),
+        results: (response.results ?? []).map((r) => ({
+          title: r.title,
+          url: r.url,
+          content: r.content,
+          score: r.score ?? 0,
+          rawContent: r.rawContent || void 0
+        })),
+        responseTime: response.responseTime
+      };
+    }
+  });
+}
+var inputSchema2 = zod.z.object({
+  urls: zod.z.array(zod.z.string()).min(1).max(20).describe("URLs to extract content from (1-20)"),
+  extractDepth: zod.z.enum(["basic", "advanced"]).optional().describe("Extraction depth \u2014 'advanced' retrieves more data including tables and embedded content"),
+  query: zod.z.string().optional().describe("User intent for reranking extracted content chunks. When provided, chunks are reranked based on relevance to this query."),
+  includeImages: zod.z.boolean().optional().describe("Include images extracted from the pages"),
+  format: zod.z.enum(["markdown", "text"]).optional().describe("Output format for extracted content \u2014 'markdown' (default) or 'text'")
+});
+var outputSchema2 = zod.z.object({
+  results: zod.z.array(
+    zod.z.object({
+      url: zod.z.string(),
+      rawContent: zod.z.string(),
+      images: zod.z.array(zod.z.string()).optional()
+    })
+  ),
+  failedResults: zod.z.array(
+    zod.z.object({
+      url: zod.z.string(),
+      error: zod.z.string()
+    })
+  ),
+  responseTime: zod.z.number()
+});
+function createTavilyExtractTool(config) {
+  let client = null;
+  function getClient() {
+    if (!client) {
+      client = getTavilyClient(config);
+    }
+    return client;
+  }
+  return tools.createTool({
+    id: "tavily-extract",
+    description: "Extract content from one or more URLs using Tavily. Returns raw page content in markdown or text format. Supports up to 20 URLs per request with basic or advanced extraction depth.",
+    inputSchema: inputSchema2,
+    outputSchema: outputSchema2,
+    execute: async (input) => {
+      const tavilyClient = getClient();
+      const response = await tavilyClient.extract(input.urls, {
+        extractDepth: input.extractDepth,
+        query: input.query,
+        includeImages: input.includeImages,
+        format: input.format
+      });
+      return {
+        results: (response.results || []).map((r) => ({
+          url: r.url,
+          rawContent: r.rawContent,
+          images: r.images || void 0
+        })),
+        failedResults: (response.failedResults || []).map((r) => ({
+          url: r.url,
+          error: r.error
+        })),
+        responseTime: response.responseTime
+      };
+    }
+  });
+}
+var inputSchema3 = zod.z.object({
+  url: zod.z.string().describe("The root URL to begin the crawl"),
+  maxDepth: zod.z.number().optional().describe("Max depth of the crawl from the base URL"),
+  maxBreadth: zod.z.number().optional().describe("Max number of links to follow per page"),
+  limit: zod.z.number().optional().describe("Total number of pages the crawler will process before stopping"),
+  instructions: zod.z.string().optional().describe("Natural language instructions for the crawler"),
+  selectPaths: zod.z.array(zod.z.string()).optional().describe("Regex patterns to select specific URL paths"),
+  selectDomains: zod.z.array(zod.z.string()).optional().describe("Regex patterns to restrict to specific domains"),
+  excludePaths: zod.z.array(zod.z.string()).optional().describe("Regex patterns to exclude specific URL paths"),
+  excludeDomains: zod.z.array(zod.z.string()).optional().describe("Regex patterns to exclude specific domains"),
+  allowExternal: zod.z.boolean().optional().describe("Whether to follow links to external domains"),
+  extractDepth: zod.z.enum(["basic", "advanced"]).optional().describe("Extraction depth \u2014 'advanced' retrieves more data including tables and embedded content"),
+  includeImages: zod.z.boolean().optional().describe("Include images from crawled pages"),
+  format: zod.z.enum(["markdown", "text"]).optional().describe("Output format for extracted content \u2014 'markdown' (default) or 'text'")
+});
+var outputSchema3 = zod.z.object({
+  baseUrl: zod.z.string(),
+  results: zod.z.array(
+    zod.z.object({
+      url: zod.z.string(),
+      rawContent: zod.z.string(),
+      images: zod.z.array(zod.z.string()).optional()
+    })
+  ),
+  responseTime: zod.z.number()
+});
+function createTavilyCrawlTool(config) {
+  let client = null;
+  function getClient() {
+    if (!client) {
+      client = getTavilyClient(config);
+    }
+    return client;
+  }
+  return tools.createTool({
+    id: "tavily-crawl",
+    description: "Crawl a website starting from a URL using Tavily. Extracts content from discovered pages with configurable depth, breadth, and domain constraints. Returns structured content from each crawled page.",
+    inputSchema: inputSchema3,
+    outputSchema: outputSchema3,
+    execute: async (input) => {
+      const tavilyClient = getClient();
+      const response = await tavilyClient.crawl(input.url, {
+        maxDepth: input.maxDepth,
+        maxBreadth: input.maxBreadth,
+        limit: input.limit,
+        instructions: input.instructions,
+        selectPaths: input.selectPaths,
+        selectDomains: input.selectDomains,
+        excludePaths: input.excludePaths,
+        excludeDomains: input.excludeDomains,
+        allowExternal: input.allowExternal,
+        extractDepth: input.extractDepth,
+        includeImages: input.includeImages,
+        format: input.format
+      });
+      return {
+        baseUrl: response.baseUrl,
+        results: (response.results || []).map((r) => ({
+          url: r.url,
+          rawContent: r.rawContent,
+          images: r.images || void 0
+        })),
+        responseTime: response.responseTime
+      };
+    }
+  });
+}
+var inputSchema4 = zod.z.object({
+  url: zod.z.string().describe("The root URL to begin mapping"),
+  maxDepth: zod.z.number().optional().describe("Max depth of the mapping from the base URL"),
+  maxBreadth: zod.z.number().optional().describe("Max number of links to follow per page"),
+  limit: zod.z.number().optional().describe("Total number of links the mapper will process before stopping"),
+  instructions: zod.z.string().optional().describe("Natural language instructions for the mapper"),
+  selectPaths: zod.z.array(zod.z.string()).optional().describe("Regex patterns to select specific URL paths"),
+  selectDomains: zod.z.array(zod.z.string()).optional().describe("Regex patterns to restrict to specific domains"),
+  excludePaths: zod.z.array(zod.z.string()).optional().describe("Regex patterns to exclude specific URL paths"),
+  excludeDomains: zod.z.array(zod.z.string()).optional().describe("Regex patterns to exclude specific domains"),
+  allowExternal: zod.z.boolean().optional().describe("Whether to include external domain links")
+});
+var outputSchema4 = zod.z.object({
+  baseUrl: zod.z.string(),
+  results: zod.z.array(zod.z.string()).describe("Discovered URLs"),
+  responseTime: zod.z.number()
+});
+function createTavilyMapTool(config) {
+  let client = null;
+  function getClient() {
+    if (!client) {
+      client = getTavilyClient(config);
+    }
+    return client;
+  }
+  return tools.createTool({
+    id: "tavily-map",
+    description: "Map a website's structure starting from a URL using Tavily. Discovers and returns a list of URLs found on the site without extracting page content. Useful for understanding site structure before targeted extraction.",
+    inputSchema: inputSchema4,
+    outputSchema: outputSchema4,
+    execute: async (input) => {
+      const tavilyClient = getClient();
+      const response = await tavilyClient.map(input.url, {
+        maxDepth: input.maxDepth,
+        maxBreadth: input.maxBreadth,
+        limit: input.limit,
+        instructions: input.instructions,
+        selectPaths: input.selectPaths,
+        selectDomains: input.selectDomains,
+        excludePaths: input.excludePaths,
+        excludeDomains: input.excludeDomains,
+        allowExternal: input.allowExternal
+      });
+      return {
+        baseUrl: response.baseUrl,
+        results: response.results || [],
+        responseTime: response.responseTime
+      };
+    }
+  });
+}
+
+// src/tools.ts
+function createTavilyTools(config) {
+  return {
+    tavilySearch: createTavilySearchTool(config),
+    tavilyExtract: createTavilyExtractTool(config),
+    tavilyCrawl: createTavilyCrawlTool(config),
+    tavilyMap: createTavilyMapTool(config)
+  };
+}
+
+exports.createTavilyCrawlTool = createTavilyCrawlTool;
+exports.createTavilyExtractTool = createTavilyExtractTool;
+exports.createTavilyMapTool = createTavilyMapTool;
+exports.createTavilySearchTool = createTavilySearchTool;
+exports.createTavilyTools = createTavilyTools;
+exports.getTavilyClient = getTavilyClient;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/search.ts","../src/extract.ts","../src/crawl.ts","../src/map.ts","../src/tools.ts"],"names":["tavily","z","createTool","inputSchema","outputSchema"],"mappings":";;;;;;;AAOO,SAAS,gBAAgB,MAAA,EAA4C;AAC1E,EAAA,MAAM,MAAA,GAAS,MAAA,EAAQ,MAAA,IAAU,OAAA,CAAQ,GAAA,CAAI,cAAA;AAC7C,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,MAAM,IAAI,MAAM,4EAA4E,CAAA;AAAA,EAC9F;AAEA,EAAA,OAAOA,WAAA,CAAO,EAAE,GAAG,MAAA,EAAQ,QAAQ,YAAA,EAAc,MAAA,EAAQ,YAAA,IAAgB,QAAA,EAAU,CAAA;AACrF;ACRA,IAAM,WAAA,GAAcC,MAAE,MAAA,CAAO;AAAA,EAC3B,KAAA,EAAOA,KAAA,CAAE,MAAA,EAAO,CAAE,SAAS,kBAAkB,CAAA;AAAA,EAC7C,WAAA,EAAaA,KAAA,CACV,IAAA,CAAK,CAAC,OAAA,EAAS,UAAA,EAAY,MAAA,EAAQ,YAAY,CAAC,CAAA,CAChD,QAAA,EAAS,CACT,SAAS,wGAAmG,CAAA;AAAA,EAC/G,UAAA,EAAYA,KAAA,CAAE,MAAA,EAAO,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,GAAA,CAAI,EAAE,CAAA,CAAE,QAAA,EAAS,CAAE,SAAS,4CAA4C,CAAA;AAAA,EACtG,eAAeA,KAAA,CACZ,KAAA,CAAM,CAACA,KAAA,CAAE,OAAA,IAAWA,KAAA,CAAE,IAAA,CAAK,CAAC,OAAA,EAAS,UAAU,CAAC,CAAC,CAAC,EAClD,QAAA,EAAS,CACT,SAAS,2EAA2E,CAAA;AAAA,EACvF,eAAeA,KAAA,CAAE,OAAA,GAAU,QAAA,EAAS,CAAE,SAAS,8CAA8C,CAAA;AAAA,EAC7F,0BAA0BA,KAAA,CAAE,OAAA,GAAU,QAAA,EAAS,CAAE,SAAS,0CAA0C,CAAA;AAAA,EACpG,iBAAA,EAAmBA,MAChB,KAAA,CAAM,CAACA,MAAE,OAAA,CAAQ,KAAK,GAAGA,KAAA,CAAE,IAAA,CAAK,CAAC,UAAA,EAAY,MAAM,CAAC,CAAC,CAAC,EACtD,QAAA,EAAS,CACT,SAAS,qGAAqG,CAAA;AAAA,EACjH,cAAA,EAAgBA,KAAA,CAAE,KAAA,CAAMA,KAAA,CAAE,MAAA,EAAQ,CAAA,CAAE,QAAA,EAAS,CAAE,QAAA,CAAS,mCAAmC,CAAA;AAAA,EAC3F,cAAA,EAAgBA,KAAA,CAAE,KAAA,CAAMA,KAAA,CAAE,MAAA,EAAQ,CAAA,CAAE,QAAA,EAAS,CAAE,QAAA,CAAS,oCAAoC,CAAA;AAAA,EAC5F,SAAA,EAAWA,KAAA,CACR,IAAA,CAAK,CAAC,KAAA,EAAO,MAAA,EAAQ,OAAA,EAAS,MAAM,CAAC,CAAA,CACrC,QAAA,EAAS,CACT,SAAS,yCAAyC;AACvD,CAAC,CAAA;AAED,IAAM,YAAA,GAAeA,MAAE,MAAA,CAAO;AAAA,EAC5B,KAAA,EAAOA,MAAE,MAAA,EAAO;AAAA,EAChB,MAAA,EAAQA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA,EAAS;AAAA,EAC5B,QAAQA,KAAA,CACL,KAAA;AAAA,IACCA,MAAE,MAAA,CAAO;AAAA,MACP,GAAA,EAAKA,MAAE,MAAA,EAAO;AAAA,MACd,WAAA,EAAaA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AAAS,KAClC;AAAA,IAEF,QAAA,EAAS;AAAA,EACZ,SAASA,KAAA,CAAE,KAAA;AAAA,IACTA,MAAE,MAAA,CAAO;AAAA,MACP,KAAA,EAAOA,MAAE,MAAA,EAAO;AAAA,MAChB,GAAA,EAAKA,MAAE,MAAA,EAAO;AAAA,MACd,OAAA,EAASA,MAAE,MAAA,EAAO;AAAA,MAClB,KAAA,EAAOA,MAAE,MAAA,EAAO;AAAA,MAChB,UAAA,EAAYA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AAAS,KACjC;AAAA,GACH;AAAA,EACA,YAAA,EAAcA,MAAE,MAAA;AAClB,CAAC,CAAA;AAEM,SAAS,uBAAuB,MAAA,EAA8B;AACnE,EAAA,IAAI,MAAA,GAA8B,IAAA;AAElC,EAAA,SAAS,SAAA,GAA0B;AACjC,IAAA,IAAI,CAAC,MAAA,EAAQ;AACX,MAAA,MAAA,GAAS,gBAAgB,MAAM,CAAA;AAAA,IACjC;AACA,IAAA,OAAO,MAAA;AAAA,EACT;AAEA,EAAA,OAAOC,gBAAA,CAAW;AAAA,IAChB,EAAA,EAAI,eAAA;AAAA,IACJ,WAAA,EACE,qLAAA;AAAA,IACF,WAAA;AAAA,IACA,YAAA;AAAA,IACA,OAAA,EAAS,OAAM,KAAA,KAAS;AACtB,MAAA,MAAM,eAAe,SAAA,EAAU;AAE/B,MAAA,MAAM,QAAA,GAAW,MAAM,YAAA,CAAa,MAAA,CAAO,MAAM,KAAA,EAAO;AAAA,QACtD,aAAa,KAAA,CAAM,WAAA;AAAA,QACnB,YAAY,KAAA,CAAM,UAAA;AAAA,QAClB,eAAe,KAAA,CAAM,aAAA;AAAA,QACrB,eAAe,KAAA,CAAM,aAAA;AAAA,QACrB,0BAA0B,KAAA,CAAM,wBAAA;AAAA,QAChC,mBAAmB,KAAA,CAAM,iBAAA;AAAA,QACzB,gBAAgB,KAAA,CAAM,cAAA;AAAA,QACtB,gBAAgB,KAAA,CAAM,cAAA;AAAA,QACtB,WAAW,KAAA,CAAM;AAAA,OAClB,CAAA;AAED,MAAA,OAAO;AAAA,QACL,OAAO,QAAA,CAAS,KAAA;AAAA,QAChB,MAAA,EAAQ,SAAS,MAAA,IAAU,MAAA;AAAA,QAC3B,MAAA,EAAQ,QAAA,CAAS,MAAA,EAAQ,GAAA,CAAI,CAAC,GAAA,MAAc;AAAA,UAC1C,GAAA,EAAK,OAAO,GAAA,KAAQ,QAAA,GAAW,MAAM,GAAA,CAAI,GAAA;AAAA,UACzC,WAAA,EAAa,OAAO,GAAA,KAAQ,QAAA,GAAW,SAAY,GAAA,CAAI;AAAA,SACzD,CAAE,CAAA;AAAA,QACF,UAAU,QAAA,CAAS,OAAA,IAAW,EAAC,EAAG,GAAA,CAAI,CAAC,CAAA,MAAY;AAAA,UACjD,OAAO,CAAA,CAAE,KAAA;AAAA,UACT,KAAK,CAAA,CAAE,GAAA;AAAA,UACP,SAAS,CAAA,CAAE,OAAA;AAAA,UACX,KAAA,EAAO,EAAE,KAAA,IAAS,CAAA;AAAA,UAClB,UAAA,EAAY,EAAE,UAAA,IAAc;AAAA,SAC9B,CAAE,CAAA;AAAA,QACF,cAAc,QAAA,CAAS;AAAA,OACzB;AAAA,IACF;AAAA,GACD,CAAA;AACH;ACjGA,IAAMC,YAAAA,GAAcF,MAAE,MAAA,CAAO;AAAA,EAC3B,IAAA,EAAMA,KAAAA,CAAE,KAAA,CAAMA,KAAAA,CAAE,QAAQ,CAAA,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,GAAA,CAAI,EAAE,CAAA,CAAE,SAAS,qCAAqC,CAAA;AAAA,EACvF,YAAA,EAAcA,KAAAA,CACX,IAAA,CAAK,CAAC,OAAA,EAAS,UAAU,CAAC,CAAA,CAC1B,QAAA,EAAS,CACT,QAAA,CAAS,8FAAyF,CAAA;AAAA,EACrG,OAAOA,KAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,SAAS,0HAA0H,CAAA;AAAA,EAChK,eAAeA,KAAAA,CAAE,OAAA,GAAU,QAAA,EAAS,CAAE,SAAS,yCAAyC,CAAA;AAAA,EACxF,MAAA,EAAQA,KAAAA,CACL,IAAA,CAAK,CAAC,UAAA,EAAY,MAAM,CAAC,CAAA,CACzB,QAAA,EAAS,CACT,QAAA,CAAS,2EAAsE;AACpF,CAAC,CAAA;AAED,IAAMG,aAAAA,GAAeH,MAAE,MAAA,CAAO;AAAA,EAC5B,SAASA,KAAAA,CAAE,KAAA;AAAA,IACTA,MAAE,MAAA,CAAO;AAAA,MACP,GAAA,EAAKA,MAAE,MAAA,EAAO;AAAA,MACd,UAAA,EAAYA,MAAE,MAAA,EAAO;AAAA,MACrB,QAAQA,KAAAA,CAAE,KAAA,CAAMA,MAAE,MAAA,EAAQ,EAAE,QAAA;AAAS,KACtC;AAAA,GACH;AAAA,EACA,eAAeA,KAAAA,CAAE,KAAA;AAAA,IACfA,MAAE,MAAA,CAAO;AAAA,MACP,GAAA,EAAKA,MAAE,MAAA,EAAO;AAAA,MACd,KAAA,EAAOA,MAAE,MAAA;AAAO,KACjB;AAAA,GACH;AAAA,EACA,YAAA,EAAcA,MAAE,MAAA;AAClB,CAAC,CAAA;AAEM,SAAS,wBAAwB,MAAA,EAA8B;AACpE,EAAA,IAAI,MAAA,GAA8B,IAAA;AAElC,EAAA,SAAS,SAAA,GAA0B;AACjC,IAAA,IAAI,CAAC,MAAA,EAAQ;AACX,MAAA,MAAA,GAAS,gBAAgB,MAAM,CAAA;AAAA,IACjC;AACA,IAAA,OAAO,MAAA;AAAA,EACT;AAEA,EAAA,OAAOC,gBAAAA,CAAW;AAAA,IAChB,EAAA,EAAI,gBAAA;AAAA,IACJ,WAAA,EACE,sLAAA;AAAA,IACF,WAAA,EAAAC,YAAAA;AAAA,IACA,YAAA,EAAAC,aAAAA;AAAA,IACA,OAAA,EAAS,OAAM,KAAA,KAAS;AACtB,MAAA,MAAM,eAAe,SAAA,EAAU;AAE/B,MAAA,MAAM,QAAA,GAAW,MAAM,YAAA,CAAa,OAAA,CAAQ,MAAM,IAAA,EAAM;AAAA,QACtD,cAAc,KAAA,CAAM,YAAA;AAAA,QACpB,OAAO,KAAA,CAAM,KAAA;AAAA,QACb,eAAe,KAAA,CAAM,aAAA;AAAA,QACrB,QAAQ,KAAA,CAAM;AAAA,OACf,CAAA;AAED,MAAA,OAAO;AAAA,QACL,UAAW,QAAA,CAAS,OAAA,IAAW,EAAC,EAAa,IAAI,CAAA,CAAA,MAAM;AAAA,UACrD,KAAK,CAAA,CAAE,GAAA;AAAA,UACP,YAAY,CAAA,CAAE,UAAA;AAAA,UACd,MAAA,EAAQ,EAAE,MAAA,IAAU;AAAA,SACtB,CAAE,CAAA;AAAA,QACF,gBAAiB,QAAA,CAAS,aAAA,IAAiB,EAAC,EAAa,IAAI,CAAA,CAAA,MAAM;AAAA,UACjE,KAAK,CAAA,CAAE,GAAA;AAAA,UACP,OAAO,CAAA,CAAE;AAAA,SACX,CAAE,CAAA;AAAA,QACF,cAAc,QAAA,CAAS;AAAA,OACzB;AAAA,IACF;AAAA,GACD,CAAA;AACH;ACvEA,IAAMD,YAAAA,GAAcF,MAAE,MAAA,CAAO;AAAA,EAC3B,GAAA,EAAKA,KAAAA,CAAE,MAAA,EAAO,CAAE,SAAS,iCAAiC,CAAA;AAAA,EAC1D,UAAUA,KAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,SAAS,0CAA0C,CAAA;AAAA,EACnF,YAAYA,KAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,SAAS,wCAAwC,CAAA;AAAA,EACnF,OAAOA,KAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,SAAS,gEAAgE,CAAA;AAAA,EACtG,cAAcA,KAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,SAAS,+CAA+C,CAAA;AAAA,EAC5F,WAAA,EAAaA,KAAAA,CAAE,KAAA,CAAMA,KAAAA,CAAE,MAAA,EAAQ,CAAA,CAAE,QAAA,EAAS,CAAE,QAAA,CAAS,6CAA6C,CAAA;AAAA,EAClG,aAAA,EAAeA,KAAAA,CAAE,KAAA,CAAMA,KAAAA,CAAE,MAAA,EAAQ,CAAA,CAAE,QAAA,EAAS,CAAE,QAAA,CAAS,gDAAgD,CAAA;AAAA,EACvG,YAAA,EAAcA,KAAAA,CAAE,KAAA,CAAMA,KAAAA,CAAE,MAAA,EAAQ,CAAA,CAAE,QAAA,EAAS,CAAE,QAAA,CAAS,8CAA8C,CAAA;AAAA,EACpG,cAAA,EAAgBA,KAAAA,CAAE,KAAA,CAAMA,KAAAA,CAAE,MAAA,EAAQ,CAAA,CAAE,QAAA,EAAS,CAAE,QAAA,CAAS,4CAA4C,CAAA;AAAA,EACpG,eAAeA,KAAAA,CAAE,OAAA,GAAU,QAAA,EAAS,CAAE,SAAS,6CAA6C,CAAA;AAAA,EAC5F,YAAA,EAAcA,KAAAA,CACX,IAAA,CAAK,CAAC,OAAA,EAAS,UAAU,CAAC,CAAA,CAC1B,QAAA,EAAS,CACT,QAAA,CAAS,8FAAyF,CAAA;AAAA,EACrG,eAAeA,KAAAA,CAAE,OAAA,GAAU,QAAA,EAAS,CAAE,SAAS,mCAAmC,CAAA;AAAA,EAClF,MAAA,EAAQA,KAAAA,CACL,IAAA,CAAK,CAAC,UAAA,EAAY,MAAM,CAAC,CAAA,CACzB,QAAA,EAAS,CACT,QAAA,CAAS,2EAAsE;AACpF,CAAC,CAAA;AAED,IAAMG,aAAAA,GAAeH,MAAE,MAAA,CAAO;AAAA,EAC5B,OAAA,EAASA,MAAE,MAAA,EAAO;AAAA,EAClB,SAASA,KAAAA,CAAE,KAAA;AAAA,IACTA,MAAE,MAAA,CAAO;AAAA,MACP,GAAA,EAAKA,MAAE,MAAA,EAAO;AAAA,MACd,UAAA,EAAYA,MAAE,MAAA,EAAO;AAAA,MACrB,QAAQA,KAAAA,CAAE,KAAA,CAAMA,MAAE,MAAA,EAAQ,EAAE,QAAA;AAAS,KACtC;AAAA,GACH;AAAA,EACA,YAAA,EAAcA,MAAE,MAAA;AAClB,CAAC,CAAA;AAEM,SAAS,sBAAsB,MAAA,EAA8B;AAClE,EAAA,IAAI,MAAA,GAA8B,IAAA;AAElC,EAAA,SAAS,SAAA,GAA0B;AACjC,IAAA,IAAI,CAAC,MAAA,EAAQ;AACX,MAAA,MAAA,GAAS,gBAAgB,MAAM,CAAA;AAAA,IACjC;AACA,IAAA,OAAO,MAAA;AAAA,EACT;AAEA,EAAA,OAAOC,gBAAAA,CAAW;AAAA,IAChB,EAAA,EAAI,cAAA;AAAA,IACJ,WAAA,EACE,uMAAA;AAAA,IACF,WAAA,EAAAC,YAAAA;AAAA,IACA,YAAA,EAAAC,aAAAA;AAAA,IACA,OAAA,EAAS,OAAM,KAAA,KAAS;AACtB,MAAA,MAAM,eAAe,SAAA,EAAU;AAE/B,MAAA,MAAM,QAAA,GAAW,MAAM,YAAA,CAAa,KAAA,CAAM,MAAM,GAAA,EAAK;AAAA,QACnD,UAAU,KAAA,CAAM,QAAA;AAAA,QAChB,YAAY,KAAA,CAAM,UAAA;AAAA,QAClB,OAAO,KAAA,CAAM,KAAA;AAAA,QACb,cAAc,KAAA,CAAM,YAAA;AAAA,QACpB,aAAa,KAAA,CAAM,WAAA;AAAA,QACnB,eAAe,KAAA,CAAM,aAAA;AAAA,QACrB,cAAc,KAAA,CAAM,YAAA;AAAA,QACpB,gBAAgB,KAAA,CAAM,cAAA;AAAA,QACtB,eAAe,KAAA,CAAM,aAAA;AAAA,QACrB,cAAc,KAAA,CAAM,YAAA;AAAA,QACpB,eAAe,KAAA,CAAM,aAAA;AAAA,QACrB,QAAQ,KAAA,CAAM;AAAA,OACf,CAAA;AAED,MAAA,OAAO;AAAA,QACL,SAAS,QAAA,CAAS,OAAA;AAAA,QAClB,UAAW,QAAA,CAAS,OAAA,IAAW,EAAC,EAAa,IAAI,CAAA,CAAA,MAAM;AAAA,UACrD,KAAK,CAAA,CAAE,GAAA;AAAA,UACP,YAAY,CAAA,CAAE,UAAA;AAAA,UACd,MAAA,EAAQ,EAAE,MAAA,IAAU;AAAA,SACtB,CAAE,CAAA;AAAA,QACF,cAAc,QAAA,CAAS;AAAA,OACzB;AAAA,IACF;AAAA,GACD,CAAA;AACH;AC/EA,IAAMD,YAAAA,GAAcF,MAAE,MAAA,CAAO;AAAA,EAC3B,GAAA,EAAKA,KAAAA,CAAE,MAAA,EAAO,CAAE,SAAS,+BAA+B,CAAA;AAAA,EACxD,UAAUA,KAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,SAAS,4CAA4C,CAAA;AAAA,EACrF,YAAYA,KAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,SAAS,wCAAwC,CAAA;AAAA,EACnF,OAAOA,KAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,SAAS,+DAA+D,CAAA;AAAA,EACrG,cAAcA,KAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,SAAS,8CAA8C,CAAA;AAAA,EAC3F,WAAA,EAAaA,KAAAA,CAAE,KAAA,CAAMA,KAAAA,CAAE,MAAA,EAAQ,CAAA,CAAE,QAAA,EAAS,CAAE,QAAA,CAAS,6CAA6C,CAAA;AAAA,EAClG,aAAA,EAAeA,KAAAA,CAAE,KAAA,CAAMA,KAAAA,CAAE,MAAA,EAAQ,CAAA,CAAE,QAAA,EAAS,CAAE,QAAA,CAAS,gDAAgD,CAAA;AAAA,EACvG,YAAA,EAAcA,KAAAA,CAAE,KAAA,CAAMA,KAAAA,CAAE,MAAA,EAAQ,CAAA,CAAE,QAAA,EAAS,CAAE,QAAA,CAAS,8CAA8C,CAAA;AAAA,EACpG,cAAA,EAAgBA,KAAAA,CAAE,KAAA,CAAMA,KAAAA,CAAE,MAAA,EAAQ,CAAA,CAAE,QAAA,EAAS,CAAE,QAAA,CAAS,4CAA4C,CAAA;AAAA,EACpG,eAAeA,KAAAA,CAAE,OAAA,GAAU,QAAA,EAAS,CAAE,SAAS,0CAA0C;AAC3F,CAAC,CAAA;AAED,IAAMG,aAAAA,GAAeH,MAAE,MAAA,CAAO;AAAA,EAC5B,OAAA,EAASA,MAAE,MAAA,EAAO;AAAA,EAClB,OAAA,EAASA,MAAE,KAAA,CAAMA,KAAAA,CAAE,QAAQ,CAAA,CAAE,SAAS,iBAAiB,CAAA;AAAA,EACvD,YAAA,EAAcA,MAAE,MAAA;AAClB,CAAC,CAAA;AAEM,SAAS,oBAAoB,MAAA,EAA8B;AAChE,EAAA,IAAI,MAAA,GAA8B,IAAA;AAElC,EAAA,SAAS,SAAA,GAA0B;AACjC,IAAA,IAAI,CAAC,MAAA,EAAQ;AACX,MAAA,MAAA,GAAS,gBAAgB,MAAM,CAAA;AAAA,IACjC;AACA,IAAA,OAAO,MAAA;AAAA,EACT;AAEA,EAAA,OAAOC,gBAAAA,CAAW;AAAA,IAChB,EAAA,EAAI,YAAA;AAAA,IACJ,WAAA,EACE,yNAAA;AAAA,IACF,WAAA,EAAAC,YAAAA;AAAA,IACA,YAAA,EAAAC,aAAAA;AAAA,IACA,OAAA,EAAS,OAAM,KAAA,KAAS;AACtB,MAAA,MAAM,eAAe,SAAA,EAAU;AAE/B,MAAA,MAAM,QAAA,GAAW,MAAM,YAAA,CAAa,GAAA,CAAI,MAAM,GAAA,EAAK;AAAA,QACjD,UAAU,KAAA,CAAM,QAAA;AAAA,QAChB,YAAY,KAAA,CAAM,UAAA;AAAA,QAClB,OAAO,KAAA,CAAM,KAAA;AAAA,QACb,cAAc,KAAA,CAAM,YAAA;AAAA,QACpB,aAAa,KAAA,CAAM,WAAA;AAAA,QACnB,eAAe,KAAA,CAAM,aAAA;AAAA,QACrB,cAAc,KAAA,CAAM,YAAA;AAAA,QACpB,gBAAgB,KAAA,CAAM,cAAA;AAAA,QACtB,eAAe,KAAA,CAAM;AAAA,OACtB,CAAA;AAED,MAAA,OAAO;AAAA,QACL,SAAS,QAAA,CAAS,OAAA;AAAA,QAClB,OAAA,EAAS,QAAA,CAAS,OAAA,IAAW,EAAC;AAAA,QAC9B,cAAc,QAAA,CAAS;AAAA,OACzB;AAAA,IACF;AAAA,GACD,CAAA;AACH;;;ACzDO,SAAS,kBAAkB,MAAA,EAA8B;AAC9D,EAAA,OAAO;AAAA,IACL,YAAA,EAAc,uBAAuB,MAAM,CAAA;AAAA,IAC3C,aAAA,EAAe,wBAAwB,MAAM,CAAA;AAAA,IAC7C,WAAA,EAAa,sBAAsB,MAAM,CAAA;AAAA,IACzC,SAAA,EAAW,oBAAoB,MAAM;AAAA,GACvC;AACF","file":"index.cjs","sourcesContent":["import { tavily } from '@tavily/core';\nimport type { TavilyClientOptions } from '@tavily/core';\n\nexport type { TavilyClientOptions };\n\nexport type TavilyClient = ReturnType<typeof tavily>;\n\nexport function getTavilyClient(config?: TavilyClientOptions): TavilyClient {\n  const apiKey = config?.apiKey ?? process.env.TAVILY_API_KEY;\n  if (!apiKey) {\n    throw new Error('Tavily API key is required. Pass { apiKey } or set TAVILY_API_KEY env var.');\n  }\n  // defaulting `clientSource` to `mastra` if not provided\n  return tavily({ ...config, apiKey, clientSource: config?.clientSource ?? 'mastra' });\n}\n","import { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\n\nimport { getTavilyClient } from './client.js';\nimport type { TavilyClient, TavilyClientOptions } from './client.js';\n\nconst inputSchema = z.object({\n  query: z.string().describe('The search query'),\n  searchDepth: z\n    .enum(['basic', 'advanced', 'fast', 'ultra-fast'])\n    .optional()\n    .describe(\"Search depth — 'basic' for standard, 'advanced' for thorough, 'fast'/'ultra-fast' for low latency\"),\n  maxResults: z.number().min(1).max(20).optional().describe('Maximum number of results to return (1-20)'),\n  includeAnswer: z\n    .union([z.boolean(), z.enum(['basic', 'advanced'])])\n    .optional()\n    .describe('Include an AI-generated answer summary. Pass true, \"basic\", or \"advanced\"'),\n  includeImages: z.boolean().optional().describe('Include query-related images in the response'),\n  includeImageDescriptions: z.boolean().optional().describe('Include descriptions for returned images'),\n  includeRawContent: z\n    .union([z.literal(false), z.enum(['markdown', 'text'])])\n    .optional()\n    .describe('Include cleaned HTML content of each result. Pass false to disable, or \"markdown\"/\"text\" for format'),\n  includeDomains: z.array(z.string()).optional().describe('Restrict results to these domains'),\n  excludeDomains: z.array(z.string()).optional().describe('Exclude results from these domains'),\n  timeRange: z\n    .enum(['day', 'week', 'month', 'year'])\n    .optional()\n    .describe('Time range to filter results by recency'),\n});\n\nconst outputSchema = z.object({\n  query: z.string(),\n  answer: z.string().optional(),\n  images: z\n    .array(\n      z.object({\n        url: z.string(),\n        description: z.string().optional(),\n      }),\n    )\n    .optional(),\n  results: z.array(\n    z.object({\n      title: z.string(),\n      url: z.string(),\n      content: z.string(),\n      score: z.number(),\n      rawContent: z.string().optional(),\n    }),\n  ),\n  responseTime: z.number(),\n});\n\nexport function createTavilySearchTool(config?: TavilyClientOptions) {\n  let client: TavilyClient | null = null;\n\n  function getClient(): TavilyClient {\n    if (!client) {\n      client = getTavilyClient(config);\n    }\n    return client;\n  }\n\n  return createTool({\n    id: 'tavily-search',\n    description:\n      'Search the web using Tavily. Returns relevant results with content snippets, optional AI-generated answers, and images. Supports filtering by domain, time range, and search depth.',\n    inputSchema,\n    outputSchema,\n    execute: async input => {\n      const tavilyClient = getClient();\n\n      const response = await tavilyClient.search(input.query, {\n        searchDepth: input.searchDepth,\n        maxResults: input.maxResults,\n        includeAnswer: input.includeAnswer,\n        includeImages: input.includeImages,\n        includeImageDescriptions: input.includeImageDescriptions,\n        includeRawContent: input.includeRawContent,\n        includeDomains: input.includeDomains,\n        excludeDomains: input.excludeDomains,\n        timeRange: input.timeRange,\n      });\n\n      return {\n        query: response.query,\n        answer: response.answer || undefined,\n        images: response.images?.map((img: any) => ({\n          url: typeof img === 'string' ? img : img.url,\n          description: typeof img === 'string' ? undefined : img.description,\n        })),\n        results: (response.results ?? []).map((r: any) => ({\n          title: r.title,\n          url: r.url,\n          content: r.content,\n          score: r.score ?? 0,\n          rawContent: r.rawContent || undefined,\n        })),\n        responseTime: response.responseTime,\n      };\n    },\n  });\n}\n","import { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\n\nimport { getTavilyClient } from './client.js';\nimport type { TavilyClient, TavilyClientOptions } from './client.js';\n\nconst inputSchema = z.object({\n  urls: z.array(z.string()).min(1).max(20).describe('URLs to extract content from (1-20)'),\n  extractDepth: z\n    .enum(['basic', 'advanced'])\n    .optional()\n    .describe(\"Extraction depth — 'advanced' retrieves more data including tables and embedded content\"),\n  query: z.string().optional().describe('User intent for reranking extracted content chunks. When provided, chunks are reranked based on relevance to this query.'),\n  includeImages: z.boolean().optional().describe('Include images extracted from the pages'),\n  format: z\n    .enum(['markdown', 'text'])\n    .optional()\n    .describe(\"Output format for extracted content — 'markdown' (default) or 'text'\"),\n});\n\nconst outputSchema = z.object({\n  results: z.array(\n    z.object({\n      url: z.string(),\n      rawContent: z.string(),\n      images: z.array(z.string()).optional(),\n    }),\n  ),\n  failedResults: z.array(\n    z.object({\n      url: z.string(),\n      error: z.string(),\n    }),\n  ),\n  responseTime: z.number(),\n});\n\nexport function createTavilyExtractTool(config?: TavilyClientOptions) {\n  let client: TavilyClient | null = null;\n\n  function getClient(): TavilyClient {\n    if (!client) {\n      client = getTavilyClient(config);\n    }\n    return client;\n  }\n\n  return createTool({\n    id: 'tavily-extract',\n    description:\n      'Extract content from one or more URLs using Tavily. Returns raw page content in markdown or text format. Supports up to 20 URLs per request with basic or advanced extraction depth.',\n    inputSchema,\n    outputSchema,\n    execute: async input => {\n      const tavilyClient = getClient();\n\n      const response = await tavilyClient.extract(input.urls, {\n        extractDepth: input.extractDepth,\n        query: input.query,\n        includeImages: input.includeImages,\n        format: input.format,\n      });\n\n      return {\n        results: ((response.results || []) as any[]).map(r => ({\n          url: r.url,\n          rawContent: r.rawContent,\n          images: r.images || undefined,\n        })),\n        failedResults: ((response.failedResults || []) as any[]).map(r => ({\n          url: r.url,\n          error: r.error,\n        })),\n        responseTime: response.responseTime,\n      };\n    },\n  });\n}\n","import { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\n\nimport { getTavilyClient } from './client.js';\nimport type { TavilyClient, TavilyClientOptions } from './client.js';\n\nconst inputSchema = z.object({\n  url: z.string().describe('The root URL to begin the crawl'),\n  maxDepth: z.number().optional().describe('Max depth of the crawl from the base URL'),\n  maxBreadth: z.number().optional().describe('Max number of links to follow per page'),\n  limit: z.number().optional().describe('Total number of pages the crawler will process before stopping'),\n  instructions: z.string().optional().describe('Natural language instructions for the crawler'),\n  selectPaths: z.array(z.string()).optional().describe('Regex patterns to select specific URL paths'),\n  selectDomains: z.array(z.string()).optional().describe('Regex patterns to restrict to specific domains'),\n  excludePaths: z.array(z.string()).optional().describe('Regex patterns to exclude specific URL paths'),\n  excludeDomains: z.array(z.string()).optional().describe('Regex patterns to exclude specific domains'),\n  allowExternal: z.boolean().optional().describe('Whether to follow links to external domains'),\n  extractDepth: z\n    .enum(['basic', 'advanced'])\n    .optional()\n    .describe(\"Extraction depth — 'advanced' retrieves more data including tables and embedded content\"),\n  includeImages: z.boolean().optional().describe('Include images from crawled pages'),\n  format: z\n    .enum(['markdown', 'text'])\n    .optional()\n    .describe(\"Output format for extracted content — 'markdown' (default) or 'text'\"),\n});\n\nconst outputSchema = z.object({\n  baseUrl: z.string(),\n  results: z.array(\n    z.object({\n      url: z.string(),\n      rawContent: z.string(),\n      images: z.array(z.string()).optional(),\n    }),\n  ),\n  responseTime: z.number(),\n});\n\nexport function createTavilyCrawlTool(config?: TavilyClientOptions) {\n  let client: TavilyClient | null = null;\n\n  function getClient(): TavilyClient {\n    if (!client) {\n      client = getTavilyClient(config);\n    }\n    return client;\n  }\n\n  return createTool({\n    id: 'tavily-crawl',\n    description:\n      'Crawl a website starting from a URL using Tavily. Extracts content from discovered pages with configurable depth, breadth, and domain constraints. Returns structured content from each crawled page.',\n    inputSchema,\n    outputSchema,\n    execute: async input => {\n      const tavilyClient = getClient();\n\n      const response = await tavilyClient.crawl(input.url, {\n        maxDepth: input.maxDepth,\n        maxBreadth: input.maxBreadth,\n        limit: input.limit,\n        instructions: input.instructions,\n        selectPaths: input.selectPaths,\n        selectDomains: input.selectDomains,\n        excludePaths: input.excludePaths,\n        excludeDomains: input.excludeDomains,\n        allowExternal: input.allowExternal,\n        extractDepth: input.extractDepth,\n        includeImages: input.includeImages,\n        format: input.format,\n      });\n\n      return {\n        baseUrl: response.baseUrl,\n        results: ((response.results || []) as any[]).map(r => ({\n          url: r.url,\n          rawContent: r.rawContent,\n          images: r.images || undefined,\n        })),\n        responseTime: response.responseTime,\n      };\n    },\n  });\n}\n","import { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\n\nimport { getTavilyClient } from './client.js';\nimport type { TavilyClient, TavilyClientOptions } from './client.js';\n\nconst inputSchema = z.object({\n  url: z.string().describe('The root URL to begin mapping'),\n  maxDepth: z.number().optional().describe('Max depth of the mapping from the base URL'),\n  maxBreadth: z.number().optional().describe('Max number of links to follow per page'),\n  limit: z.number().optional().describe('Total number of links the mapper will process before stopping'),\n  instructions: z.string().optional().describe('Natural language instructions for the mapper'),\n  selectPaths: z.array(z.string()).optional().describe('Regex patterns to select specific URL paths'),\n  selectDomains: z.array(z.string()).optional().describe('Regex patterns to restrict to specific domains'),\n  excludePaths: z.array(z.string()).optional().describe('Regex patterns to exclude specific URL paths'),\n  excludeDomains: z.array(z.string()).optional().describe('Regex patterns to exclude specific domains'),\n  allowExternal: z.boolean().optional().describe('Whether to include external domain links'),\n});\n\nconst outputSchema = z.object({\n  baseUrl: z.string(),\n  results: z.array(z.string()).describe('Discovered URLs'),\n  responseTime: z.number(),\n});\n\nexport function createTavilyMapTool(config?: TavilyClientOptions) {\n  let client: TavilyClient | null = null;\n\n  function getClient(): TavilyClient {\n    if (!client) {\n      client = getTavilyClient(config);\n    }\n    return client;\n  }\n\n  return createTool({\n    id: 'tavily-map',\n    description:\n      \"Map a website's structure starting from a URL using Tavily. Discovers and returns a list of URLs found on the site without extracting page content. Useful for understanding site structure before targeted extraction.\",\n    inputSchema,\n    outputSchema,\n    execute: async input => {\n      const tavilyClient = getClient();\n\n      const response = await tavilyClient.map(input.url, {\n        maxDepth: input.maxDepth,\n        maxBreadth: input.maxBreadth,\n        limit: input.limit,\n        instructions: input.instructions,\n        selectPaths: input.selectPaths,\n        selectDomains: input.selectDomains,\n        excludePaths: input.excludePaths,\n        excludeDomains: input.excludeDomains,\n        allowExternal: input.allowExternal,\n      });\n\n      return {\n        baseUrl: response.baseUrl,\n        results: response.results || [],\n        responseTime: response.responseTime,\n      };\n    },\n  });\n}\n","import type { TavilyClientOptions } from './client.js';\nimport { createTavilyCrawlTool } from './crawl.js';\nimport { createTavilyExtractTool } from './extract.js';\nimport { createTavilyMapTool } from './map.js';\nimport { createTavilySearchTool } from './search.js';\n\nexport function createTavilyTools(config?: TavilyClientOptions) {\n  return {\n    tavilySearch: createTavilySearchTool(config),\n    tavilyExtract: createTavilyExtractTool(config),\n    tavilyCrawl: createTavilyCrawlTool(config),\n    tavilyMap: createTavilyMapTool(config),\n  };\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { getTavilyClient, type TavilyClientOptions, type TavilyClient } from './client.js';
+export { createTavilySearchTool } from './search.js';
+export { createTavilyExtractTool } from './extract.js';
+export { createTavilyCrawlTool } from './crawl.js';
+export { createTavilyMapTool } from './map.js';
+export { createTavilyTools } from './tools.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,mBAAmB,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,280 @@
+import { tavily } from '@tavily/core';
+import { createTool } from '@mastra/core/tools';
+import { z } from 'zod';
+
+// src/client.ts
+function getTavilyClient(config) {
+  const apiKey = config?.apiKey ?? process.env.TAVILY_API_KEY;
+  if (!apiKey) {
+    throw new Error("Tavily API key is required. Pass { apiKey } or set TAVILY_API_KEY env var.");
+  }
+  return tavily({ ...config, apiKey, clientSource: config?.clientSource ?? "mastra" });
+}
+var inputSchema = z.object({
+  query: z.string().describe("The search query"),
+  searchDepth: z.enum(["basic", "advanced", "fast", "ultra-fast"]).optional().describe("Search depth \u2014 'basic' for standard, 'advanced' for thorough, 'fast'/'ultra-fast' for low latency"),
+  maxResults: z.number().min(1).max(20).optional().describe("Maximum number of results to return (1-20)"),
+  includeAnswer: z.union([z.boolean(), z.enum(["basic", "advanced"])]).optional().describe('Include an AI-generated answer summary. Pass true, "basic", or "advanced"'),
+  includeImages: z.boolean().optional().describe("Include query-related images in the response"),
+  includeImageDescriptions: z.boolean().optional().describe("Include descriptions for returned images"),
+  includeRawContent: z.union([z.literal(false), z.enum(["markdown", "text"])]).optional().describe('Include cleaned HTML content of each result. Pass false to disable, or "markdown"/"text" for format'),
+  includeDomains: z.array(z.string()).optional().describe("Restrict results to these domains"),
+  excludeDomains: z.array(z.string()).optional().describe("Exclude results from these domains"),
+  timeRange: z.enum(["day", "week", "month", "year"]).optional().describe("Time range to filter results by recency")
+});
+var outputSchema = z.object({
+  query: z.string(),
+  answer: z.string().optional(),
+  images: z.array(
+    z.object({
+      url: z.string(),
+      description: z.string().optional()
+    })
+  ).optional(),
+  results: z.array(
+    z.object({
+      title: z.string(),
+      url: z.string(),
+      content: z.string(),
+      score: z.number(),
+      rawContent: z.string().optional()
+    })
+  ),
+  responseTime: z.number()
+});
+function createTavilySearchTool(config) {
+  let client = null;
+  function getClient() {
+    if (!client) {
+      client = getTavilyClient(config);
+    }
+    return client;
+  }
+  return createTool({
+    id: "tavily-search",
+    description: "Search the web using Tavily. Returns relevant results with content snippets, optional AI-generated answers, and images. Supports filtering by domain, time range, and search depth.",
+    inputSchema,
+    outputSchema,
+    execute: async (input) => {
+      const tavilyClient = getClient();
+      const response = await tavilyClient.search(input.query, {
+        searchDepth: input.searchDepth,
+        maxResults: input.maxResults,
+        includeAnswer: input.includeAnswer,
+        includeImages: input.includeImages,
+        includeImageDescriptions: input.includeImageDescriptions,
+        includeRawContent: input.includeRawContent,
+        includeDomains: input.includeDomains,
+        excludeDomains: input.excludeDomains,
+        timeRange: input.timeRange
+      });
+      return {
+        query: response.query,
+        answer: response.answer || void 0,
+        images: response.images?.map((img) => ({
+          url: typeof img === "string" ? img : img.url,
+          description: typeof img === "string" ? void 0 : img.description
+        })),
+        results: (response.results ?? []).map((r) => ({
+          title: r.title,
+          url: r.url,
+          content: r.content,
+          score: r.score ?? 0,
+          rawContent: r.rawContent || void 0
+        })),
+        responseTime: response.responseTime
+      };
+    }
+  });
+}
+var inputSchema2 = z.object({
+  urls: z.array(z.string()).min(1).max(20).describe("URLs to extract content from (1-20)"),
+  extractDepth: z.enum(["basic", "advanced"]).optional().describe("Extraction depth \u2014 'advanced' retrieves more data including tables and embedded content"),
+  query: z.string().optional().describe("User intent for reranking extracted content chunks. When provided, chunks are reranked based on relevance to this query."),
+  includeImages: z.boolean().optional().describe("Include images extracted from the pages"),
+  format: z.enum(["markdown", "text"]).optional().describe("Output format for extracted content \u2014 'markdown' (default) or 'text'")
+});
+var outputSchema2 = z.object({
+  results: z.array(
+    z.object({
+      url: z.string(),
+      rawContent: z.string(),
+      images: z.array(z.string()).optional()
+    })
+  ),
+  failedResults: z.array(
+    z.object({
+      url: z.string(),
+      error: z.string()
+    })
+  ),
+  responseTime: z.number()
+});
+function createTavilyExtractTool(config) {
+  let client = null;
+  function getClient() {
+    if (!client) {
+      client = getTavilyClient(config);
+    }
+    return client;
+  }
+  return createTool({
+    id: "tavily-extract",
+    description: "Extract content from one or more URLs using Tavily. Returns raw page content in markdown or text format. Supports up to 20 URLs per request with basic or advanced extraction depth.",
+    inputSchema: inputSchema2,
+    outputSchema: outputSchema2,
+    execute: async (input) => {
+      const tavilyClient = getClient();
+      const response = await tavilyClient.extract(input.urls, {
+        extractDepth: input.extractDepth,
+        query: input.query,
+        includeImages: input.includeImages,
+        format: input.format
+      });
+      return {
+        results: (response.results || []).map((r) => ({
+          url: r.url,
+          rawContent: r.rawContent,
+          images: r.images || void 0
+        })),
+        failedResults: (response.failedResults || []).map((r) => ({
+          url: r.url,
+          error: r.error
+        })),
+        responseTime: response.responseTime
+      };
+    }
+  });
+}
+var inputSchema3 = z.object({
+  url: z.string().describe("The root URL to begin the crawl"),
+  maxDepth: z.number().optional().describe("Max depth of the crawl from the base URL"),
+  maxBreadth: z.number().optional().describe("Max number of links to follow per page"),
+  limit: z.number().optional().describe("Total number of pages the crawler will process before stopping"),
+  instructions: z.string().optional().describe("Natural language instructions for the crawler"),
+  selectPaths: z.array(z.string()).optional().describe("Regex patterns to select specific URL paths"),
+  selectDomains: z.array(z.string()).optional().describe("Regex patterns to restrict to specific domains"),
+  excludePaths: z.array(z.string()).optional().describe("Regex patterns to exclude specific URL paths"),
+  excludeDomains: z.array(z.string()).optional().describe("Regex patterns to exclude specific domains"),
+  allowExternal: z.boolean().optional().describe("Whether to follow links to external domains"),
+  extractDepth: z.enum(["basic", "advanced"]).optional().describe("Extraction depth \u2014 'advanced' retrieves more data including tables and embedded content"),
+  includeImages: z.boolean().optional().describe("Include images from crawled pages"),
+  format: z.enum(["markdown", "text"]).optional().describe("Output format for extracted content \u2014 'markdown' (default) or 'text'")
+});
+var outputSchema3 = z.object({
+  baseUrl: z.string(),
+  results: z.array(
+    z.object({
+      url: z.string(),
+      rawContent: z.string(),
+      images: z.array(z.string()).optional()
+    })
+  ),
+  responseTime: z.number()
+});
+function createTavilyCrawlTool(config) {
+  let client = null;
+  function getClient() {
+    if (!client) {
+      client = getTavilyClient(config);
+    }
+    return client;
+  }
+  return createTool({
+    id: "tavily-crawl",
+    description: "Crawl a website starting from a URL using Tavily. Extracts content from discovered pages with configurable depth, breadth, and domain constraints. Returns structured content from each crawled page.",
+    inputSchema: inputSchema3,
+    outputSchema: outputSchema3,
+    execute: async (input) => {
+      const tavilyClient = getClient();
+      const response = await tavilyClient.crawl(input.url, {
+        maxDepth: input.maxDepth,
+        maxBreadth: input.maxBreadth,
+        limit: input.limit,
+        instructions: input.instructions,
+        selectPaths: input.selectPaths,
+        selectDomains: input.selectDomains,
+        excludePaths: input.excludePaths,
+        excludeDomains: input.excludeDomains,
+        allowExternal: input.allowExternal,
+        extractDepth: input.extractDepth,
+        includeImages: input.includeImages,
+        format: input.format
+      });
+      return {
+        baseUrl: response.baseUrl,
+        results: (response.results || []).map((r) => ({
+          url: r.url,
+          rawContent: r.rawContent,
+          images: r.images || void 0
+        })),
+        responseTime: response.responseTime
+      };
+    }
+  });
+}
+var inputSchema4 = z.object({
+  url: z.string().describe("The root URL to begin mapping"),
+  maxDepth: z.number().optional().describe("Max depth of the mapping from the base URL"),
+  maxBreadth: z.number().optional().describe("Max number of links to follow per page"),
+  limit: z.number().optional().describe("Total number of links the mapper will process before stopping"),
+  instructions: z.string().optional().describe("Natural language instructions for the mapper"),
+  selectPaths: z.array(z.string()).optional().describe("Regex patterns to select specific URL paths"),
+  selectDomains: z.array(z.string()).optional().describe("Regex patterns to restrict to specific domains"),
+  excludePaths: z.array(z.string()).optional().describe("Regex patterns to exclude specific URL paths"),
+  excludeDomains: z.array(z.string()).optional().describe("Regex patterns to exclude specific domains"),
+  allowExternal: z.boolean().optional().describe("Whether to include external domain links")
+});
+var outputSchema4 = z.object({
+  baseUrl: z.string(),
+  results: z.array(z.string()).describe("Discovered URLs"),
+  responseTime: z.number()
+});
+function createTavilyMapTool(config) {
+  let client = null;
+  function getClient() {
+    if (!client) {
+      client = getTavilyClient(config);
+    }
+    return client;
+  }
+  return createTool({
+    id: "tavily-map",
+    description: "Map a website's structure starting from a URL using Tavily. Discovers and returns a list of URLs found on the site without extracting page content. Useful for understanding site structure before targeted extraction.",
+    inputSchema: inputSchema4,
+    outputSchema: outputSchema4,
+    execute: async (input) => {
+      const tavilyClient = getClient();
+      const response = await tavilyClient.map(input.url, {
+        maxDepth: input.maxDepth,
+        maxBreadth: input.maxBreadth,
+        limit: input.limit,
+        instructions: input.instructions,
+        selectPaths: input.selectPaths,
+        selectDomains: input.selectDomains,
+        excludePaths: input.excludePaths,
+        excludeDomains: input.excludeDomains,
+        allowExternal: input.allowExternal
+      });
+      return {
+        baseUrl: response.baseUrl,
+        results: response.results || [],
+        responseTime: response.responseTime
+      };
+    }
+  });
+}
+
+// src/tools.ts
+function createTavilyTools(config) {
+  return {
+    tavilySearch: createTavilySearchTool(config),
+    tavilyExtract: createTavilyExtractTool(config),
+    tavilyCrawl: createTavilyCrawlTool(config),
+    tavilyMap: createTavilyMapTool(config)
+  };
+}
+
+export { createTavilyCrawlTool, createTavilyExtractTool, createTavilyMapTool, createTavilySearchTool, createTavilyTools, getTavilyClient };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/search.ts","../src/extract.ts","../src/crawl.ts","../src/map.ts","../src/tools.ts"],"names":["inputSchema","z","outputSchema","createTool"],"mappings":"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","file":"index.js","sourcesContent":["import { tavily } from '@tavily/core';\nimport type { TavilyClientOptions } from '@tavily/core';\n\nexport type { TavilyClientOptions };\n\nexport type TavilyClient = ReturnType<typeof tavily>;\n\nexport function getTavilyClient(config?: TavilyClientOptions): TavilyClient {\n  const apiKey = config?.apiKey ?? process.env.TAVILY_API_KEY;\n  if (!apiKey) {\n    throw new Error('Tavily API key is required. Pass { apiKey } or set TAVILY_API_KEY env var.');\n  }\n  // defaulting `clientSource` to `mastra` if not provided\n  return tavily({ ...config, apiKey, clientSource: config?.clientSource ?? 'mastra' });\n}\n","import { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\n\nimport { getTavilyClient } from './client.js';\nimport type { TavilyClient, TavilyClientOptions } from './client.js';\n\nconst inputSchema = z.object({\n  query: z.string().describe('The search query'),\n  searchDepth: z\n    .enum(['basic', 'advanced', 'fast', 'ultra-fast'])\n    .optional()\n    .describe(\"Search depth — 'basic' for standard, 'advanced' for thorough, 'fast'/'ultra-fast' for low latency\"),\n  maxResults: z.number().min(1).max(20).optional().describe('Maximum number of results to return (1-20)'),\n  includeAnswer: z\n    .union([z.boolean(), z.enum(['basic', 'advanced'])])\n    .optional()\n    .describe('Include an AI-generated answer summary. Pass true, \"basic\", or \"advanced\"'),\n  includeImages: z.boolean().optional().describe('Include query-related images in the response'),\n  includeImageDescriptions: z.boolean().optional().describe('Include descriptions for returned images'),\n  includeRawContent: z\n    .union([z.literal(false), z.enum(['markdown', 'text'])])\n    .optional()\n    .describe('Include cleaned HTML content of each result. Pass false to disable, or \"markdown\"/\"text\" for format'),\n  includeDomains: z.array(z.string()).optional().describe('Restrict results to these domains'),\n  excludeDomains: z.array(z.string()).optional().describe('Exclude results from these domains'),\n  timeRange: z\n    .enum(['day', 'week', 'month', 'year'])\n    .optional()\n    .describe('Time range to filter results by recency'),\n});\n\nconst outputSchema = z.object({\n  query: z.string(),\n  answer: z.string().optional(),\n  images: z\n    .array(\n      z.object({\n        url: z.string(),\n        description: z.string().optional(),\n      }),\n    )\n    .optional(),\n  results: z.array(\n    z.object({\n      title: z.string(),\n      url: z.string(),\n      content: z.string(),\n      score: z.number(),\n      rawContent: z.string().optional(),\n    }),\n  ),\n  responseTime: z.number(),\n});\n\nexport function createTavilySearchTool(config?: TavilyClientOptions) {\n  let client: TavilyClient | null = null;\n\n  function getClient(): TavilyClient {\n    if (!client) {\n      client = getTavilyClient(config);\n    }\n    return client;\n  }\n\n  return createTool({\n    id: 'tavily-search',\n    description:\n      'Search the web using Tavily. Returns relevant results with content snippets, optional AI-generated answers, and images. Supports filtering by domain, time range, and search depth.',\n    inputSchema,\n    outputSchema,\n    execute: async input => {\n      const tavilyClient = getClient();\n\n      const response = await tavilyClient.search(input.query, {\n        searchDepth: input.searchDepth,\n        maxResults: input.maxResults,\n        includeAnswer: input.includeAnswer,\n        includeImages: input.includeImages,\n        includeImageDescriptions: input.includeImageDescriptions,\n        includeRawContent: input.includeRawContent,\n        includeDomains: input.includeDomains,\n        excludeDomains: input.excludeDomains,\n        timeRange: input.timeRange,\n      });\n\n      return {\n        query: response.query,\n        answer: response.answer || undefined,\n        images: response.images?.map((img: any) => ({\n          url: typeof img === 'string' ? img : img.url,\n          description: typeof img === 'string' ? undefined : img.description,\n        })),\n        results: (response.results ?? []).map((r: any) => ({\n          title: r.title,\n          url: r.url,\n          content: r.content,\n          score: r.score ?? 0,\n          rawContent: r.rawContent || undefined,\n        })),\n        responseTime: response.responseTime,\n      };\n    },\n  });\n}\n","import { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\n\nimport { getTavilyClient } from './client.js';\nimport type { TavilyClient, TavilyClientOptions } from './client.js';\n\nconst inputSchema = z.object({\n  urls: z.array(z.string()).min(1).max(20).describe('URLs to extract content from (1-20)'),\n  extractDepth: z\n    .enum(['basic', 'advanced'])\n    .optional()\n    .describe(\"Extraction depth — 'advanced' retrieves more data including tables and embedded content\"),\n  query: z.string().optional().describe('User intent for reranking extracted content chunks. When provided, chunks are reranked based on relevance to this query.'),\n  includeImages: z.boolean().optional().describe('Include images extracted from the pages'),\n  format: z\n    .enum(['markdown', 'text'])\n    .optional()\n    .describe(\"Output format for extracted content — 'markdown' (default) or 'text'\"),\n});\n\nconst outputSchema = z.object({\n  results: z.array(\n    z.object({\n      url: z.string(),\n      rawContent: z.string(),\n      images: z.array(z.string()).optional(),\n    }),\n  ),\n  failedResults: z.array(\n    z.object({\n      url: z.string(),\n      error: z.string(),\n    }),\n  ),\n  responseTime: z.number(),\n});\n\nexport function createTavilyExtractTool(config?: TavilyClientOptions) {\n  let client: TavilyClient | null = null;\n\n  function getClient(): TavilyClient {\n    if (!client) {\n      client = getTavilyClient(config);\n    }\n    return client;\n  }\n\n  return createTool({\n    id: 'tavily-extract',\n    description:\n      'Extract content from one or more URLs using Tavily. Returns raw page content in markdown or text format. Supports up to 20 URLs per request with basic or advanced extraction depth.',\n    inputSchema,\n    outputSchema,\n    execute: async input => {\n      const tavilyClient = getClient();\n\n      const response = await tavilyClient.extract(input.urls, {\n        extractDepth: input.extractDepth,\n        query: input.query,\n        includeImages: input.includeImages,\n        format: input.format,\n      });\n\n      return {\n        results: ((response.results || []) as any[]).map(r => ({\n          url: r.url,\n          rawContent: r.rawContent,\n          images: r.images || undefined,\n        })),\n        failedResults: ((response.failedResults || []) as any[]).map(r => ({\n          url: r.url,\n          error: r.error,\n        })),\n        responseTime: response.responseTime,\n      };\n    },\n  });\n}\n","import { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\n\nimport { getTavilyClient } from './client.js';\nimport type { TavilyClient, TavilyClientOptions } from './client.js';\n\nconst inputSchema = z.object({\n  url: z.string().describe('The root URL to begin the crawl'),\n  maxDepth: z.number().optional().describe('Max depth of the crawl from the base URL'),\n  maxBreadth: z.number().optional().describe('Max number of links to follow per page'),\n  limit: z.number().optional().describe('Total number of pages the crawler will process before stopping'),\n  instructions: z.string().optional().describe('Natural language instructions for the crawler'),\n  selectPaths: z.array(z.string()).optional().describe('Regex patterns to select specific URL paths'),\n  selectDomains: z.array(z.string()).optional().describe('Regex patterns to restrict to specific domains'),\n  excludePaths: z.array(z.string()).optional().describe('Regex patterns to exclude specific URL paths'),\n  excludeDomains: z.array(z.string()).optional().describe('Regex patterns to exclude specific domains'),\n  allowExternal: z.boolean().optional().describe('Whether to follow links to external domains'),\n  extractDepth: z\n    .enum(['basic', 'advanced'])\n    .optional()\n    .describe(\"Extraction depth — 'advanced' retrieves more data including tables and embedded content\"),\n  includeImages: z.boolean().optional().describe('Include images from crawled pages'),\n  format: z\n    .enum(['markdown', 'text'])\n    .optional()\n    .describe(\"Output format for extracted content — 'markdown' (default) or 'text'\"),\n});\n\nconst outputSchema = z.object({\n  baseUrl: z.string(),\n  results: z.array(\n    z.object({\n      url: z.string(),\n      rawContent: z.string(),\n      images: z.array(z.string()).optional(),\n    }),\n  ),\n  responseTime: z.number(),\n});\n\nexport function createTavilyCrawlTool(config?: TavilyClientOptions) {\n  let client: TavilyClient | null = null;\n\n  function getClient(): TavilyClient {\n    if (!client) {\n      client = getTavilyClient(config);\n    }\n    return client;\n  }\n\n  return createTool({\n    id: 'tavily-crawl',\n    description:\n      'Crawl a website starting from a URL using Tavily. Extracts content from discovered pages with configurable depth, breadth, and domain constraints. Returns structured content from each crawled page.',\n    inputSchema,\n    outputSchema,\n    execute: async input => {\n      const tavilyClient = getClient();\n\n      const response = await tavilyClient.crawl(input.url, {\n        maxDepth: input.maxDepth,\n        maxBreadth: input.maxBreadth,\n        limit: input.limit,\n        instructions: input.instructions,\n        selectPaths: input.selectPaths,\n        selectDomains: input.selectDomains,\n        excludePaths: input.excludePaths,\n        excludeDomains: input.excludeDomains,\n        allowExternal: input.allowExternal,\n        extractDepth: input.extractDepth,\n        includeImages: input.includeImages,\n        format: input.format,\n      });\n\n      return {\n        baseUrl: response.baseUrl,\n        results: ((response.results || []) as any[]).map(r => ({\n          url: r.url,\n          rawContent: r.rawContent,\n          images: r.images || undefined,\n        })),\n        responseTime: response.responseTime,\n      };\n    },\n  });\n}\n","import { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\n\nimport { getTavilyClient } from './client.js';\nimport type { TavilyClient, TavilyClientOptions } from './client.js';\n\nconst inputSchema = z.object({\n  url: z.string().describe('The root URL to begin mapping'),\n  maxDepth: z.number().optional().describe('Max depth of the mapping from the base URL'),\n  maxBreadth: z.number().optional().describe('Max number of links to follow per page'),\n  limit: z.number().optional().describe('Total number of links the mapper will process before stopping'),\n  instructions: z.string().optional().describe('Natural language instructions for the mapper'),\n  selectPaths: z.array(z.string()).optional().describe('Regex patterns to select specific URL paths'),\n  selectDomains: z.array(z.string()).optional().describe('Regex patterns to restrict to specific domains'),\n  excludePaths: z.array(z.string()).optional().describe('Regex patterns to exclude specific URL paths'),\n  excludeDomains: z.array(z.string()).optional().describe('Regex patterns to exclude specific domains'),\n  allowExternal: z.boolean().optional().describe('Whether to include external domain links'),\n});\n\nconst outputSchema = z.object({\n  baseUrl: z.string(),\n  results: z.array(z.string()).describe('Discovered URLs'),\n  responseTime: z.number(),\n});\n\nexport function createTavilyMapTool(config?: TavilyClientOptions) {\n  let client: TavilyClient | null = null;\n\n  function getClient(): TavilyClient {\n    if (!client) {\n      client = getTavilyClient(config);\n    }\n    return client;\n  }\n\n  return createTool({\n    id: 'tavily-map',\n    description:\n      \"Map a website's structure starting from a URL using Tavily. Discovers and returns a list of URLs found on the site without extracting page content. Useful for understanding site structure before targeted extraction.\",\n    inputSchema,\n    outputSchema,\n    execute: async input => {\n      const tavilyClient = getClient();\n\n      const response = await tavilyClient.map(input.url, {\n        maxDepth: input.maxDepth,\n        maxBreadth: input.maxBreadth,\n        limit: input.limit,\n        instructions: input.instructions,\n        selectPaths: input.selectPaths,\n        selectDomains: input.selectDomains,\n        excludePaths: input.excludePaths,\n        excludeDomains: input.excludeDomains,\n        allowExternal: input.allowExternal,\n      });\n\n      return {\n        baseUrl: response.baseUrl,\n        results: response.results || [],\n        responseTime: response.responseTime,\n      };\n    },\n  });\n}\n","import type { TavilyClientOptions } from './client.js';\nimport { createTavilyCrawlTool } from './crawl.js';\nimport { createTavilyExtractTool } from './extract.js';\nimport { createTavilyMapTool } from './map.js';\nimport { createTavilySearchTool } from './search.js';\n\nexport function createTavilyTools(config?: TavilyClientOptions) {\n  return {\n    tavilySearch: createTavilySearchTool(config),\n    tavilyExtract: createTavilyExtractTool(config),\n    tavilyCrawl: createTavilyCrawlTool(config),\n    tavilyMap: createTavilyMapTool(config),\n  };\n}\n"]}

package/dist/map.d.ts

@@ -0,0 +1,18 @@
+import type { TavilyClientOptions } from './client.js';
+export declare function createTavilyMapTool(config?: TavilyClientOptions): import("@mastra/core/tools").Tool<{
+    url: string;
+    maxDepth?: number | undefined;
+    maxBreadth?: number | undefined;
+    limit?: number | undefined;
+    instructions?: string | undefined;
+    selectPaths?: string[] | undefined;
+    selectDomains?: string[] | undefined;
+    excludePaths?: string[] | undefined;
+    excludeDomains?: string[] | undefined;
+    allowExternal?: boolean | undefined;
+}, {
+    baseUrl: string;
+    results: string[];
+    responseTime: number;
+}, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "tavily-map", unknown>;
+//# sourceMappingURL=map.d.ts.map

package/dist/map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../src/map.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAgB,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAqBrE,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,mBAAmB;;;;;;;;;;;;;;;0HAsC/D"}

package/dist/search.d.ts

@@ -0,0 +1,29 @@
+import type { TavilyClientOptions } from './client.js';
+export declare function createTavilySearchTool(config?: TavilyClientOptions): import("@mastra/core/tools").Tool<{
+    query: string;
+    searchDepth?: "basic" | "advanced" | "fast" | "ultra-fast" | undefined;
+    maxResults?: number | undefined;
+    includeAnswer?: boolean | "basic" | "advanced" | undefined;
+    includeImages?: boolean | undefined;
+    includeImageDescriptions?: boolean | undefined;
+    includeRawContent?: false | "markdown" | "text" | undefined;
+    includeDomains?: string[] | undefined;
+    excludeDomains?: string[] | undefined;
+    timeRange?: "day" | "week" | "month" | "year" | undefined;
+}, {
+    query: string;
+    results: {
+        title: string;
+        url: string;
+        content: string;
+        score: number;
+        rawContent?: string | undefined;
+    }[];
+    responseTime: number;
+    answer?: string | undefined;
+    images?: {
+        url: string;
+        description?: string | undefined;
+    }[] | undefined;
+}, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "tavily-search", unknown>;
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAgB,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAkDrE,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;6HAiDlE"}

package/dist/tools.d.ts

@@ -0,0 +1,88 @@
+import type { TavilyClientOptions } from './client.js';
+export declare function createTavilyTools(config?: TavilyClientOptions): {
+    tavilySearch: import("@mastra/core/tools").Tool<{
+        query: string;
+        searchDepth?: "basic" | "advanced" | "fast" | "ultra-fast" | undefined;
+        maxResults?: number | undefined;
+        includeAnswer?: boolean | "basic" | "advanced" | undefined;
+        includeImages?: boolean | undefined;
+        includeImageDescriptions?: boolean | undefined;
+        includeRawContent?: false | "markdown" | "text" | undefined;
+        includeDomains?: string[] | undefined;
+        excludeDomains?: string[] | undefined;
+        timeRange?: "day" | "week" | "month" | "year" | undefined;
+    }, {
+        query: string;
+        results: {
+            title: string;
+            url: string;
+            content: string;
+            score: number;
+            rawContent?: string | undefined;
+        }[];
+        responseTime: number;
+        answer?: string | undefined;
+        images?: {
+            url: string;
+            description?: string | undefined;
+        }[] | undefined;
+    }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "tavily-search", unknown>;
+    tavilyExtract: import("@mastra/core/tools").Tool<{
+        urls: string[];
+        extractDepth?: "basic" | "advanced" | undefined;
+        query?: string | undefined;
+        includeImages?: boolean | undefined;
+        format?: "markdown" | "text" | undefined;
+    }, {
+        results: {
+            url: string;
+            rawContent: string;
+            images?: string[] | undefined;
+        }[];
+        failedResults: {
+            url: string;
+            error: string;
+        }[];
+        responseTime: number;
+    }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "tavily-extract", unknown>;
+    tavilyCrawl: import("@mastra/core/tools").Tool<{
+        url: string;
+        maxDepth?: number | undefined;
+        maxBreadth?: number | undefined;
+        limit?: number | undefined;
+        instructions?: string | undefined;
+        selectPaths?: string[] | undefined;
+        selectDomains?: string[] | undefined;
+        excludePaths?: string[] | undefined;
+        excludeDomains?: string[] | undefined;
+        allowExternal?: boolean | undefined;
+        extractDepth?: "basic" | "advanced" | undefined;
+        includeImages?: boolean | undefined;
+        format?: "markdown" | "text" | undefined;
+    }, {
+        baseUrl: string;
+        results: {
+            url: string;
+            rawContent: string;
+            images?: string[] | undefined;
+        }[];
+        responseTime: number;
+    }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "tavily-crawl", unknown>;
+    tavilyMap: import("@mastra/core/tools").Tool<{
+        url: string;
+        maxDepth?: number | undefined;
+        maxBreadth?: number | undefined;
+        limit?: number | undefined;
+        instructions?: string | undefined;
+        selectPaths?: string[] | undefined;
+        selectDomains?: string[] | undefined;
+        excludePaths?: string[] | undefined;
+        excludeDomains?: string[] | undefined;
+        allowExternal?: boolean | undefined;
+    }, {
+        baseUrl: string;
+        results: string[];
+        responseTime: number;
+    }, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "tavily-map", unknown>;
+};
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAMvD,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAO7D"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@mastra/tavily",
+  "version": "0.0.1",
+  "description": "Tavily web search, extract, crawl, and map tools for Mastra agents",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build:lib": "tsup --silent --config tsup.config.ts",
+    "build:watch": "pnpm build:lib --watch",
+    "lint": "eslint .",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "mastra",
+    "tavily",
+    "web-search",
+    "tools",
+    "ai-agent"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mastra-ai/mastra.git",
+    "directory": "integrations/tavily"
+  },
+  "bugs": {
+    "url": "https://github.com/mastra-ai/mastra/issues"
+  },
+  "homepage": "https://mastra.ai",
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "peerDependencies": {
+    "@mastra/core": ">=1.0.0-0 <2.0.0-0",
+    "@tavily/core": ">=0.7.0",
+    "zod": ">=3.0.0 || >=4.0.0"
+  },
+  "devDependencies": {
+    "@internal/lint": "workspace:*",
+    "@internal/types-builder": "workspace:*",
+    "@mastra/core": "workspace:*",
+    "@tavily/core": "^0.7.2",
+    "tsup": "^8.5.1",
+    "typescript": "catalog:",
+    "vitest": "catalog:",
+    "zod": "catalog:"
+  }
+}