@framers/agentos-ext-web-search 1.1.0

package/dist/services/searchProvider.js

@@ -0,0 +1,342 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchProviderService = void 0;
+/**
+ * Service for managing multiple search providers with fallback support
+ *
+ * @class SearchProviderService
+ *
+ * @example
+ * ```typescript
+ * const service = new SearchProviderService({
+ *   serperApiKey: 'your-key',
+ *   rateLimit: { maxRequests: 10, windowMs: 60000 }
+ * });
+ *
+ * const results = await service.search('query');
+ * ```
+ */
+class SearchProviderService {
+    config;
+    rateLimitState;
+    /**
+     * Creates an instance of SearchProviderService
+     *
+     * @param {SearchProviderConfig} config - Configuration for the service
+     */
+    constructor(config) {
+        this.config = {
+            maxRetries: 3,
+            rateLimit: {
+                maxRequests: 10,
+                windowMs: 60000
+            },
+            ...config
+        };
+        this.rateLimitState = new Map();
+    }
+    /**
+     * Performs a search across available providers with automatic fallback
+     *
+     * @param {string} query - The search query
+     * @param {Object} options - Search options
+     * @param {number} [options.maxResults=10] - Maximum results to return
+     * @param {string} [options.provider] - Specific provider to use
+     * @returns {Promise<ProviderResponse>} Search results with metadata
+     *
+     * @throws {Error} If all providers fail and no fallback is available
+     */
+    async search(query, options = {}) {
+        const startTime = Date.now();
+        const maxResults = options.maxResults || 10;
+        // If specific provider requested, try only that one
+        if (options.provider) {
+            return this.searchWithProvider(query, options.provider, maxResults, startTime);
+        }
+        // Try providers in order of preference
+        const providers = this.getAvailableProviders();
+        for (const provider of providers) {
+            try {
+                if (await this.checkRateLimit(provider)) {
+                    return await this.searchWithProvider(query, provider, maxResults, startTime);
+                }
+            }
+            catch (error) {
+                console.warn(`Provider ${provider} failed:`, error);
+                continue;
+            }
+        }
+        // Final fallback to DuckDuckGo (no API key required)
+        return this.searchDuckDuckGo(query, maxResults, startTime);
+    }
+    /**
+     * Searches using a specific provider
+     *
+     * @private
+     * @param {string} query - Search query
+     * @param {string} provider - Provider name
+     * @param {number} maxResults - Maximum results
+     * @param {number} startTime - Request start timestamp
+     * @returns {Promise<ProviderResponse>} Search results
+     */
+    async searchWithProvider(query, provider, maxResults, startTime) {
+        let results;
+        switch (provider) {
+            case 'serper':
+                results = await this.searchSerper(query, maxResults);
+                break;
+            case 'serpapi':
+                results = await this.searchSerpApi(query, maxResults);
+                break;
+            case 'brave':
+                results = await this.searchBrave(query, maxResults);
+                break;
+            case 'duckduckgo':
+            default:
+                results = await this.searchDuckDuckGoAPI(query, maxResults);
+                break;
+        }
+        return {
+            provider,
+            results: results.slice(0, maxResults),
+            metadata: {
+                query,
+                timestamp: new Date().toISOString(),
+                responseTime: Date.now() - startTime
+            }
+        };
+    }
+    /**
+     * Gets list of available providers based on configured API keys
+     *
+     * @private
+     * @returns {string[]} Array of available provider names
+     */
+    getAvailableProviders() {
+        const providers = [];
+        if (this.config.serperApiKey)
+            providers.push('serper');
+        if (this.config.serpApiKey)
+            providers.push('serpapi');
+        if (this.config.braveApiKey)
+            providers.push('brave');
+        return providers;
+    }
+    /**
+     * Checks if a provider is within rate limits
+     *
+     * @private
+     * @param {string} provider - Provider name
+     * @returns {Promise<boolean>} True if within limits
+     */
+    async checkRateLimit(provider) {
+        const now = Date.now();
+        const state = this.rateLimitState.get(provider);
+        if (!state || now > state.resetTime) {
+            this.rateLimitState.set(provider, {
+                count: 1,
+                resetTime: now + this.config.rateLimit.windowMs
+            });
+            return true;
+        }
+        if (state.count >= this.config.rateLimit.maxRequests) {
+            return false;
+        }
+        state.count++;
+        return true;
+    }
+    /**
+     * Search using Serper.dev API
+     *
+     * @private
+     * @param {string} query - Search query
+     * @param {number} maxResults - Maximum results
+     * @returns {Promise<SearchResult[]>} Search results
+     */
+    async searchSerper(query, maxResults) {
+        const response = await fetch('https://google.serper.dev/search', {
+            method: 'POST',
+            headers: {
+                'X-API-KEY': this.config.serperApiKey,
+                'Content-Type': 'application/json'
+            },
+            body: JSON.stringify({ q: query, num: maxResults })
+        });
+        if (!response.ok)
+            throw new Error(`Serper API error: ${response.statusText}`);
+        const data = await response.json();
+        return (data.organic || []).map((item) => ({
+            title: item.title,
+            url: item.link,
+            snippet: item.snippet,
+            position: item.position
+        }));
+    }
+    /**
+     * Search using SerpAPI
+     *
+     * @private
+     * @param {string} query - Search query
+     * @param {number} maxResults - Maximum results
+     * @returns {Promise<SearchResult[]>} Search results
+     */
+    async searchSerpApi(query, maxResults) {
+        const params = new URLSearchParams({
+            q: query,
+            api_key: this.config.serpApiKey,
+            num: maxResults.toString()
+        });
+        const response = await fetch(`https://serpapi.com/search?${params}`);
+        if (!response.ok)
+            throw new Error(`SerpAPI error: ${response.statusText}`);
+        const data = await response.json();
+        return (data.organic_results || []).map((item) => ({
+            title: item.title,
+            url: item.link,
+            snippet: item.snippet,
+            position: item.position
+        }));
+    }
+    /**
+     * Search using Brave Search API
+     *
+     * @private
+     * @param {string} query - Search query
+     * @param {number} maxResults - Maximum results
+     * @returns {Promise<SearchResult[]>} Search results
+     */
+    async searchBrave(query, maxResults) {
+        const params = new URLSearchParams({
+            q: query,
+            count: maxResults.toString()
+        });
+        const response = await fetch(`https://api.search.brave.com/res/v1/web/search?${params}`, {
+            headers: {
+                'X-Subscription-Token': this.config.braveApiKey
+            }
+        });
+        if (!response.ok)
+            throw new Error(`Brave API error: ${response.statusText}`);
+        const data = await response.json();
+        return (data.web?.results || []).map((item, index) => ({
+            title: item.title,
+            url: item.url,
+            snippet: item.description,
+            position: index + 1
+        }));
+    }
+    /**
+     * Search using DuckDuckGo (HTML scraping fallback)
+     *
+     * @private
+     * @param {string} query - Search query
+     * @param {number} maxResults - Maximum results
+     * @param {number} startTime - Request start timestamp
+     * @returns {Promise<ProviderResponse>} Search results
+     */
+    async searchDuckDuckGo(query, maxResults, startTime) {
+        try {
+            const results = await this.searchDuckDuckGoAPI(query, maxResults);
+            return {
+                provider: 'duckduckgo',
+                results,
+                metadata: {
+                    query,
+                    timestamp: new Date().toISOString(),
+                    responseTime: Date.now() - startTime,
+                    fallback: true
+                }
+            };
+        }
+        catch (error) {
+            // Return empty results rather than throwing
+            return {
+                provider: 'duckduckgo',
+                results: [],
+                metadata: {
+                    query,
+                    timestamp: new Date().toISOString(),
+                    responseTime: Date.now() - startTime,
+                    fallback: true
+                }
+            };
+        }
+    }
+    /**
+     * Search using DuckDuckGo instant answer API
+     *
+     * @private
+     * @param {string} query - Search query
+     * @param {number} maxResults - Maximum results
+     * @returns {Promise<SearchResult[]>} Search results
+     */
+    async searchDuckDuckGoAPI(query, maxResults) {
+        // DuckDuckGo instant answer API (limited but free)
+        const params = new URLSearchParams({
+            q: query,
+            format: 'json',
+            no_html: '1',
+            skip_disambig: '1'
+        });
+        const response = await fetch(`https://api.duckduckgo.com/?${params}`);
+        const data = await response.json();
+        const results = [];
+        // Add instant answer if available
+        if (data.AbstractText && data.AbstractURL) {
+            results.push({
+                title: data.Heading || query,
+                url: data.AbstractURL,
+                snippet: data.AbstractText
+            });
+        }
+        // Add related topics
+        if (data.RelatedTopics) {
+            for (const topic of data.RelatedTopics.slice(0, maxResults - 1)) {
+                if (topic.FirstURL && topic.Text) {
+                    results.push({
+                        title: topic.Text.split(' - ')[0] || topic.Text,
+                        url: topic.FirstURL,
+                        snippet: topic.Text
+                    });
+                }
+            }
+        }
+        return results.slice(0, maxResults);
+    }
+    /**
+     * Gets recommended search providers with signup information
+     *
+     * @static
+     * @returns {Array} Array of provider recommendations
+     */
+    static getRecommendedProviders() {
+        return [
+            {
+                name: 'Serper',
+                signupUrl: 'https://serper.dev',
+                freeQuota: '2,500 queries/month',
+                description: 'Google search results API'
+            },
+            {
+                name: 'SerpAPI',
+                signupUrl: 'https://serpapi.com',
+                freeQuota: '100 searches/month',
+                description: 'Multiple search engines API'
+            },
+            {
+                name: 'Brave Search',
+                signupUrl: 'https://brave.com/search-api',
+                freeQuota: '2,000 queries/month',
+                description: 'Privacy-focused search API'
+            },
+            {
+                name: 'DuckDuckGo',
+                signupUrl: 'No signup required',
+                freeQuota: 'Unlimited (rate limited)',
+                description: 'Privacy-focused, no API key needed'
+            }
+        ];
+    }
+}
+exports.SearchProviderService = SearchProviderService;
+//# sourceMappingURL=searchProvider.js.map

