npm - @elizaos/plugin-web-search - Versions diffs - 2.0.0-beta.1 → 2.0.3-beta.5 - Mend

@elizaos/plugin-web-search 2.0.0-beta.1 → 2.0.3-beta.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2026 Shaw Walters and elizaOS Contributors
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md CHANGED Viewed

@@ -1,247 +1,116 @@
 # @elizaos/plugin-web-search
-A plugin for powerful web search capabilities, providing efficient search query handling and result processing through a customizable API interface.
+Adds live web search to an Eliza agent via the [Tavily](https://tavily.com/) API.
-## Overview
+## What it does
-This plugin provides functionality to:
+Installing this plugin registers a `WebSearchService` (`ServiceType.WEB_SEARCH`) that any other plugin or action can call to search the web. It also registers the `"web"` search category so the elizaOS core search-dispatch layer routes web queries to this service automatically.
-- Execute web search queries with customizable parameters
-- Process and format search results
-- Handle search API authentication
-- Manage token limits and response sizes
-- Optimize query performance
+Capabilities exposed through the service:
-## Installation
+- **General web search** — ranked results with optional AI-generated answer.
+- **News search** — topic-filtered results with freshness control (day / week / month).
+- **Image search** — includes image URLs in results.
+- **Video search** — delegates to general search (Tavily has no separate video endpoint).
+- **Page info** — fetches a URL and extracts title, description, and raw HTML content.
-```bash
-bun install @elizaos/plugin-web-search
-```
+No actions are registered by the plugin itself. Other plugins that rely on web search call `runtime.getService(ServiceType.WEB_SEARCH)` and invoke the service directly.
-## Configuration
+## Installation
-The plugin requires the following environment variables:
+Add the package to your agent:
-```env
-TAVILY_API_KEY=your_api_key    # Required: API key for search service
+```bash
+bun add @elizaos/plugin-web-search
 ```
-## Usage
-Import and register the plugin in your Eliza configuration.
+Then include it in your character config:
 ```typescript
 import { webSearchPlugin } from "@elizaos/plugin-web-search";
 export default {
     plugins: [webSearchPlugin],
-    // ... other configuration
+    // ...
 };
 ```
-**Custom Usage**
-If you want custom usage, for example, a social media client to search the web before posting, you can also import the webSearchService and use it directly. Here's how you can do it:
-```typescript
-// Example usage in a social media client
-const webSearchService = new WebSearchService();
-await webSearchService.initialize(runtime);
-const latestNews = await webSearchService.search(
-    "latest news on AI Agents",
-    // searchOptions
-);
-const state = await this.runtime.composeState(
-    {  } // memory,
-    { // additional keys
-        latestNews: latestNews,
-    }
-);
-// Then modify the post template to include the {{latestNews}} and however you need
-```
-## Features
+## Configuration
-### Web Search
+| Environment variable | Required | Description |
+|---------------------|----------|-------------|
+| `TAVILY_API_KEY` | Yes | API key from [app.tavily.com](https://app.tavily.com). Without it the service starts in a degraded (inert) state and throws a descriptive error on first use. |
-The plugin provides comprehensive web search capabilities:
+Set the key in your environment or agent settings:
-```typescript
-import { webSearch } from "@elizaos/plugin-web-search";
-// Execute a search query
-const result = await webSearch.handler(
-    runtime,
-    {
-        content: { text: "What is the latest news about AI?" },
-    },
-    state,
-    {},
-    callback
-);
+```env
+TAVILY_API_KEY=tvly-...
 ```
-### Token Management
+## Calling the service from another plugin
 ```typescript
-// The plugin automatically handles token limits
-const DEFAULT_MAX_WEB_SEARCH_TOKENS = 4000;
+import { ServiceType } from "@elizaos/core";
+import type { IWebSearchService } from "@elizaos/core";
-// Example of token-limited response
-const response = MaxTokens(searchResult, DEFAULT_MAX_WEB_SEARCH_TOKENS);
-```
+const svc = runtime.getService<IWebSearchService>(ServiceType.WEB_SEARCH);
-## Development
-### Building
-```bash
-bun run build
-```
+// General search
+const result = await svc.search("latest developments in open-source LLMs", {
+    limit: 5,
+    searchDepth: "advanced",
+    includeAnswer: true,
+});
-### Testing
+// News search
+const news = await svc.searchNews("AI regulation", { freshness: "week" });
-```bash
-bun run test
+// Image search (always returns image results; no flag needed)
+const images = await svc.searchImages("northern lights", { limit: 10 });
 ```
-### Development Mode
-```bash
-bun run dev
-```
-## Dependencies
-- `@elizaos/core`: Core Eliza functionality
-- `js-tiktoken`: Token counting and management
-- `tsup`: Build tool
-- Other standard dependencies listed in package.json
-## API Reference
-### Core Interfaces
+`SearchResponse` shape:
 ```typescript
-interface Action {
-    name: "WEB_SEARCH";
-    similes: string[];
-    description: string;
-    validate: (runtime: IAgentRuntime, message: Memory) => Promise<boolean>;
-    handler: (
-        runtime: IAgentRuntime,
-        message: Memory,
-        state: State,
-        options: any,
-        callback: HandlerCallback
-    ) => Promise<void>;
-    examples: Array<Array<any>>;
-}
-interface SearchResult {
-    title: string;
-    url: string;
-    answer?: string;
-    results?: Array<{
+{
+    query: string;
+    answer?: string;         // AI-generated summary (when includeAnswer is true)
+    responseTime?: number;
+    results: Array<{
         title: string;
         url: string;
+        description: string;
+        content: string;
+        rawContent?: string;
+        score: number;
+        publishedDate?: Date;
     }>;
+    images: Array<{ url: string; description?: string }>;
 }
 ```
-### Plugin Methods
-- `webSearch.handler`: Main method for executing searches
-- `generateWebSearch`: Core search generation function
-- `MaxTokens`: Token limit management function
-- `getTotalTokensFromString`: Token counting utility
-## Common Issues/Troubleshooting
-### Issue: API Authentication Failures
-- **Cause**: Invalid or missing Tavily API key
-- **Solution**: Verify TAVILY_API_KEY environment variable
-### Issue: Token Limit Exceeded
-- **Cause**: Search results exceeding maximum token limit
-- **Solution**: Results are automatically truncated to fit within limits
-### Issue: Search Rate Limiting
-- **Cause**: Too many requests in short time
-- **Solution**: Implement proper request throttling
-## Security Best Practices
-- Store API keys securely using environment variables
-- Validate all search inputs
-- Implement proper error handling
-- Keep dependencies updated
-- Monitor API usage and rate limits
-- Use HTTPS for API communication
-## Example Usage
-```typescript
-// Basic search
-const searchQuery = "Latest developments in quantum computing";
-const results = await generateWebSearch(searchQuery, runtime);
-// With formatted response
-if (results && results.results.length) {
-    const formattedResponse = `${results.answer}\n\nFor more details, check out:\n${results.results
-        .map(
-            (result, index) => `${index + 1}. [${result.title}](${result.url})`
-        )
-        .join("\n")}`;
-}
-```
+## Search options
-## Configuration Options
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `limit` | number | 3 | Maximum number of results |
+| `topic` / `type` | `"general"` \| `"news"` | `"general"` | Tavily topic filter |
+| `searchDepth` | `"basic"` \| `"advanced"` | `"basic"` | Tavily crawl depth |
+| `includeAnswer` | boolean | true | Request an AI-generated answer |
+| `includeImages` | boolean | false | Include image results |
+| `days` | number | 3 | Freshness window in days (news searches) |
-### Token Management
+## Development
-```typescript
-const DEFAULT_MODEL_ENCODING = "gpt-3.5-turbo";
-const DEFAULT_MAX_WEB_SEARCH_TOKENS = 4000;
+```bash
+bun run --cwd plugins/plugin-web-search build      # compile
+bun run --cwd plugins/plugin-web-search dev        # watch mode
+bun run --cwd plugins/plugin-web-search lint       # biome check
+bun run --cwd plugins/plugin-web-search typecheck  # type-check only
 ```
-### Search Actions
-The plugin includes multiple search action similes:
-- SEARCH_WEB
-- INTERNET_SEARCH
-- LOOKUP
-- QUERY_WEB
-- FIND_ONLINE
-- And more...
-## Contributing
-Contributions are welcome! Please see the [CONTRIBUTING.md](CONTRIBUTING.md) file for more information.
-## Credits
-This plugin integrates with and builds upon several key technologies:
-- [Tavily API](https://tavily.com/): Advanced search and content analysis API
-- [js-tiktoken](https://github.com/dqbd/tiktoken): Token counting for API responses
-- [Zod](https://github.com/colinhacks/zod): TypeScript-first schema validation
-Special thanks to:
-- The Eliza community for their contributions and feedback
-For more information about the search capabilities and tools:
-- [Tavily API Documentation](https://docs.tavily.com/)
-- [Token Management Guide](https://github.com/dqbd/tiktoken#readme)
-- [Search API Best Practices](https://docs.tavily.com/docs/guides/best-practices)
+## Dependencies
-## License
+- [`@elizaos/core`](https://github.com/elizaOS/eliza) — elizaOS runtime interfaces
+- [`@tavily/core`](https://www.npmjs.com/package/@tavily/core) — Tavily search client
-This plugin is part of the Eliza project. See the main project repository for license information.

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/plugin-web-search",
-  "version": "2.0.0-beta.1",
+  "version": "2.0.3-beta.5",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -8,32 +8,50 @@
   "exports": {
     "./package.json": "./package.json",
     ".": {
+      "eliza-source": {
+        "types": "./src/index.ts",
+        "import": "./src/index.ts",
+        "default": "./src/index.ts"
+      },
       "import": {
         "types": "./dist/index.d.ts",
         "default": "./dist/index.js"
       }
+    },
+    "./*.css": "./dist/*.css",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "eliza-source": {
+        "types": "./src/*.ts",
+        "import": "./src/*.ts",
+        "default": "./src/*.ts"
+      },
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
     }
   },
   "files": [
     "dist"
   ],
   "dependencies": {
-    "@elizaos/core": "2.0.0-beta.1",
-    "@tavily/core": "^0.7.0",
-    "js-tiktoken": "1.0.21",
-    "tsup": "^8.5.1"
+    "@elizaos/core": "2.0.3-beta.5",
+    "@tavily/core": "^0.7.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.4.14"
+    "@biomejs/biome": "2.5.0",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.7"
   },
   "scripts": {
+    "test": "vitest run --config ./vitest.config.ts",
     "build": "tsup --format esm --dts",
     "dev": "tsup --format esm --dts --watch",
-    "lint": "biome check src/",
-    "lint:fix": "biome check --write src/",
-    "format": "biome format src/",
-    "format:fix": "biome format --write src/",
-    "typecheck": "tsc --noEmit -p tsconfig.json"
+    "lint": "bunx @biomejs/biome check src/",
+    "lint:fix": "bunx @biomejs/biome check --write src/",
+    "format": "bunx @biomejs/biome format src/",
+    "format:fix": "bunx @biomejs/biome format --write src/",
+    "typecheck": "tsgo --noEmit -p tsconfig.json"
   },
   "agentConfig": {
     "pluginType": "elizaos:client:1.0.0",
@@ -43,5 +61,9 @@
         "description": "Tavily API key for accessing news services"
       }
     }
-  }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "ff6157011c9459670021cc28a6797592a78b8817"
 }

package/dist/index.d.ts DELETED Viewed

@@ -1,7 +0,0 @@
-import { SearchCategoryRegistration, Plugin, IAgentRuntime } from '@elizaos/core';
-declare const WEB_SEARCH_CATEGORY: SearchCategoryRegistration;
-declare function registerWebSearchCategory(runtime: IAgentRuntime): void;
-declare const webSearchPlugin: Plugin;
-export { WEB_SEARCH_CATEGORY, webSearchPlugin as default, registerWebSearchCategory, webSearchPlugin };

package/dist/index.js DELETED Viewed

@@ -1,197 +0,0 @@
-// src/index.ts
-import { ServiceType as ServiceType2 } from "@elizaos/core";
-// src/services/webSearchService.ts
-import { IWebSearchService, logger, ServiceType } from "@elizaos/core";
-import { tavily } from "@tavily/core";
-function parsePublishedDate(value) {
-  if (!value) return void 0;
-  const date = new Date(value);
-  return Number.isNaN(date.getTime()) ? void 0 : date;
-}
-function normalizeResponse(query, response) {
-  const results = (response.results ?? []).map((result) => {
-    const content = result.content ?? "";
-    return {
-      title: result.title ?? "Untitled",
-      url: result.url ?? "",
-      description: content,
-      content,
-      rawContent: result.rawContent,
-      score: typeof result.score === "number" ? result.score : 0,
-      publishedDate: parsePublishedDate(result.publishedDate)
-    };
-  });
-  const images = (response.images ?? []).map(
-    (image) => typeof image === "string" ? { url: image } : { url: image.url ?? "", description: image.description }
-  ).filter((image) => image.url);
-  return {
-    answer: response.answer,
-    query: response.query ?? query,
-    responseTime: response.responseTime,
-    images,
-    results
-  };
-}
-function freshnessToDays(freshness) {
-  switch (freshness) {
-    case "day":
-      return 1;
-    case "week":
-      return 7;
-    case "month":
-      return 30;
-    default:
-      return 3;
-  }
-}
-var WebSearchService = class _WebSearchService extends IWebSearchService {
-  static serviceType = ServiceType.WEB_SEARCH;
-  capabilityDescription = "Web search and content discovery capabilities";
-  tavilyClient;
-  static async start(runtime) {
-    const service = new _WebSearchService(runtime);
-    await service.initialize(runtime);
-    return service;
-  }
-  async stop() {
-  }
-  async initialize(runtime) {
-    const apiKey = runtime.getSetting("TAVILY_API_KEY");
-    if (typeof apiKey !== "string" || apiKey.length === 0) {
-      throw new Error("TAVILY_API_KEY is not set");
-    }
-    this.tavilyClient = tavily({ apiKey });
-  }
-  async search(query, options) {
-    try {
-      const response = await this.tavilyClient.search(query, {
-        includeAnswer: (options == null ? void 0 : options.includeAnswer) ?? true,
-        maxResults: (options == null ? void 0 : options.limit) ?? 3,
-        topic: (options == null ? void 0 : options.topic) ?? (options == null ? void 0 : options.type) ?? "general",
-        searchDepth: (options == null ? void 0 : options.searchDepth) ?? "basic",
-        includeImages: (options == null ? void 0 : options.includeImages) ?? false,
-        days: (options == null ? void 0 : options.days) ?? 3
-      });
-      return normalizeResponse(query, response);
-    } catch (cause) {
-      const err = cause instanceof Error ? cause : new Error(String(cause));
-      logger.error({ src: "plugin-web-search", err }, "Web search error");
-      throw err;
-    }
-  }
-  async searchNews(query, options) {
-    return this.search(query, {
-      ...options,
-      type: "news",
-      topic: "news",
-      days: freshnessToDays(options == null ? void 0 : options.freshness)
-    });
-  }
-  async searchImages(query, options) {
-    return this.search(query, {
-      limit: options == null ? void 0 : options.limit,
-      offset: options == null ? void 0 : options.offset,
-      language: options == null ? void 0 : options.language,
-      region: options == null ? void 0 : options.region,
-      dateRange: options == null ? void 0 : options.dateRange,
-      fileType: options == null ? void 0 : options.fileType,
-      site: options == null ? void 0 : options.site,
-      sortBy: options == null ? void 0 : options.sortBy,
-      safeSearch: options == null ? void 0 : options.safeSearch,
-      includeImages: true
-    });
-  }
-  async searchVideos(query, options) {
-    return this.search(query, options);
-  }
-  async getSuggestions(_query) {
-    return [];
-  }
-  async getTrendingSearches(_region) {
-    return [];
-  }
-  async getPageInfo(url) {
-    var _a, _b;
-    const response = await fetch(url);
-    const content = await response.text();
-    const title = ((_a = content.match(/<title[^>]*>(.*?)<\/title>/i)) == null ? void 0 : _a[1]) ?? url;
-    const description = ((_b = content.match(/<meta\s+name=["']description["']\s+content=["']([^"']+)/i)) == null ? void 0 : _b[1]) ?? "";
-    return {
-      title,
-      description,
-      content,
-      metadata: {},
-      images: [],
-      links: []
-    };
-  }
-};
-// src/index.ts
-var WEB_SEARCH_CATEGORY = {
-  category: "web",
-  label: "Web",
-  description: "Search current web pages through plugin-web-search.",
-  contexts: ["knowledge", "browser"],
-  filters: [
-    {
-      name: "topic",
-      label: "Topic",
-      description: "Tavily search topic.",
-      type: "enum",
-      options: [
-        { label: "General", value: "general" },
-        { label: "News", value: "news" }
-      ]
-    },
-    {
-      name: "searchDepth",
-      label: "Search depth",
-      description: "Tavily search depth.",
-      type: "enum",
-      options: [
-        { label: "Basic", value: "basic" },
-        { label: "Advanced", value: "advanced" }
-      ]
-    },
-    {
-      name: "includeImages",
-      label: "Include images",
-      description: "Include image results when available.",
-      type: "boolean"
-    }
-  ],
-  resultSchemaSummary: "SearchResponse with query, answer, results containing title/url/description/content/score, and optional images.",
-  capabilities: ["web", "news", "current-information"],
-  source: "plugin-web-search",
-  serviceType: ServiceType2.WEB_SEARCH
-};
-function registerWebSearchCategory(runtime) {
-  try {
-    runtime.getSearchCategory(WEB_SEARCH_CATEGORY.category, {
-      includeDisabled: true
-    });
-    return;
-  } catch {
-    runtime.registerSearchCategory(WEB_SEARCH_CATEGORY);
-  }
-}
-var webSearchPlugin = {
-  name: "webSearch",
-  description: "Search the web and get news",
-  init: async (_config, runtime) => {
-    registerWebSearchCategory(runtime);
-  },
-  actions: [],
-  providers: [],
-  services: [WebSearchService]
-};
-var index_default = webSearchPlugin;
-export {
-  WEB_SEARCH_CATEGORY,
-  index_default as default,
-  registerWebSearchCategory,
-  webSearchPlugin
-};
-//# sourceMappingURL=index.js.map

package/dist/index.js.map DELETED Viewed

@@ -1 +0,0 @@

- {"version":3,"sources":["../src/index.ts","../src/services/webSearchService.ts"],"sourcesContent":["import type { IAgentRuntime, Plugin, SearchCategoryRegistration } from \"@elizaos/core\";\nimport { ServiceType } from \"@elizaos/core\";\n\nimport { WebSearchService } from \"./services/webSearchService\";\n\nexport const WEB_SEARCH_CATEGORY: SearchCategoryRegistration = {\n category: \"web\",\n label: \"Web\",\n description: \"Search current web pages through plugin-web-search.\",\n contexts: [\"knowledge\", \"browser\"],\n filters: [\n {\n name: \"topic\",\n label: \"Topic\",\n description: \"Tavily search topic.\",\n type: \"enum\",\n options: [\n { label: \"General\", value: \"general\" },\n { label: \"News\", value: \"news\" },\n ],\n },\n {\n name: \"searchDepth\",\n label: \"Search depth\",\n description: \"Tavily search depth.\",\n type: \"enum\",\n options: [\n { label: \"Basic\", value: \"basic\" },\n { label: \"Advanced\", value: \"advanced\" },\n ],\n },\n {\n name: \"includeImages\",\n label: \"Include images\",\n description: \"Include image results when available.\",\n type: \"boolean\",\n },\n ],\n resultSchemaSummary:\n \"SearchResponse with query, answer, results containing title/url/description/content/score, and optional images.\",\n capabilities: [\"web\", \"news\", \"current-information\"],\n source: \"plugin-web-search\",\n serviceType: ServiceType.WEB_SEARCH,\n};\n\nexport function registerWebSearchCategory(runtime: IAgentRuntime): void {\n try {\n runtime.getSearchCategory(WEB_SEARCH_CATEGORY.category, {\n includeDisabled: true,\n });\n return;\n } catch {\n runtime.registerSearchCategory(WEB_SEARCH_CATEGORY);\n }\n}\n\nexport const webSearchPlugin: Plugin = {\n name: \"webSearch\",\n description: \"Search the web and get news\",\n init: async (_config, runtime) => {\n registerWebSearchCategory(runtime);\n },\n actions: [],\n providers: [],\n services: [WebSearchService],\n};\n\nexport default webSearchPlugin;\n","import { type IAgentRuntime, IWebSearchService, logger, ServiceType } from \"@elizaos/core\";\nimport { tavily } from \"@tavily/core\";\n\nimport type {\n ImageSearchOptions,\n NewsSearchOptions,\n SearchOptions,\n SearchResponse,\n VideoSearchOptions,\n} from \"../types\";\n\nexport type TavilyClient = ReturnType<typeof tavily>;\n\ntype TavilySearchResult = {\n title?: string;\n url?: string;\n content?: string;\n rawContent?: string;\n score?: number;\n publishedDate?: string;\n};\n\ntype TavilySearchResponse = {\n answer?: string;\n query?: string;\n responseTime?: number;\n images?: Array<{ url?: string; description?: string } | string>;\n results?: TavilySearchResult[];\n};\n\nfunction parsePublishedDate(value: string | undefined): Date | undefined {\n if (!value) return undefined;\n const date = new Date(value);\n return Number.isNaN(date.getTime()) ? undefined : date;\n}\n\nfunction normalizeResponse(query: string, response: TavilySearchResponse): SearchResponse {\n const results = (response.results ?? []).map((result) => {\n const content = result.content ?? \"\";\n return {\n title: result.title ?? \"Untitled\",\n url: result.url ?? \"\",\n description: content,\n content,\n rawContent: result.rawContent,\n score: typeof result.score === \"number\" ? result.score : 0,\n publishedDate: parsePublishedDate(result.publishedDate),\n };\n });\n const images = (response.images ?? [])\n .map((image) =>\n typeof image === \"string\"\n ? { url: image }\n : { url: image.url ?? \"\", description: image.description }\n )\n .filter((image) => image.url);\n\n return {\n answer: response.answer,\n query: response.query ?? query,\n responseTime: response.responseTime,\n images,\n results,\n };\n}\n\nfunction freshnessToDays(freshness: NewsSearchOptions[\"freshness\"]): number {\n switch (freshness) {\n case \"day\":\n return 1;\n case \"week\":\n return 7;\n case \"month\":\n return 30;\n default:\n return 3;\n }\n}\n\nexport class WebSearchService extends IWebSearchService {\n static override serviceType = ServiceType.WEB_SEARCH;\n override capabilityDescription = \"Web search and content discovery capabilities\" as const;\n\n tavilyClient!: TavilyClient;\n\n static override async start(runtime: IAgentRuntime): Promise<WebSearchService> {\n const service = new WebSearchService(runtime);\n await service.initialize(runtime);\n return service;\n }\n\n async stop(): Promise<void> {\n // Tavily client is stateless HTTP; nothing to tear down.\n }\n\n private async initialize(runtime: IAgentRuntime): Promise<void> {\n const apiKey = runtime.getSetting(\"TAVILY_API_KEY\");\n if (typeof apiKey !== \"string\" || apiKey.length === 0) {\n throw new Error(\"TAVILY_API_KEY is not set\");\n }\n this.tavilyClient = tavily({ apiKey });\n }\n\n async search(query: string, options?: SearchOptions): Promise<SearchResponse> {\n try {\n const response = await this.tavilyClient.search(query, {\n includeAnswer: options?.includeAnswer ?? true,\n maxResults: options?.limit ?? 3,\n topic: options?.topic ?? options?.type ?? \"general\",\n searchDepth: options?.searchDepth ?? \"basic\",\n includeImages: options?.includeImages ?? false,\n days: options?.days ?? 3,\n });\n\n return normalizeResponse(query, response as TavilySearchResponse);\n } catch (cause) {\n const err = cause instanceof Error ? cause : new Error(String(cause));\n logger.error({ src: \"plugin-web-search\", err }, \"Web search error\");\n throw err;\n }\n }\n\n async searchNews(query: string, options?: NewsSearchOptions): Promise<SearchResponse> {\n return this.search(query, {\n ...options,\n type: \"news\",\n topic: \"news\",\n days: freshnessToDays(options?.freshness),\n });\n }\n\n async searchImages(query: string, options?: ImageSearchOptions): Promise<SearchResponse> {\n return this.search(query, {\n limit: options?.limit,\n offset: options?.offset,\n language: options?.language,\n region: options?.region,\n dateRange: options?.dateRange,\n fileType: options?.fileType,\n site: options?.site,\n sortBy: options?.sortBy,\n safeSearch: options?.safeSearch,\n includeImages: true,\n });\n }\n\n async searchVideos(query: string, options?: VideoSearchOptions): Promise<SearchResponse> {\n return this.search(query, options);\n }\n\n async getSuggestions(_query: string): Promise<string[]> {\n return [];\n }\n\n async getTrendingSearches(_region?: string): Promise<string[]> {\n return [];\n }\n\n async getPageInfo(url: string): Promise<{\n title: string;\n description: string;\n content: string;\n metadata: Record<string, string>;\n images: string[];\n links: string[];\n }> {\n const response = await fetch(url);\n const content = await response.text();\n const title = content.match(/<title[^>]*>(.*?)<\\/title>/i)?.[1] ?? url;\n const description =\n content.match(/<meta\\s+name=[\"']description[\"']\\s+content=[\"']([^\"']+)/i)?.[1] ?? \"\";\n return {\n title,\n description,\n content,\n metadata: {},\n images: [],\n links: [],\n };\n }\n}\n"],"mappings":"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","names":["ServiceType","ServiceType"]}