@framers/agentos-ext-web-search 1.1.0 → 1.1.1

package/dist/tools/researchAggregator.js

@@ -1,90 +1,133 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ResearchAggregatorTool = void 0;
 /**
- * Research aggregator tool that performs multiple searches and synthesizes results
+ * Research Aggregator Tool — runs multiple searches on a topic and aggregates results.
  *
- * @class ResearchAggregatorTool
- * @implements {ITool}
+ * Updated to conform to AgentOS `ITool` (inputSchema + ToolExecutionContext).
  *
- * @example
- * ```typescript
- * const tool = new ResearchAggregatorTool(searchService);
- * const result = await tool.execute({
- *   topic: 'AI safety research',
- *   sources: 3,
- *   depth: 'comprehensive'
- * });
- * ```
+ * @module @framers/agentos-ext-web-search
  */
-class ResearchAggregatorTool {
+export 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) {
+    defaultMultiSearch;
+    id = 'research-aggregator-v1';
+    /** Tool call name used by the LLM / ToolExecutor. */
+    name = 'research_aggregate';
+    displayName = 'Research Aggregator';
+    description = 'Aggregate research from multiple web searches on a topic (deduplicated + categorized).';
+    category = 'research';
+    hasSideEffects = false;
+    inputSchema = {
+        type: 'object',
+        required: ['topic'],
+        properties: {
+            topic: {
+                type: 'string',
+                description: 'The research topic to aggregate information about',
+            },
+            sources: {
+                type: 'integer',
+                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',
+            },
+            multiSearch: {
+                type: 'boolean',
+                description: 'When true, each search query fans out to ALL available providers in parallel, returning merged and deduplicated results ranked by cross-provider agreement.',
+                default: false,
+            },
+        },
+        additionalProperties: false,
+    };
+    requiredCapabilities = ['capability:web_search'];
+    constructor(searchService, defaultMultiSearch = false) {
         this.searchService = searchService;
+        this.defaultMultiSearch = defaultMultiSearch;
     }
-    /**
-     * 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) {
+    async execute(input, _context) {
         try {
             const sources = input.sources || 3;
             const depth = input.depth || 'moderate';
-            // Generate different search queries for comprehensive coverage
+            const useMultiSearch = input.multiSearch ?? this.defaultMultiSearch;
             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);
+            const perQueryMaxResults = depth === 'quick' ? 5 : depth === 'moderate' ? 10 : 15;
+            let searchResults;
+            if (useMultiSearch) {
+                // Fan out each query to ALL providers in parallel, then normalize into ProviderResponse shape
+                const multiPromises = queries.map((query) => this.searchService
+                    .multiSearch(query, { maxResults: perQueryMaxResults })
+                    .then((multi) => ({
+                    provider: 'multi',
+                    results: multi.results,
+                    metadata: { query, timestamp: multi.metadata.timestamp },
+                }))
+                    .catch((err) => ({
+                    provider: 'error',
+                    results: [],
+                    metadata: { query, error: err?.message || String(err), timestamp: new Date().toISOString() },
+                })));
+                searchResults = (await Promise.all(multiPromises));
+            }
+            else {
+                const searchPromises = queries.map((query) => this.searchService
+                    .search(query, { maxResults: perQueryMaxResults })
+                    .catch((err) => ({
+                    provider: 'error',
+                    results: [],
+                    metadata: { query, error: err?.message || String(err), timestamp: new Date().toISOString() },
+                })));
+                searchResults = (await Promise.all(searchPromises));
+            }
+            const aggregatedResults = this.aggregateResults(searchResults, input.topic);
             return {
                 success: true,
                 output: {
                     topic: input.topic,
-                    sources: sources,
-                    depth: depth,
-                    queries: queries,
-                    aggregatedResults: aggregated,
-                    timestamp: new Date().toISOString()
-                }
+                    sources,
+                    depth,
+                    queries,
+                    aggregatedResults,
+                    timestamp: new Date().toISOString(),
+                },
             };
         }
         catch (error) {
-            return {
-                success: false,
-                error: error.message
-            };
+            return { success: false, error: error?.message || String(error) };
         }
     }
-    /**
-     * 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
-     */
+    validateArgs(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');
+            }
+        }
+        if (input.multiSearch !== undefined && typeof input.multiSearch !== 'boolean') {
+            errors.push('multiSearch must be a boolean');
+        }
+        return errors.length === 0 ? { isValid: true } : { isValid: false, errors };
+    }
+    // ============================================================================
+    // Internals (ported from the previous implementation)
+    // ============================================================================
     generateSearchQueries(topic, count, depth) {
-        const queries = [topic]; // Start with the original topic
+        const queries = [topic];
         const modifiers = {
             quick: ['overview', 'summary'],
             moderate: ['overview', 'recent developments', 'key concepts', 'applications'],
@@ -96,8 +139,8 @@ class ResearchAggregatorTool {
                 'future directions',
                 'industry applications',
                 'academic papers',
-                'expert opinions'
-            ]
+                'expert opinions',
+            ],
         };
         const selectedModifiers = modifiers[depth];
         for (let i = 1; i < Math.min(count, selectedModifiers.length + 1); i++) {
@@ -107,42 +150,33 @@ class ResearchAggregatorTool {
         }
         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: []
+            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')) {
+                const lowerTitle = String(result.title || '').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')) {
+                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') ||
+                else if (lowerTitle.includes('application') ||
+                    lowerTitle.includes('use case') ||
                     lowerTitle.includes('implementation')) {
                     categories.applications.push(result);
                 }
@@ -151,125 +185,50 @@ class ResearchAggregatorTool {
                 }
             }
         }
