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

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":"AACA;;;;;;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;IA4BnH,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"}

package/dist/tools/webSearch.js

@@ -1,70 +1,86 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WebSearchTool = void 0;
+// @ts-nocheck
 /**
- * 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
  */
-class WebSearchTool {
+export class WebSearchTool {
     searchService;
-    id = 'webSearch';
-    name = 'Web Search';
-    description = 'Search the web using multiple providers';
-    /**
-     * Creates an instance of WebSearchTool
-     * @param {SearchProviderService} searchService - The search provider service
-     */
-    constructor(searchService) {
+    defaultMultiSearch;
+    id = 'web-search-v1';
+    /** Tool call name used by the LLM / ToolExecutor. */
+    name = 'web_search';
+    displayName = 'Web Search';
+    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.';
+    category = 'research';
+    hasSideEffects = false;
+    inputSchema = {
+        type: 'object',
+        required: ['query'],
+        properties: {
+            query: {
+                type: 'string',
+                description: 'The search query',
+            },
+            maxResults: {
+                type: 'integer',
+                description: 'Maximum number of results to return',
+                default: 10,
+                minimum: 1,
+                maximum: 50,
+            },
+            provider: {
+                type: 'string',
+                description: 'Specific search provider to use (ignored when multiSearch is true)',
+                enum: ['serper', 'serpapi', 'brave', 'searxng', 'duckduckgo'],
+            },
+            multiSearch: {
+                type: 'boolean',
+                description: 'When true, searches ALL available providers in parallel and returns merged, deduplicated results ranked by cross-provider agreement. Useful for deep research or fact verification.',
+                default: false,
+            },
+            category: {
+                type: 'string',
+                description: 'Search category (SearXNG only). Options: general, news, images, videos, it, science, files, social_media',
+                enum: ['general', 'news', 'images', 'videos', 'it', 'science', 'files', 'social_media'],
+            },
+        },
+        additionalProperties: false,
+    };
+    requiredCapabilities = ['capability:web_search'];
+    constructor(searchService, defaultMultiSearch = false) {
         this.searchService = searchService;
+        this.defaultMultiSearch = defaultMultiSearch;
     }
-    /**
-     * 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
-     */
-    async execute(input) {
+    async execute(input, _context) {
+        if (!this.searchService) {
+            return {
+                success: false,
+                error: 'Search service not initialized. Try using browser_navigate to search directly, or set a search API key (SERPER_API_KEY, BRAVE_API_KEY).',
+            };
+        }
         try {
+            const useMultiSearch = input.multiSearch ?? this.defaultMultiSearch;
+            if (useMultiSearch && !input.provider) {
+                const results = await this.searchService.multiSearch(input.query, {
+                    maxResults: input.maxResults || 10,
+                });
+                return { success: true, output: results };
+            }
             const results = await this.searchService.search(input.query, {
                 maxResults: input.maxResults || 10,
-                provider: input.provider
+                provider: input.provider,
+                category: input.category,
             });
-            return {
-                success: true,
-                output: results
-            };
+            return { success: true, output: results };
         }
         catch (error) {
-            return {
-                success: false,
-                error: error.message
-            };
+            return { success: false, error: error?.message || String(error) };
         }
     }
-    /**
-     * Validates input parameters for the web search
-     *
-     * @param {any} input - The input to validate
-     * @returns {{valid: boolean, errors: string[]}} Validation result
-     */
-    validate(input) {
+    validateArgs(input) {
         const errors = [];
         if (!input.query) {
             errors.push('Query is required');
@@ -78,45 +94,18 @@ class WebSearchTool {
             }
         }
         if (input.provider !== undefined) {
-            const validProviders = ['serper', 'serpapi', 'brave', 'duckduckgo'];
+            const validProviders = ['serper', 'serpapi', 'brave', 'searxng', 'duckduckgo'];
             if (!validProviders.includes(input.provider)) {
                 errors.push('Invalid provider');
             }
         }
-        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: ['query'],
-            properties: {
-                query: {
-                    type: 'string',
-                    description: 'The search query'
-                },
-                maxResults: {
-                    type: 'number',
-                    description: 'Maximum number of results to return',
-                    default: 10,
-                    minimum: 1,
-                    maximum: 50
-                },
-                provider: {
-                    type: 'string',
-                    description: 'Specific search provider to use',
-                    enum: ['serper', 'serpapi', 'brave', 'duckduckgo']
-                }
-            }
-        };
+        if (input.multiSearch !== undefined && typeof input.multiSearch !== 'boolean') {
+            errors.push('multiSearch must be a boolean');
+        }
+        if (input.multiSearch && input.provider) {
+            errors.push('Cannot specify both multiSearch and a specific provider');
+        }
+        return errors.length === 0 ? { isValid: true } : { isValid: false, errors };
     }
 }
-exports.WebSearchTool = WebSearchTool;
 //# sourceMappingURL=webSearch.js.map

package/dist/tools/webSearch.js.map

@@ -1 +1 @@
-{"version":3,"file":"webSearch.js","sourceRoot":"","sources":["../../src/tools/webSearch.ts"],"names":[],"mappings":";;;AAGA;;;;;;;;;;;;;;;GAeG;AACH,MAAa,aAAa;IASJ;IARJ,EAAE,GAAG,WAAW,CAAC;IACjB,IAAI,GAAG,YAAY,CAAC;IACpB,WAAW,GAAG,yCAAyC,CAAC;IAExE;;;OAGG;IACH,YAAoB,aAAoC;QAApC,kBAAa,GAAb,aAAa,CAAuB;IAAG,CAAC;IAE5D;;;;;;;;;;OAUG;IACH,KAAK,CAAC,OAAO,CAAC,KAIb;QACC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE;gBAC3D,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,EAAE;gBAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ;aACzB,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,OAAO;aAChB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,CAAC,OAAO;aACrB,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,KAAU;QACjB,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACnC,CAAC;aAAM,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC3C,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACxC,CAAC;QAED,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACnC,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,EAAE,CAAC;gBAClE,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;YACpE,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC7C,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAED,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC1B,MAAM;SACP,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,SAAS;QACP,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,OAAO,CAAC;YACnB,UAAU,EAAE;gBACV,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kBAAkB;iBAChC;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qCAAqC;oBAClD,OAAO,EAAE,EAAE;oBACX,OAAO,EAAE,CAAC;oBACV,OAAO,EAAE,EAAE;iBACZ;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iCAAiC;oBAC9C,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,CAAC;iBACnD;aACF;SACF,CAAC;IACJ,CAAC;CACF;AA5GD,sCA4GC"}
+{"version":3,"file":"webSearch.js","sourceRoot":"","sources":["../../src/tools/webSearch.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,YAAY,EAAE,CAAC;KACzB,EAAE,CAAC;IACJ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,YAAY,EAAE,CAAC;KACzB,EAAE,CAAC;IACJ,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AACA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,YAAY,EAAE,CAAC;KACzB,EAAE,CAAC;IACJ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,YAAY,EAAE,CAAC;KACzB,EAAE,CAAC;IACJ,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/types.js

@@ -1,6 +1,6 @@
-"use strict";
+// @ts-nocheck
 /**
  * @file Type definitions for search extension
  */
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,cAAc;AACd;;GAEG"}

package/manifest.json

@@ -2,39 +2,39 @@
   "$schema": "https://agentos.sh/schemas/extension-manifest-v1.json",
   "id": "com.framers.research.web-search",
   "name": "Web Search Extension",
-  "version": "1.0.0",
-  "description": "Professional web search, research aggregation, and fact-checking capabilities for AgentOS",
+  "version": "1.2.0",
+  "description": "Multi-provider web search with Firecrawl, Tavily, Serper, Brave — RRF fusion, semantic dedup, Cohere/LLM neural reranking, research aggregation, and fact-checking for AgentOS",
   "author": {
     "name": "Frame.dev",
     "email": "support@frame.dev",
-    "url": "https://github.com/framersai"
+    "url": "https://github.com/framerslab"
   },
   "license": "MIT",
-  "keywords": ["search", "web", "research", "fact-check", "serper", "serpapi", "brave"],
+  "keywords": ["search", "web", "research", "fact-check", "firecrawl", "tavily", "serper", "serpapi", "brave", "searxng", "cohere", "reranking", "rrf"],
   "agentosVersion": "^2.0.0",
   "categories": ["productivity", "research"],
   "repository": {
     "type": "git",
-    "url": "https://github.com/framersai/agentos-extensions"
+    "url": "https://github.com/framerslab/agentos-extensions"
   },
   "extensions": [
     {
       "kind": "tool",
-      "id": "webSearch",
+      "id": "web_search",
       "displayName": "Web Search",
       "description": "Search the web for information",
       "entry": "./dist/tools/webSearch.js"
     },
     {
       "kind": "tool",
-      "id": "researchAggregator",
+      "id": "research_aggregate",
       "displayName": "Research Aggregator",
       "description": "Aggregate research from multiple searches",
       "entry": "./dist/tools/researchAggregator.js"
     },
     {
       "kind": "tool",
-      "id": "factCheck",
+      "id": "fact_check",
       "displayName": "Fact Checker",
       "description": "Verify facts across multiple sources",
       "entry": "./dist/tools/factCheck.js"
@@ -44,7 +44,7 @@
     "properties": {
       "search.provider": {
         "type": "string",
-        "enum": ["serper", "serpapi", "brave", "duckduckgo"],
+        "enum": ["serper", "serpapi", "brave", "searxng", "duckduckgo"],
         "default": "duckduckgo",
         "description": "Search API provider to use"
       },
@@ -59,6 +59,11 @@
         "minimum": 1,
         "maximum": 20,
         "description": "Maximum requests per second"
+      },
+      "search.multiSearch": {
+        "type": "boolean",
+        "default": false,
+        "description": "Default multi-provider parallel search for all search tools. When enabled, queries fan out to ALL available providers, results are deduplicated and reranked by cross-provider agreement."
       }
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/agentos-ext-web-search",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Web search, research aggregation, and fact-checking tools for AgentOS",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -14,16 +14,6 @@
     "./manifest.json": "./manifest.json",
     "./package.json": "./package.json"
   },
-  "scripts": {
-    "build": "tsc",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "lint": "eslint src --ext .ts",
-    "typecheck": "tsc --noEmit",
-    "docs": "typedoc --out docs src/index.ts",
-    "clean": "rimraf dist"
-  },
   "keywords": [
     "agentos",
     "extension",
@@ -46,20 +36,19 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/framersai/agentos-extensions.git",
+    "url": "git+https://github.com/framerslab/agentos-extensions.git",
     "directory": "registry/curated/research/web-search"
   },
   "publishConfig": {
     "access": "public"
   },
   "peerDependencies": {
-    "@framers/agentos": "^0.1.0"
+    "@framers/agentos": "^0.10.28"
   },
   "dependencies": {
     "axios": "^1.7.7"
   },
   "devDependencies": {
-    "@framers/agentos": "^0.1.0",
     "@types/node": "^20.12.12",
     "@typescript-eslint/eslint-plugin": "^7.0.0",
     "@typescript-eslint/parser": "^7.0.0",
@@ -68,6 +57,27 @@
     "rimraf": "^5.0.7",
     "typedoc": "^0.25.13",
     "typescript": "^5.4.5",
-    "vitest": "^1.6.0"
+    "vitest": "^1.6.0",
+    "@framers/agentos": "^0.10.28"
+  },
+  "homepage": "https://github.com/framerslab/agentos-extensions/tree/master/registry/curated/research/web-search#readme",
+  "bugs": {
+    "url": "https://github.com/framerslab/agentos-extensions/issues"
+  },
+  "files": [
+    "dist",
+    "manifest.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src --ext .ts",
+    "typecheck": "tsc --noEmit",
+    "docs": "typedoc --out docs src/index.ts",
+    "clean": "rimraf dist"
   }
-}
+}

package/.eslintrc.json

@@ -1,21 +0,0 @@
-{
-  "root": true,
-  "parser": "@typescript-eslint/parser",
-  "plugins": ["@typescript-eslint"],
-  "extends": [
-    "eslint:recommended",
-    "plugin:@typescript-eslint/recommended"
-  ],
-  "parserOptions": {
-    "ecmaVersion": 2022,
-    "sourceType": "module",
-    "project": "./tsconfig.json"
-  },
-  "rules": {
-    "@typescript-eslint/explicit-function-return-type": "off",
-    "@typescript-eslint/no-explicit-any": "warn",
-    "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
-    "no-console": ["warn", { "allow": ["warn", "error"] }]
-  },
-  "ignorePatterns": ["dist", "node_modules", "coverage", "*.js"]
-}

package/CHANGELOG.md

@@ -1,16 +0,0 @@
-# @framers/agentos-ext-web-search
-
-## 1.1.0
-
-### Minor Changes
-
-- [`e6a2eb6`](https://github.com/framersai/agentos-extensions/commit/e6a2eb61145c5715df63668b795fe90720a3c7c1) Thanks [@jddunn](https://github.com/jddunn)! - Initial release of AgentOS extension packages.
-
-  - Auth: JWT authentication and subscription management
-  - Anchor Providers: Solana on-chain provenance anchoring
-  - Wunderland Tip Ingestion: Tip content processing pipeline
-  - Web Search: Search, research aggregation, and fact-checking
-  - Web Browser: Browser automation and content extraction
-  - Telegram Integration: Telegram Bot API integration
-  - Telegram Bot: Telegram bot communications handler
-  - CLI Executor: Shell command execution and file management

package/src/index.ts

@@ -1,123 +0,0 @@
-/**
- * AgentOS Web Search Extension
- * 
- * Provides web search capabilities through multiple providers with automatic fallback.
- * 
- * @module @framers/agentos-ext-web-search
- * @version 1.0.0
- * @license MIT
- */
-
-import { ExtensionContext, ExtensionPack } from '@framers/agentos';
-import { WebSearchTool } from './tools/webSearch';
-import { ResearchAggregatorTool } from './tools/researchAggregator';
-import { FactCheckTool } from './tools/factCheck';
-import { SearchProviderService } from './services/searchProvider';
-
-/**
- * Extension configuration options
- */
-export interface WebSearchExtensionOptions {
-  /** Serper.dev API key */
-  serperApiKey?: string;
-  /** SerpAPI API key */
-  serpApiKey?: string;
-  /** Brave Search API key */
-  braveApiKey?: string;
-  /** Default maximum results for searches */
-  defaultMaxResults?: number;
-  /** Rate limiting configuration */
-  rateLimit?: {
-    maxRequests: number;
-    windowMs: number;
-  };
-  /** Extension priority in the stack */
-  priority?: number;
-}
-
-/**
- * Creates the web search extension pack
- * 
- * @param {ExtensionContext} context - The extension context
- * @returns {ExtensionPack} The configured extension pack
- * 
- * @example
- * ```typescript
- * import { createExtensionPack } from '@framers/agentos-ext-web-search';
- * 
- * const pack = createExtensionPack({
- *   options: {
- *     serperApiKey: process.env.SERPER_API_KEY,
- *     defaultMaxResults: 10
- *   },
- *   logger: console
- * });
- * ```
- */
-export function createExtensionPack(context: ExtensionContext): ExtensionPack {
-  const options = context.options as WebSearchExtensionOptions || {};
-  
-  // Initialize search service with configuration
-  const searchService = new SearchProviderService({
-    serperApiKey: options.serperApiKey,
-    serpApiKey: options.serpApiKey,
-    braveApiKey: options.braveApiKey,
-    rateLimit: options.rateLimit
-  });
-  
-  // Create tool instances
-  const webSearchTool = new WebSearchTool(searchService);
-  const researchAggregator = new ResearchAggregatorTool(searchService);
-  const factCheckTool = new FactCheckTool(searchService);
-  
-  return {
-    name: '@framers/agentos-ext-web-search',
-    version: '1.0.0',
-    descriptors: [
-      {
-        id: 'webSearch',
-        kind: 'tool',
-        priority: options.priority || 50,
-        payload: webSearchTool
-      },
-      {
-        id: 'researchAggregator',
-        kind: 'tool',
-        priority: options.priority || 50,
-        payload: researchAggregator
-      },
-      {
-        id: 'factCheck',
-        kind: 'tool',
-        priority: options.priority || 50,
-        payload: factCheckTool
-      }
-    ],
-    /**
-     * Called when extension is activated
-     */
-    onActivate: async () => {
-      if (context.onActivate) {
-        await context.onActivate();
-      }
-      context.logger?.info('Web Search Extension activated');
-    },
-    /**
-     * Called when extension is deactivated
-     */
-    onDeactivate: async () => {
-      if (context.onDeactivate) {
-        await context.onDeactivate();
-      }
-      context.logger?.info('Web Search Extension deactivated');
-    }
-  };
-}
-
-// Export types for consumers
-export { WebSearchTool, ResearchAggregatorTool, FactCheckTool };
-export { SearchProviderService, SearchResult, ProviderResponse } from './services/searchProvider';
-export type { SearchProviderConfig } from './services/searchProvider';
-
-// Default export for convenience
-export default createExtensionPack;