@framers/agentos-ext-web-search 1.1.0

package/dist/tools/factCheck.js

@@ -0,0 +1,287 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FactCheckTool = void 0;
+/**
+ * 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'
+ * });
+ * ```
+ */
+class FactCheckTool {
+    searchService;
+    id = 'factCheck';
+    name = 'Fact Check';
+    description = 'Verify facts and statements against web sources';
+    /**
+     * Creates an instance of FactCheckTool
+     * @param {SearchProviderService} searchService - The search provider service
+     */
+    constructor(searchService) {
+        this.searchService = searchService;
+    }
+    /**
+     * 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
+     */
+    async execute(input) {
+        try {
+            const checkSources = input.checkSources !== false;
+            const requiredConfidence = input.confidence || 'medium';
+            // Search for information about the statement
+            const queries = this.generateFactCheckQueries(input.statement);
+            // Perform searches in parallel
+            const searchPromises = queries.map(query => this.searchService.search(query, { maxResults: 5 })
+                .catch(err => ({
+                provider: 'error',
+                results: [],
+                metadata: { query, error: err.message, timestamp: new Date().toISOString() }
+            })));
+            const searchResults = await Promise.all(searchPromises);
+            // Analyze results for fact verification
+            const analysis = this.analyzeFactCheckResults(input.statement, searchResults, requiredConfidence);
+            // Compile sources if requested
+            const sources = checkSources ? this.compileSources(searchResults) : [];
+            return {
+                success: true,
+                output: {
+                    statement: input.statement,
+                    verdict: analysis.verdict,
+                    confidence: analysis.confidence,
+                    explanation: analysis.explanation,
+                    sources: sources,
+                    contradictingSources: analysis.contradictingSources,
+                    supportingSources: analysis.supportingSources,
+                    timestamp: new Date().toISOString()
+                }
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error.message
+            };
+        }
+    }
+    /**
+     * Generates queries for fact-checking a statement
+     *
+     * @private
+     * @param {string} statement - The statement to check
+     * @returns {string[]} Array of search queries
+     */
+    generateFactCheckQueries(statement) {
+        return [
+            statement, // Original statement
+            `"${statement}" fact check`, // Exact match with fact check
+            `${statement} true or false`, // Truth verification
+            `${statement} debunked myths`, // Check for debunking
+            `is it true that ${statement}` // Question format
+        ];
+    }
+    /**
+     * 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
+     */
+    analyzeFactCheckResults(statement, searchResults, requiredConfidence) {
+        let supportingCount = 0;
+        let contradictingCount = 0;
+        let neutralCount = 0;
+        const supportingSources = [];
+        const contradictingSources = [];
+        const statementLower = statement.toLowerCase();
+        const negativeIndicators = ['false', 'myth', 'debunked', 'incorrect', 'wrong', 'not true', 'fake'];
+        const positiveIndicators = ['true', 'correct', 'accurate', 'confirmed', 'verified', 'fact'];
+        for (const searchResult of searchResults) {
+            if (!searchResult.results)
+                continue;
+            for (const result of searchResult.results) {
+                const contentLower = (result.title + ' ' + result.snippet).toLowerCase();
+                // Check for fact-checking sites
+                const isFactCheckSite = result.url.includes('snopes') ||
+                    result.url.includes('factcheck') ||
+                    result.url.includes('politifact');
+                const weight = isFactCheckSite ? 2 : 1; // Give more weight to fact-checking sites
+                // Analyze sentiment toward the statement
+                let hasNegative = negativeIndicators.some(ind => contentLower.includes(ind));
+                let hasPositive = positiveIndicators.some(ind => contentLower.includes(ind));
+                if (hasNegative && !hasPositive) {
+                    contradictingCount += weight;
+                    contradictingSources.push(result.url);
+                }
+                else if (hasPositive && !hasNegative) {
+                    supportingCount += weight;
+                    supportingSources.push(result.url);
+                }
+                else {
+                    neutralCount += 1;
+                }
+            }
+        }
+        // Calculate confidence and verdict
+        const total = supportingCount + contradictingCount + neutralCount;
+        let confidence;
+        let verdict;
+        let explanation;
+        if (total === 0) {
+            verdict = 'UNVERIFIED';
+            confidence = 0;
+            explanation = 'No relevant sources found to verify this statement.';
+        }
+        else {
+            const supportRatio = supportingCount / total;
+            const contradictRatio = contradictingCount / total;
+            if (supportRatio > 0.7) {
+                verdict = 'TRUE';
+                confidence = supportRatio * 100;
+                explanation = `Strong evidence supports this statement (${supportingCount} supporting sources).`;
+            }
+            else if (contradictRatio > 0.7) {
+                verdict = 'FALSE';
+                confidence = contradictRatio * 100;
+                explanation = `Strong evidence contradicts this statement (${contradictingCount} contradicting sources).`;
+            }
+            else if (supportRatio > 0.4 && contradictRatio > 0.4) {
+                verdict = 'PARTIALLY TRUE';
+                confidence = 50;
+                explanation = `Mixed evidence with both supporting and contradicting sources.`;
+            }
+            else {
+                verdict = 'UNVERIFIED';
+                confidence = Math.max(supportRatio, contradictRatio) * 100;
+                explanation = `Insufficient clear evidence to verify this statement.`;
+            }
+        }
+        // Adjust confidence based on required level
+        const confidenceLevel = confidence > 80 ? 'high' : confidence > 50 ? 'medium' : 'low';
+        return {
+            verdict,
+            confidence: Math.round(confidence),
+            confidenceLevel,
+            explanation,
+            supportingSources: supportingSources.slice(0, 5),
+            contradictingSources: contradictingSources.slice(0, 5),
+            meetsRequiredConfidence: this.meetsConfidenceRequirement(confidenceLevel, requiredConfidence)
+        };
+    }
+    /**
+     * 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
+     */
+    meetsConfidenceRequirement(actual, required) {
+        const levels = { low: 1, medium: 2, high: 3 };
+        return levels[actual] >= levels[required];
+    }
+    /**
+     * Compiles relevant sources from search results
+     *
+     * @private
+     * @param {any[]} searchResults - Search results to compile from
+     * @returns {any[]} Compiled sources with metadata
+     */
+    compileSources(searchResults) {
+        const sources = [];
+        const seenUrls = new Set();
+        for (const searchResult of searchResults) {
+            if (!searchResult.results)
+                continue;
+            for (const result of searchResult.results) {
+                if (seenUrls.has(result.url))
+                    continue;
+                seenUrls.add(result.url);
+                sources.push({
+                    title: result.title,
+                    url: result.url,
+                    snippet: result.snippet,
+                    provider: searchResult.provider,
+                    query: searchResult.metadata.query
+                });
+            }
+        }
+        return sources.slice(0, 10); // Limit to top 10 sources
+    }
+    /**
+     * Validates input parameters
+     *
+     * @param {any} input - Input to validate
+     * @returns {{valid: boolean, errors: string[]}} Validation result
+     */
+    validate(input) {
+        const errors = [];
+        if (!input.statement) {
+            errors.push('Statement is required');
+        }
+        else if (typeof input.statement !== 'string') {
+            errors.push('Statement must be a string');
+        }
+        else if (input.statement.length < 5) {
+            errors.push('Statement must be at least 5 characters long');
+        }
+        if (input.confidence !== undefined) {
+            if (!['low', 'medium', 'high'].includes(input.confidence)) {
+                errors.push('Confidence must be low, medium, or high');
+            }
+        }
+        if (input.checkSources !== undefined && typeof input.checkSources !== 'boolean') {
+            errors.push('checkSources must be a boolean');
+        }
+        return {
+            valid: errors.length === 0,
+            errors
+        };
+    }
+    /**
+     * Returns the JSON schema for the tool's input
+     *
+     * @returns {Object} JSON Schema object
+     */
+    getSchema() {
+        return {
+            type: 'object',
+            required: ['statement'],
+            properties: {
+                statement: {
+                    type: 'string',
+                    description: 'The statement to fact-check',
+                    minLength: 5
+                },
+                checkSources: {
+                    type: 'boolean',
+                    description: 'Whether to include source citations',
+                    default: true
+                },
+                confidence: {
+                    type: 'string',
+                    description: 'Required confidence level for the verdict',
+                    enum: ['low', 'medium', 'high'],
+                    default: 'medium'
+                }
+            }
+        };
+    }
+}
+exports.FactCheckTool = FactCheckTool;
+//# sourceMappingURL=factCheck.js.map