-        // Calculate relevance scores
         const scoredCategories = Object.entries(categories).reduce((acc, [key, items]) => {
-            acc[key] = items.map((item) => ({
+            acc[key] = items
+                .map((item) => ({
                 ...item,
-                relevanceScore: this.calculateRelevance(item, topic)
-            })).sort((a, b) => b.relevanceScore - a.relevanceScore);
+                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)
+            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
+        let score = 50;
         const topicWords = topic.toLowerCase().split(/\s+/);
-        const titleWords = result.title.toLowerCase();
-        const snippetWords = result.snippet.toLowerCase();
-        // Check title relevance
+        const titleWords = String(result.title || '').toLowerCase();
+        const snippetWords = String(result.snippet || '').toLowerCase();
         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;
+        // Bonus for multi-search results with cross-provider agreement
+        if (typeof result.confidenceScore === 'number') {
+            score += (result.confidenceScore / 100) * 20;
+        }
         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'
-                }
-            }
-        };
+        return allResults.sort((a, b) => b.relevanceScore - a.relevanceScore).slice(0, count);
     }
 }
-exports.ResearchAggregatorTool = ResearchAggregatorTool;
 //# sourceMappingURL=researchAggregator.js.map

package/dist/tools/researchAggregator.js.map

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

package/dist/tools/webSearch.d.ts

@@ -1,66 +1,38 @@
-import { ITool } from '@framers/agentos';
-import { SearchProviderService } from '../services/searchProvider';
 /**
- * Web search tool that queries multiple search providers
+ * Web Search Tool — multi-provider search via SearchProviderService.
  *
- * @class WebSearchTool
- * @implements {ITool}
+ * Updated to conform to AgentOS `ITool` (inputSchema + ToolExecutionContext).
  *
- * @example
- * ```typescript
- * const tool = new WebSearchTool(searchService);
- * const result = await tool.execute({
- *   query: 'AgentOS extensions',
- *   maxResults: 10,
- *   provider: 'serper'
- * });
- * ```
+ * @module @framers/agentos-ext-web-search
  */
