feat: add Tavily search provider to packages/core

packages/core/package.json

@@ -53,6 +53,7 @@
     "@openrouter/ai-sdk-provider": "^1.5.3",
     "secure-json-parse": "^4.1.0",
     "@xmldom/xmldom": "^0.8.11",
+    "@tavily/core": "^0.6.1",
     "zod": "^4.1.13"
   },
   "devDependencies": {

packages/core/src/index.ts

@@ -57,7 +57,7 @@ export {
 } from "./tools";
 
 export type { ChatService, BrowserService } from "./service";
-export { ExaSearchService } from "./service";
+export { ExaSearchService, TavilySearchService } from "./service";
 
 export {
   sub,

packages/core/src/service/chat-service.ts

@@ -24,6 +24,7 @@ export default interface ChatService {
       livecrawl?: "fallback" | "preferred";
       type?: "auto" | "fast" | "deep";
       contextMaxCharacters?: number;
+      provider?: "exa" | "tavily";
     }
   ): Promise<WebSearchResult[]>;
 }

packages/core/src/service/index.ts

@@ -1,5 +1,6 @@
 import { ChatService } from "./chat-service";
 import { BrowserService } from "./browser-service";
 export { ExaSearchService } from "./exa-search";
+export { TavilySearchService } from "./tavily-search";
 
 export type { ChatService, BrowserService };

packages/core/src/service/tavily-search.ts

@@ -0,0 +1,51 @@
+import { tavily } from "@tavily/core";
+
+export interface TavilySearchOptions {
+  query: string;
+  maxResults?: number;
+  searchDepth?: "basic" | "advanced";
+  topic?: "general" | "news" | "finance";
+}
+
+/**
+ * Service for performing web searches using Tavily API
+ * Returns raw formatted content optimized for LLM consumption
+ */
+export class TavilySearchService {
+  /**
+   * Performs a web search and returns formatted content from Tavily
+   * @param options Search options
+   * @param apiKey Tavily API key for authentication
+   * @returns Raw text content formatted for LLM consumption
+   */
+  static async search(
+    options: TavilySearchOptions,
+    apiKey: string
+  ): Promise<string> {
+    const {
+      query,
+      maxResults = 8,
+      searchDepth = "advanced",
+      topic = "general"
+    } = options;
+
+    const client = tavily({ apiKey });
+
+    const response = await client.search(query, {
+      maxResults,
+      searchDepth,
+      topic
+    });
+
+    if (!response.results || response.results.length === 0) {
+      return "No search results found. Please try a different query.";
+    }
+
+    return response.results
+      .map(
+        (result: { title: string; url: string; content: string }) =>
+          `Title: ${result.title}\nURL: ${result.url}\nContent: ${result.content}`
+      )
+      .join("\n\n---\n\n");
+  }
+}