package/dist/services/searchProvider.js.map

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

package/dist/tools/factCheck.d.ts

@@ -0,0 +1,99 @@
+import { ITool } from '@framers/agentos';
+import { SearchProviderService } from '../services/searchProvider';
+/**
+ * Fact checking tool that verifies statements against web sources
+ *
+ * @class FactCheckTool
+ * @implements {ITool}
+ *
+ * @example
+ * ```typescript
+ * const tool = new FactCheckTool(searchService);
+ * const result = await tool.execute({
+ *   statement: 'The Earth orbits the Sun',
+ *   checkSources: true,
+ *   confidence: 'high'
+ * });
+ * ```
+ */
+export declare class FactCheckTool implements ITool {
+    private searchService;
+    readonly id = "factCheck";
+    readonly name = "Fact Check";
+    readonly description = "Verify facts and statements against web sources";
+    /**
+     * Creates an instance of FactCheckTool
+     * @param {SearchProviderService} searchService - The search provider service
+     */
+    constructor(searchService: SearchProviderService);
+    /**
+     * Executes fact checking on a statement
+     *
+     * @param {Object} input - The fact check parameters
+     * @param {string} input.statement - The statement to fact-check
+     * @param {boolean} [input.checkSources=true] - Whether to include source citations
+     * @param {string} [input.confidence='medium'] - Required confidence level
+     * @returns {Promise<{success: boolean, output?: any, error?: string}>} Fact check results
+     */
+    execute(input: {
+        statement: string;
+        checkSources?: boolean;
+        confidence?: 'low' | 'medium' | 'high';
+    }): Promise<{
+        success: boolean;
+        output?: any;
+        error?: string;
+    }>;
+    /**
+     * Generates queries for fact-checking a statement
+     *
+     * @private
+     * @param {string} statement - The statement to check
+     * @returns {string[]} Array of search queries
+     */
+    private generateFactCheckQueries;
+    /**
+     * Analyzes search results to determine fact validity
+     *
+     * @private
+     * @param {string} statement - Original statement
+     * @param {any[]} searchResults - Search results to analyze
+     * @param {string} requiredConfidence - Required confidence level
+     * @returns {Object} Analysis results with verdict and confidence
+     */
+    private analyzeFactCheckResults;
+    /**
+     * Checks if confidence level meets requirement
+     *
+     * @private
+     * @param {string} actual - Actual confidence level
+     * @param {string} required - Required confidence level
+     * @returns {boolean} True if requirement is met
+     */
+    private meetsConfidenceRequirement;
+    /**
+     * Compiles relevant sources from search results
+     *
+     * @private
+     * @param {any[]} searchResults - Search results to compile from
+     * @returns {any[]} Compiled sources with metadata
+     */
+    private compileSources;
+    /**
+     * Validates input parameters
+     *
+     * @param {any} input - Input to validate
+     * @returns {{valid: boolean, errors: string[]}} Validation result
+     */
+    validate(input: any): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Returns the JSON schema for the tool's input
+     *
+     * @returns {Object} JSON Schema object
+     */
+    getSchema(): any;
+}
+//# sourceMappingURL=factCheck.d.ts.map

package/dist/tools/factCheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factCheck.d.ts","sourceRoot":"","sources":["../../src/tools/factCheck.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAc,YAAW,KAAK;IAS7B,OAAO,CAAC,aAAa;IARjC,SAAgB,EAAE,eAAe;IACjC,SAAgB,IAAI,gBAAgB;IACpC,SAAgB,WAAW,qDAAqD;IAEhF;;;OAGG;gBACiB,aAAa,EAAE,qBAAqB;IAExD;;;;;;;;OAQG;IACG,OAAO,CAAC,KAAK,EAAE;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,UAAU,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;KACxC,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,GAAG,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAmD/D;;;;;;OAMG;IACH,OAAO,CAAC,wBAAwB;IAUhC;;;;;;;;OAQG;IACH,OAAO,CAAC,uBAAuB;IA2F/B;;;;;;;OAOG;IACH,OAAO,CAAC,0BAA0B;IAKlC;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAwBtB;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,GAAG,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IA2B1D;;;;OAIG;IACH,SAAS,IAAI,GAAG;CAwBjB"}