-export declare class WebSearchTool implements ITool {
-    private searchService;
-    readonly id = "webSearch";
-    readonly name = "Web Search";
-    readonly description = "Search the web using multiple providers";
-    /**
-     * Creates an instance of WebSearchTool
-     * @param {SearchProviderService} searchService - The search provider service
-     */
-    constructor(searchService: SearchProviderService);
-    /**
-     * Executes a web search query
-     *
-     * @param {Object} input - The search parameters
-     * @param {string} input.query - The search query string
-     * @param {number} [input.maxResults=10] - Maximum number of results to return
-     * @param {string} [input.provider] - Specific provider to use (serper, serpapi, brave, duckduckgo)
-     * @returns {Promise<{success: boolean, output?: any, error?: string}>} The search results
-     *
-     * @throws {Error} Throws if all providers fail
-     */
-    execute(input: {
-        query: string;
-        maxResults?: number;
-        provider?: 'serper' | 'serpapi' | 'brave' | 'duckduckgo';
-    }): Promise<{
-        success: boolean;
-        output?: any;
-        error?: string;
-    }>;
-    /**
-     * Validates input parameters for the web search
-     *
-     * @param {any} input - The input to validate
-     * @returns {{valid: boolean, errors: string[]}} Validation result
-     */
-    validate(input: any): {
-        valid: boolean;
-        errors: string[];
+import type { ITool, JSONSchemaObject, ToolExecutionContext, ToolExecutionResult } from '@framers/agentos';
+import type { ProviderResponse, MultiSearchResponse } from '../services/searchProvider.js';
+import { SearchProviderService } from '../services/searchProvider.js';
+export interface WebSearchInput {
+    query: string;
+    maxResults?: number;
+    provider?: 'serper' | 'serpapi' | 'brave' | 'searxng' | 'duckduckgo';
+    multiSearch?: boolean;
+    category?: string;
+}
+export type WebSearchOutput = ProviderResponse | MultiSearchResponse;
+export declare class WebSearchTool implements ITool<WebSearchInput, WebSearchOutput> {
+    private readonly searchService;
+    private readonly defaultMultiSearch;
+    readonly id = "web-search-v1";
+    /** Tool call name used by the LLM / ToolExecutor. */
+    readonly name = "web_search";
+    readonly displayName = "Web Search";
+    readonly description = "Search the web using multiple providers (Serper, SerpAPI, Brave, SearXNG, DuckDuckGo fallback). Set multiSearch=true to query ALL providers in parallel for higher-confidence, deduplicated results.";
+    readonly category = "research";
+    readonly hasSideEffects = false;
+    readonly inputSchema: JSONSchemaObject;
+    readonly requiredCapabilities: string[];
+    constructor(searchService: SearchProviderService, defaultMultiSearch?: boolean);
+    execute(input: WebSearchInput, _context: ToolExecutionContext): Promise<ToolExecutionResult<WebSearchOutput>>;
+    validateArgs(input: Record<string, any>): {
+        isValid: boolean;
+        errors?: any[];
     };
-    /**
-     * Returns the JSON schema for the tool's input
-     *
-     * @returns {Object} JSON Schema object
-     */
-    getSchema(): any;
 }
 //# sourceMappingURL=webSearch.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"webSearch.d.ts","sourceRoot":"","sources":["../../src/tools/webSearch.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,6CAA6C;IAExE;;;OAGG;gBACiB,aAAa,EAAE,qBAAqB;IAExD;;;;;;;;;;OAUG;IACG,OAAO,CAAC,KAAK,EAAE;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,YAAY,CAAC;KAC1D,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,GAAG,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAmB/D;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,GAAG,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IA4B1D;;;;OAIG;IACH,SAAS,IAAI,GAAG;CAwBjB"}
+{"version":3,"file":"webSearch.d.ts","sourceRoot":"","sources":["../../src/tools/webSearch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC3G,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAC3F,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,CAAC;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG,mBAAmB,CAAC;AAErE,qBAAa,aAAc,YAAW,KAAK,CAAC,cAAc,EAAE,eAAe,CAAC;IAgDxE,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAhDrC,SAAgB,EAAE,mBAAmB;IACrC,qDAAqD;IACrD,SAAgB,IAAI,gBAAgB;IACpC,SAAgB,WAAW,gBAAgB;IAC3C,SAAgB,WAAW,0MAC8K;IACzM,SAAgB,QAAQ,cAAc;IACtC,SAAgB,cAAc,SAAS;IAEvC,SAAgB,WAAW,EAAE,gBAAgB,CAiC3C;IAEF,SAAgB,oBAAoB,WAA6B;gBAG9C,aAAa,EAAE,qBAAqB,EACpC,kBAAkB,GAAE,OAAe;IAGhD,OAAO,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAAC;IAsBnH,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAA;KAAE;CAgC/E"}