@defai.digital/ax-cli 3.3.0 → 3.4.0

package/dist/tools/web-search/cache.js

@@ -0,0 +1,105 @@
+/**
+ * Search Cache
+ * In-memory cache for web search results
+ */
+import NodeCache from "node-cache";
+export class SearchCache {
+    cache;
+    DEFAULT_TTL = 300; // 5 minutes in seconds
+    MAX_KEYS = 500; // Maximum cache entries
+    constructor(ttl, maxKeys) {
+        this.cache = new NodeCache({
+            stdTTL: ttl || this.DEFAULT_TTL,
+            checkperiod: 60, // Check for expired entries every 60 seconds
+            maxKeys: maxKeys || this.MAX_KEYS,
+            useClones: false, // Better performance, but watch for mutations
+        });
+    }
+    /**
+     * Generate cache key from query
+     */
+    getCacheKey(query) {
+        return `search:${query.toLowerCase().trim()}`;
+    }
+    /**
+     * Get cached results for a query
+     */
+    get(query) {
+        const key = this.getCacheKey(query);
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return null;
+        }
+        // Return the cached results
+        return entry.results;
+    }
+    /**
+     * Cache search results for a query
+     */
+    set(query, results, ttl) {
+        const key = this.getCacheKey(query);
+        const effectiveTtl = ttl || this.DEFAULT_TTL;
+        const entry = {
+            query,
+            results,
+            timestamp: Date.now(),
+            ttl: effectiveTtl,
+        };
+        this.cache.set(key, entry, effectiveTtl);
+    }
+    /**
+     * Check if query has cached results
+     */
+    has(query) {
+        const key = this.getCacheKey(query);
+        return this.cache.has(key);
+    }
+    /**
+     * Clear specific query from cache
+     */
+    delete(query) {
+        const key = this.getCacheKey(query);
+        this.cache.del(key);
+    }
+    /**
+     * Clear all cached results
+     */
+    clear() {
+        this.cache.flushAll();
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        const stats = this.cache.getStats();
+        const total = stats.hits + stats.misses;
+        const hitRate = total > 0 ? stats.hits / total : 0;
+        return {
+            keys: stats.keys,
+            hits: stats.hits,
+            misses: stats.misses,
+            hitRate: Math.round(hitRate * 100) / 100,
+        };
+    }
+    /**
+     * Get all cached queries (for debugging)
+     */
+    getCachedQueries() {
+        return this.cache.keys().map((key) => key.replace("search:", ""));
+    }
+    /**
+     * Get cache entry with metadata
+     */
+    getEntry(query) {
+        const key = this.getCacheKey(query);
+        return this.cache.get(key) || null;
+    }
+    /**
+     * Get TTL for a cached query
+     */
+    getTTL(query) {
+        const key = this.getCacheKey(query);
+        return this.cache.getTtl(key);
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/tools/web-search/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/tools/web-search/cache.ts"],"names":[],"mappings":"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"}

package/dist/tools/web-search/engines/brave.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Brave Search Engine
+ * Privacy-focused independent search
+ * https://brave.com/search/api/
+ */
+import type { SearchEngine, WebSearchResult, SearchOptions } from "../types.js";
+export declare class BraveSearch implements SearchEngine {
+    readonly name = "brave";
+    private apiKey;
+    private baseUrl;
+    private timeout;
+    constructor();
+    isAvailable(): boolean;
+    search(query: string, options?: SearchOptions): Promise<WebSearchResult[]>;
+    private formatResults;
+}

package/dist/tools/web-search/engines/brave.js

@@ -0,0 +1,99 @@
+/**
+ * Brave Search Engine
+ * Privacy-focused independent search
+ * https://brave.com/search/api/
+ */
+import axios from "axios";
+export class BraveSearch {
+    name = "brave";
+    apiKey;
+    baseUrl = "https://api.search.brave.com/res/v1/web/search";
+    timeout = 10000; // 10 second timeout
+    constructor() {
+        this.apiKey = process.env.BRAVE_API_KEY;
+    }
+    isAvailable() {
+        return !!this.apiKey;
+    }
+    async search(query, options) {
+        if (!this.isAvailable()) {
+            throw new Error("Brave API key not configured");
+        }
+        try {
+            const params = new URLSearchParams({
+                q: query,
+                count: Math.min(options?.maxResults || 10, 20).toString(),
+                offset: "0",
+                text_decorations: "false",
+                spellcheck: "true",
+            });
+            // Add freshness filter if specified
+            if (options?.freshness) {
+                const freshnessMap = {
+                    day: "pd",
+                    week: "pw",
+                    month: "pm",
+                    year: "py",
+                };
+                params.append("freshness", freshnessMap[options.freshness]);
+            }
+            const response = await axios.get(`${this.baseUrl}?${params.toString()}`, {
+                timeout: options?.timeout || this.timeout,
+                headers: {
+                    Accept: "application/json",
+                    "Accept-Encoding": "gzip",
+                    "X-Subscription-Token": this.apiKey,
+                },
+            });
+            return this.formatResults(response.data);
+        }
+        catch (error) {
+            if (axios.isAxiosError(error)) {
+                if (error.code === "ECONNABORTED") {
+                    throw new Error("Brave search timeout");
+                }
+                if (error.response?.status === 401) {
+                    throw new Error("Invalid Brave API key");
+                }
+                if (error.response?.status === 429) {
+                    throw new Error("Brave rate limit exceeded");
+                }
+                throw new Error(`Brave API error: ${error.response?.data?.message || error.message}`);
+            }
+            throw error;
+        }
+    }
+    formatResults(response) {
+        const results = [];
+        // Add web results
+        if (response.web?.results) {
+            results.push(...response.web.results.map((result, index) => ({
+                title: result.title,
+                url: result.url,
+                snippet: result.description,
+                source: this.name,
+                relevanceScore: 100 - index * 5, // Simple scoring based on position
+                publishedDate: result.age || result.page_age,
+                metadata: {
+                    language: result.language,
+                },
+            })));
+        }
+        // Add news results if available
+        if (response.news?.results) {
+            results.push(...response.news.results.map((result, index) => ({
+                title: result.title,
+                url: result.url,
+                snippet: result.description,
+                source: `${this.name}-news`,
+                relevanceScore: 95 - index * 5,
+                publishedDate: result.age,
+                metadata: {
+                    type: "news",
+                },
+            })));
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=brave.js.map

package/dist/tools/web-search/engines/brave.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brave.js","sourceRoot":"","sources":["../../../../src/tools/web-search/engines/brave.ts"],"names":[],"mappings":"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"}

package/dist/tools/web-search/engines/crates.d.ts

@@ -0,0 +1,19 @@
+/**
+ * crates.io (Rust Crates) Search Engine
+ * Free, unlimited search for Rust crates
+ * No API key required
+ */
+import type { SearchEngine, WebSearchResult, SearchOptions } from "../types.js";
+export declare class CratesSearch implements SearchEngine {
+    readonly name = "crates.io";
+    private baseUrl;
+    private timeout;
+    /**
+     * Always available - no API key required
+     */
+    isAvailable(): boolean;
+    search(query: string, options?: SearchOptions): Promise<WebSearchResult[]>;
+    private formatResults;
+    private createSnippet;
+    private calculateScore;
+}

package/dist/tools/web-search/engines/crates.js

@@ -0,0 +1,87 @@
+/**
+ * crates.io (Rust Crates) Search Engine
+ * Free, unlimited search for Rust crates
+ * No API key required
+ */
+import axios from "axios";
+export class CratesSearch {
+    name = "crates.io";
+    baseUrl = "https://crates.io/api/v1/crates";
+    timeout = 10000; // 10 second timeout
+    /**
+     * Always available - no API key required
+     */
+    isAvailable() {
+        return true;
+    }
+    async search(query, options) {
+        try {
+            const params = new URLSearchParams({
+                q: query,
+                per_page: Math.min(options?.maxResults || 5, 20).toString(),
+            });
+            const response = await axios.get(`${this.baseUrl}?${params.toString()}`, {
+                timeout: options?.timeout || this.timeout,
+                headers: {
+                    "User-Agent": "ax-cli",
+                    Accept: "application/json",
+                },
+            });
+            return this.formatResults(response.data);
+        }
+        catch (error) {
+            if (axios.isAxiosError(error)) {
+                if (error.code === "ECONNABORTED") {
+                    throw new Error("crates.io search timeout");
+                }
+                throw new Error(`crates.io error: ${error.response?.data?.errors?.[0]?.detail || error.message}`);
+            }
+            throw error;
+        }
+    }
+    formatResults(response) {
+        return response.crates.map((crate) => ({
+            title: crate.name,
+            url: `https://crates.io/crates/${crate.name}`,
+            snippet: this.createSnippet(crate),
+            source: this.name,
+            relevanceScore: this.calculateScore(crate),
+            metadata: {
+                version: crate.newest_version,
+                downloads: crate.downloads,
+                recentDownloads: crate.recent_downloads,
+                documentation: crate.documentation,
+                homepage: crate.homepage,
+                repository: crate.repository,
+            },
+        }));
+    }
+    createSnippet(crate) {
+        const parts = [];
+        if (crate.description) {
+            parts.push(crate.description);
+        }
+        parts.push(`v${crate.newest_version}`);
+        if (crate.downloads > 1000000) {
+            parts.push(`${(crate.downloads / 1000000).toFixed(1)}M downloads`);
+        }
+        else if (crate.downloads > 1000) {
+            parts.push(`${(crate.downloads / 1000).toFixed(1)}K downloads`);
+        }
+        const indicators = [];
+        if (crate.downloads > 1000000)
+            indicators.push("very popular");
+        else if (crate.downloads > 100000)
+            indicators.push("popular");
+        if (indicators.length > 0) {
+            parts.push(`(${indicators.join(", ")})`);
+        }
+        return parts.join(" • ");
+    }
+    calculateScore(crate) {
+        // Score based on downloads (logarithmic scale)
+        const downloadScore = Math.min(Math.log10(crate.downloads + 1) * 10, 100);
+        return downloadScore;
+    }
+}
+//# sourceMappingURL=crates.js.map

package/dist/tools/web-search/engines/crates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crates.js","sourceRoot":"","sources":["../../../../src/tools/web-search/engines/crates.ts"],"names":[],"mappings":"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"}

package/dist/tools/web-search/engines/npm.d.ts

@@ -0,0 +1,18 @@
+/**
+ * npm Registry Search Engine
+ * Free, unlimited search for npm packages
+ * No API key required
+ */
+import type { SearchEngine, WebSearchResult, SearchOptions } from "../types.js";
+export declare class NpmSearch implements SearchEngine {
+    readonly name = "npm";
+    private baseUrl;
+    private timeout;
+    /**
+     * Always available - no API key required
+     */
+    isAvailable(): boolean;
+    search(query: string, options?: SearchOptions): Promise<WebSearchResult[]>;
+    private formatResults;
+    private createSnippet;
+}

package/dist/tools/web-search/engines/npm.js

@@ -0,0 +1,86 @@
+/**
+ * npm Registry Search Engine
+ * Free, unlimited search for npm packages
+ * No API key required
+ */
+import axios from "axios";
+export class NpmSearch {
+    name = "npm";
+    baseUrl = "https://registry.npmjs.org/-/v1/search";
+    timeout = 10000; // 10 second timeout
+    /**
+     * Always available - no API key required
+     */
+    isAvailable() {
+        return true;
+    }
+    async search(query, options) {
+        try {
+            const params = new URLSearchParams({
+                text: query,
+                size: Math.min(options?.maxResults || 5, 20).toString(),
+            });
+            const response = await axios.get(`${this.baseUrl}?${params.toString()}`, {
+                timeout: options?.timeout || this.timeout,
+                headers: {
+                    Accept: "application/json",
+                },
+            });
+            return this.formatResults(response.data);
+        }
+        catch (error) {
+            if (axios.isAxiosError(error)) {
+                if (error.code === "ECONNABORTED") {
+                    throw new Error("npm search timeout");
+                }
+                throw new Error(`npm registry error: ${error.response?.data?.error || error.message}`);
+            }
+            throw error;
+        }
+    }
+    formatResults(response) {
+        return response.objects.map((pkg) => ({
+            title: pkg.package.name,
+            url: pkg.package.links.npm || `https://www.npmjs.com/package/${pkg.package.name}`,
+            snippet: this.createSnippet(pkg),
+            source: this.name,
+            relevanceScore: pkg.score.final * 100, // Convert 0-1 to 0-100
+            publishedDate: pkg.package.date,
+            metadata: {
+                version: pkg.package.version,
+                author: pkg.package.author?.name || pkg.package.publisher.username,
+                quality: pkg.score.detail.quality,
+                popularity: pkg.score.detail.popularity,
+                maintenance: pkg.score.detail.maintenance,
+                homepage: pkg.package.links.homepage,
+                repository: pkg.package.links.repository,
+            },
+        }));
+    }
+    createSnippet(pkg) {
+        const parts = [];
+        if (pkg.package.description) {
+            parts.push(pkg.package.description);
+        }
+        parts.push(`v${pkg.package.version}`);
+        if (pkg.package.author?.name) {
+            parts.push(`by ${pkg.package.author.name}`);
+        }
+        // Add quality indicators
+        const quality = pkg.score.detail.quality;
+        const popularity = pkg.score.detail.popularity;
+        const maintenance = pkg.score.detail.maintenance;
+        const indicators = [];
+        if (quality > 0.7)
+            indicators.push("high quality");
+        if (popularity > 0.7)
+            indicators.push("popular");
+        if (maintenance > 0.7)
+            indicators.push("well-maintained");
+        if (indicators.length > 0) {
+            parts.push(`(${indicators.join(", ")})`);
+        }
+        return parts.join(" • ");
+    }
+}
+//# sourceMappingURL=npm.js.map

package/dist/tools/web-search/engines/npm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm.js","sourceRoot":"","sources":["../../../../src/tools/web-search/engines/npm.ts"],"names":[],"mappings":"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"}

package/dist/tools/web-search/engines/pypi.d.ts

@@ -0,0 +1,18 @@
+/**
+ * PyPI (Python Package Index) Search Engine
+ * Free, unlimited search for Python packages
+ * No API key required
+ */
+import type { SearchEngine, WebSearchResult, SearchOptions } from "../types.js";
+export declare class PyPISearch implements SearchEngine {
+    readonly name = "pypi";
+    private baseUrl;
+    private timeout;
+    /**
+     * Always available - no API key required
+     */
+    isAvailable(): boolean;
+    search(query: string, options?: SearchOptions): Promise<WebSearchResult[]>;
+    private formatResult;
+    private createSnippet;
+}

package/dist/tools/web-search/engines/pypi.js

@@ -0,0 +1,75 @@
+/**
+ * PyPI (Python Package Index) Search Engine
+ * Free, unlimited search for Python packages
+ * No API key required
+ */
+import axios from "axios";
+// Note: PyPI's search API is being rebuilt, so we use direct package lookup instead
+export class PyPISearch {
+    name = "pypi";
+    baseUrl = "https://pypi.org/pypi";
+    timeout = 10000; // 10 second timeout
+    /**
+     * Always available - no API key required
+     */
+    isAvailable() {
+        return true;
+    }
+    async search(query, options) {
+        try {
+            // PyPI's official search is being rebuilt, so we use direct package lookup
+            // Try to fetch package info directly
+            const packageResponse = await axios.get(`${this.baseUrl}/${encodeURIComponent(query)}/json`, {
+                timeout: options?.timeout || this.timeout,
+                validateStatus: (status) => status === 200 || status === 404,
+            });
+            if (packageResponse.status === 404) {
+                // Package not found, return empty results
+                return [];
+            }
+            return this.formatResult(packageResponse.data);
+        }
+        catch (error) {
+            // Return empty results on error rather than failing
+            // PyPI search is a best-effort feature
+            return [];
+        }
+    }
+    formatResult(data) {
+        if (!data.info)
+            return [];
+        const info = data.info;
+        return [
+            {
+                title: info.name,
+                url: `https://pypi.org/project/${info.name}/`,
+                snippet: this.createSnippet(info),
+                source: this.name,
+                relevanceScore: 100, // Exact match
+                publishedDate: info.release_date,
+                metadata: {
+                    version: info.version,
+                    author: info.author,
+                    license: info.license,
+                    homepage: info.home_page || info.project_urls?.Homepage,
+                    requiresPython: info.requires_python,
+                },
+            },
+        ];
+    }
+    createSnippet(info) {
+        const parts = [];
+        if (info.summary) {
+            parts.push(info.summary);
+        }
+        parts.push(`v${info.version}`);
+        if (info.author) {
+            parts.push(`by ${info.author}`);
+        }
+        if (info.license) {
+            parts.push(`License: ${info.license}`);
+        }
+        return parts.join(" • ");
+    }
+}
+//# sourceMappingURL=pypi.js.map

package/dist/tools/web-search/engines/pypi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pypi.js","sourceRoot":"","sources":["../../../../src/tools/web-search/engines/pypi.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAO1B,oFAAoF;AAEpF,MAAM,OAAO,UAAU;IACL,IAAI,GAAG,MAAM,CAAC;IACtB,OAAO,GAAG,uBAAuB,CAAC;IAClC,OAAO,GAAG,KAAK,CAAC,CAAC,oBAAoB;IAE7C;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,MAAM,CACV,KAAa,EACb,OAAuB;QAEvB,IAAI,CAAC;YACH,2EAA2E;YAC3E,qCAAqC;YACrC,MAAM,eAAe,GAAG,MAAM,KAAK,CAAC,GAAG,CACrC,GAAG,IAAI,CAAC,OAAO,IAAI,kBAAkB,CAAC,KAAK,CAAC,OAAO,EACnD;gBACE,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC,OAAO;gBACzC,cAAc,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG;aAC7D,CACF,CAAC;YAEF,IAAI,eAAe,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACnC,0CAA0C;gBAC1C,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,OAAO,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,oDAAoD;YACpD,uCAAuC;YACvC,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,IAAS;QAC5B,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,CAAC;QAE1B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,OAAO;YACL;gBACE,KAAK,EAAE,IAAI,CAAC,IAAI;gBAChB,GAAG,EAAE,4BAA4B,IAAI,CAAC,IAAI,GAAG;gBAC7C,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;gBACjC,MAAM,EAAE,IAAI,CAAC,IAAI;gBACjB,cAAc,EAAE,GAAG,EAAE,cAAc;gBACnC,aAAa,EAAE,IAAI,CAAC,YAAY;gBAChC,QAAQ,EAAE;oBACR,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,QAAQ,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,YAAY,EAAE,QAAQ;oBACvD,cAAc,EAAE,IAAI,CAAC,eAAe;iBACrC;aACF;SACF,CAAC;IACJ,CAAC;IAEO,aAAa,CAAC,IAAS;QAC7B,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAE/B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAClC,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;CACF"}

package/dist/tools/web-search/engines/tavily.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Tavily AI Search Engine
+ * AI-optimized search designed for LLMs
+ * https://tavily.com/
+ */
+import type { SearchEngine, WebSearchResult, SearchOptions } from "../types.js";
+export declare class TavilySearch implements SearchEngine {
+    readonly name = "tavily";
+    private apiKey;
+    private baseUrl;
+    private timeout;
+    constructor();
+    isAvailable(): boolean;
+    search(query: string, options?: SearchOptions): Promise<WebSearchResult[]>;
+    private formatResults;
+    getAnswer(results: WebSearchResult[]): string | undefined;
+}

package/dist/tools/web-search/engines/tavily.js

@@ -0,0 +1,73 @@
+/**
+ * Tavily AI Search Engine
+ * AI-optimized search designed for LLMs
+ * https://tavily.com/
+ */
+import axios from "axios";
+export class TavilySearch {
+    name = "tavily";
+    apiKey;
+    baseUrl = "https://api.tavily.com/search";
+    timeout = 10000; // 10 second timeout
+    constructor() {
+        this.apiKey = process.env.TAVILY_API_KEY;
+    }
+    isAvailable() {
+        return !!this.apiKey;
+    }
+    async search(query, options) {
+        if (!this.isAvailable()) {
+            throw new Error("Tavily API key not configured");
+        }
+        try {
+            const response = await axios.post(this.baseUrl, {
+                api_key: this.apiKey,
+                query: query,
+                search_depth: options?.searchDepth || "basic",
+                max_results: Math.min(options?.maxResults || 5, 10),
+                include_answer: options?.includeAnswer ?? true,
+                include_domains: options?.includeDomains || [],
+                exclude_domains: options?.excludeDomains || [],
+            }, {
+                timeout: options?.timeout || this.timeout,
+                headers: {
+                    "Content-Type": "application/json",
+                },
+            });
+            return this.formatResults(response.data);
+        }
+        catch (error) {
+            if (axios.isAxiosError(error)) {
+                if (error.code === "ECONNABORTED") {
+                    throw new Error("Tavily search timeout");
+                }
+                if (error.response?.status === 401) {
+                    throw new Error("Invalid Tavily API key");
+                }
+                if (error.response?.status === 429) {
+                    throw new Error("Tavily rate limit exceeded");
+                }
+                throw new Error(`Tavily API error: ${error.response?.data?.message || error.message}`);
+            }
+            throw error;
+        }
+    }
+    formatResults(response) {
+        return response.results.map((result) => ({
+            title: result.title,
+            url: result.url,
+            snippet: result.content,
+            source: this.name,
+            relevanceScore: result.score * 100, // Convert 0-1 to 0-100
+            publishedDate: result.published_date,
+            metadata: {
+                answer: response.answer,
+                responseTime: response.response_time,
+            },
+        }));
+    }
+    getAnswer(results) {
+        return results[0]?.metadata?.answer;
+    }
+}
+//# sourceMappingURL=tavily.js.map

package/dist/tools/web-search/engines/tavily.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tavily.js","sourceRoot":"","sources":["../../../../src/tools/web-search/engines/tavily.ts"],"names":[],"mappings":"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"}