package/dist/tools/factCheck.js.map

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

package/dist/tools/researchAggregator.d.ts

@@ -0,0 +1,101 @@
+import { ITool } from '@framers/agentos';
+import { SearchProviderService } from '../services/searchProvider';
+/**
+ * Research aggregator tool that performs multiple searches and synthesizes results
+ *
+ * @class ResearchAggregatorTool
+ * @implements {ITool}
+ *
+ * @example
+ * ```typescript
+ * const tool = new ResearchAggregatorTool(searchService);
+ * const result = await tool.execute({
+ *   topic: 'AI safety research',
+ *   sources: 3,
+ *   depth: 'comprehensive'
+ * });
+ * ```
+ */
+export declare class ResearchAggregatorTool implements ITool {
+    private searchService;
+    readonly id = "researchAggregator";
+    readonly name = "Research Aggregator";
+    readonly description = "Aggregate research from multiple searches on a topic";
+    /**
+     * Creates an instance of ResearchAggregatorTool
+     * @param {SearchProviderService} searchService - The search provider service
+     */
+    constructor(searchService: SearchProviderService);
+    /**
+     * Executes research aggregation on a topic
+     *
+     * @param {Object} input - The research parameters
+     * @param {string} input.topic - The research topic
+     * @param {number} [input.sources=3] - Number of different search angles to explore
+     * @param {string} [input.depth='moderate'] - Research depth (quick, moderate, comprehensive)
+     * @returns {Promise<{success: boolean, output?: any, error?: string}>} Aggregated research results
+     */
+    execute(input: {
+        topic: string;
+        sources?: number;
+        depth?: 'quick' | 'moderate' | 'comprehensive';
+    }): Promise<{
+        success: boolean;
+        output?: any;
+        error?: string;
+    }>;
+    /**
+     * Generates diverse search queries for comprehensive research
+     *
+     * @private
+     * @param {string} topic - The research topic
+     * @param {number} count - Number of queries to generate
+     * @param {string} depth - Research depth level
+     * @returns {string[]} Array of search queries
+     */
+    private generateSearchQueries;
+    /**
+     * Aggregates and deduplicates search results
+     *
+     * @private
+     * @param {any[]} searchResults - Array of search results from different queries
+     * @param {string} topic - The original research topic
+     * @returns {Object} Aggregated and organized results
+     */
+    private aggregateResults;
+    /**
+     * Calculates relevance score for a search result
+     *
+     * @private
+     * @param {any} result - Search result object
+     * @param {string} topic - Original topic for comparison
+     * @returns {number} Relevance score (0-100)
+     */
+    private calculateRelevance;
+    /**
+     * Gets top results across all categories
+     *
+     * @private
+     * @param {any} categories - Categorized results
+     * @param {number} count - Number of top results to return
+     * @returns {any[]} Top results by relevance
+     */
+    private getTopResults;
+    /**
+     * 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=researchAggregator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"researchAggregator.d.ts","sourceRoot":"","sources":["../../src/tools/researchAggregator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,sBAAuB,YAAW,KAAK;IAStC,OAAO,CAAC,aAAa;IARjC,SAAgB,EAAE,wBAAwB;IAC1C,SAAgB,IAAI,yBAAyB;IAC7C,SAAgB,WAAW,0DAA0D;IAErF;;;OAGG;gBACiB,aAAa,EAAE,qBAAqB;IAExD;;;;;;;;OAQG;IACG,OAAO,CAAC,KAAK,EAAE;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,eAAe,CAAC;KAChD,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,GAAG,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IA2C/D;;;;;;;;OAQG;IACH,OAAO,CAAC,qBAAqB;IA6B7B;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAoDxB;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;IAYrB;;;;;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;CAyBjB"}

package/dist/tools/researchAggregator.js

@@ -0,0 +1,275 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResearchAggregatorTool = void 0;
+/**
+ * Research aggregator tool that performs multiple searches and synthesizes results
+ *
+ * @class ResearchAggregatorTool
+ * @implements {ITool}
+ *
+ * @example
+ * ```typescript
+ * const tool = new ResearchAggregatorTool(searchService);
+ * const result = await tool.execute({
+ *   topic: 'AI safety research',
+ *   sources: 3,
+ *   depth: 'comprehensive'
+ * });
+ * ```
+ */
+class ResearchAggregatorTool {
+    searchService;
+    id = 'researchAggregator';
+    name = 'Research Aggregator';
+    description = 'Aggregate research from multiple searches on a topic';
+    /**
+     * Creates an instance of ResearchAggregatorTool
+     * @param {SearchProviderService} searchService - The search provider service
+     */
+    constructor(searchService) {
+        this.searchService = searchService;
+    }
+    /**
+     * Executes research aggregation on a topic
+     *
+     * @param {Object} input - The research parameters
+     * @param {string} input.topic - The research topic
+     * @param {number} [input.sources=3] - Number of different search angles to explore
+     * @param {string} [input.depth='moderate'] - Research depth (quick, moderate, comprehensive)
+     * @returns {Promise<{success: boolean, output?: any, error?: string}>} Aggregated research results
+     */
+    async execute(input) {
+        try {
+            const sources = input.sources || 3;
+            const depth = input.depth || 'moderate';
+            // Generate different search queries for comprehensive coverage
+            const queries = this.generateSearchQueries(input.topic, sources, depth);
+            // Perform searches in parallel
+            const searchPromises = queries.map(query => this.searchService.search(query, {
+                maxResults: depth === 'quick' ? 5 : depth === 'moderate' ? 10 : 15
+            }).catch(err => ({
+                provider: 'error',
+                results: [],
+                metadata: { query, error: err.message, timestamp: new Date().toISOString() }
+            })));
+            const searchResults = await Promise.all(searchPromises);
+            // Aggregate and deduplicate results
+            const aggregated = this.aggregateResults(searchResults, input.topic);
+            return {
+                success: true,
+                output: {
+                    topic: input.topic,
+                    sources: sources,
+                    depth: depth,
+                    queries: queries,
+                    aggregatedResults: aggregated,
+                    timestamp: new Date().toISOString()
+                }
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error.message
+            };
+        }
+    }
+    /**
+     * Generates diverse search queries for comprehensive research
+     *
+     * @private
+     * @param {string} topic - The research topic
+     * @param {number} count - Number of queries to generate
+     * @param {string} depth - Research depth level
+     * @returns {string[]} Array of search queries
+     */
+    generateSearchQueries(topic, count, depth) {
+        const queries = [topic]; // Start with the original topic
+        const modifiers = {
+            quick: ['overview', 'summary'],
+            moderate: ['overview', 'recent developments', 'key concepts', 'applications'],
+            comprehensive: [
+                'overview',
+                'recent research',
+                'state of the art',
+                'challenges',
+                'future directions',
+                'industry applications',
+                'academic papers',
+                'expert opinions'
+            ]
+        };
+        const selectedModifiers = modifiers[depth];
+        for (let i = 1; i < Math.min(count, selectedModifiers.length + 1); i++) {
+            if (selectedModifiers[i - 1]) {
+                queries.push(`${topic} ${selectedModifiers[i - 1]}`);
+            }
+        }
+        return queries;
+    }
+    /**
+     * Aggregates and deduplicates search results
+     *
+     * @private
+     * @param {any[]} searchResults - Array of search results from different queries
+     * @param {string} topic - The original research topic
+     * @returns {Object} Aggregated and organized results
+     */
+    aggregateResults(searchResults, topic) {
+        const seenUrls = new Set();
+        const categories = {
+            overview: [],
+            research: [],
+            applications: [],
+            resources: []
+        };
+        for (const searchResult of searchResults) {
+            if (!searchResult.results)
+                continue;
+            for (const result of searchResult.results) {
+                // Skip duplicates
+                if (seenUrls.has(result.url))
+                    continue;
+                seenUrls.add(result.url);
+                // Categorize based on content
+                const lowerTitle = result.title.toLowerCase();
+                const lowerSnippet = result.snippet.toLowerCase();
+                if (lowerTitle.includes('overview') || lowerTitle.includes('introduction') ||
+                    lowerTitle.includes('what is')) {
+                    categories.overview.push(result);
+                }
+                else if (lowerTitle.includes('research') || lowerTitle.includes('study') ||
+                    lowerTitle.includes('paper') || lowerTitle.includes('journal')) {
+                    categories.research.push(result);
+                }
+                else if (lowerTitle.includes('application') || lowerTitle.includes('use case') ||
+                    lowerTitle.includes('implementation')) {
+                    categories.applications.push(result);
+                }
+                else {
+                    categories.resources.push(result);
+                }
+            }
+        }
+        // Calculate relevance scores
+        const scoredCategories = Object.entries(categories).reduce((acc, [key, items]) => {
+            acc[key] = items.map((item) => ({
+                ...item,
+                relevanceScore: this.calculateRelevance(item, topic)
+            })).sort((a, b) => b.relevanceScore - a.relevanceScore);
+            return acc;
+        }, {});
+        return {
+            categories: scoredCategories,
+            totalResults: seenUrls.size,
+            topResults: this.getTopResults(scoredCategories, 10)
+        };
+    }
+    /**
+     * Calculates relevance score for a search result
+     *
+     * @private
+     * @param {any} result - Search result object
+     * @param {string} topic - Original topic for comparison
+     * @returns {number} Relevance score (0-100)
+     */
+    calculateRelevance(result, topic) {
+        let score = 50; // Base score
+        const topicWords = topic.toLowerCase().split(/\s+/);
+        const titleWords = result.title.toLowerCase();
+        const snippetWords = result.snippet.toLowerCase();
+        // Check title relevance
+        for (const word of topicWords) {
+            if (titleWords.includes(word))
+                score += 15;
+            if (snippetWords.includes(word))
+                score += 5;
+        }
+        // Boost for certain indicators
+        if (titleWords.includes('official'))
+            score += 10;
+        if (titleWords.includes('guide'))
+            score += 5;
+        if (titleWords.includes('tutorial'))
+            score += 5;
+        return Math.min(100, score);
+    }
+    /**
+     * Gets top results across all categories
+     *
+     * @private
+     * @param {any} categories - Categorized results
+     * @param {number} count - Number of top results to return
+     * @returns {any[]} Top results by relevance
+     */
+    getTopResults(categories, count) {
+        const allResults = [];
+        for (const items of Object.values(categories)) {
+            allResults.push(...items);
+        }
+        return allResults
+            .sort((a, b) => b.relevanceScore - a.relevanceScore)
+            .slice(0, count);
+    }
+    /**
+     * Validates input parameters
+     *
+     * @param {any} input - Input to validate
+     * @returns {{valid: boolean, errors: string[]}} Validation result
+     */
+    validate(input) {
+        const errors = [];
+        if (!input.topic) {
+            errors.push('Topic is required');
+        }
+        else if (typeof input.topic !== 'string') {
+            errors.push('Topic must be a string');
+        }
+        if (input.sources !== undefined) {
+            if (typeof input.sources !== 'number' || input.sources < 1 || input.sources > 10) {
+                errors.push('Sources must be a number between 1 and 10');
+            }
+        }
+        if (input.depth !== undefined) {
+            if (!['quick', 'moderate', 'comprehensive'].includes(input.depth)) {
+                errors.push('Depth must be quick, moderate, or comprehensive');
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors
+        };
+    }
+    /**
+     * Returns the JSON schema for the tool's input
+     *
+     * @returns {Object} JSON Schema object
+     */
+    getSchema() {
+        return {
+            type: 'object',
+            required: ['topic'],
+            properties: {
+                topic: {
+                    type: 'string',
+                    description: 'The research topic to aggregate information about'
+                },
+                sources: {
+                    type: 'number',
+                    description: 'Number of different search angles to explore',
+                    default: 3,
+                    minimum: 1,
+                    maximum: 10
+                },
+                depth: {
+                    type: 'string',
+                    description: 'Research depth level',
+                    enum: ['quick', 'moderate', 'comprehensive'],
+                    default: 'moderate'
+                }
+            }
+        };
+    }
+}
+exports.ResearchAggregatorTool = ResearchAggregatorTool;
+//# sourceMappingURL=researchAggregator.js.map