@framers/agentos-ext-web-search 1.1.0

package/dist/tools/researchAggregator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"researchAggregator.js","sourceRoot":"","sources":["../../src/tools/researchAggregator.ts"],"names":[],"mappings":";;;AAGA;;;;;;;;;;;;;;;GAeG;AACH,MAAa,sBAAsB;IASb;IARJ,EAAE,GAAG,oBAAoB,CAAC;IAC1B,IAAI,GAAG,qBAAqB,CAAC;IAC7B,WAAW,GAAG,sDAAsD,CAAC;IAErF;;;OAGG;IACH,YAAoB,aAAoC;QAApC,kBAAa,GAAb,aAAa,CAAuB;IAAG,CAAC;IAE5D;;;;;;;;OAQG;IACH,KAAK,CAAC,OAAO,CAAC,KAIb;QACC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;YACnC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,UAAU,CAAC;YAExC,+DAA+D;YAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;YAExE,+BAA+B;YAC/B,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CACzC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE;gBAC/B,UAAU,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;aACnE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACf,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,EAAE;gBACX,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE;aAC7E,CAAC,CAAC,CACJ,CAAC;YAEF,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAExD,oCAAoC;YACpC,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC,aAAa,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YAErE,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE;oBACN,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,OAAO,EAAE,OAAO;oBAChB,KAAK,EAAE,KAAK;oBACZ,OAAO,EAAE,OAAO;oBAChB,iBAAiB,EAAE,UAAU;oBAC7B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC;aACF,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;;;;;;;;OAQG;IACK,qBAAqB,CAAC,KAAa,EAAE,KAAa,EAAE,KAAa;QACvE,MAAM,OAAO,GAAa,CAAC,KAAK,CAAC,CAAC,CAAC,gCAAgC;QAEnE,MAAM,SAAS,GAAG;YAChB,KAAK,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;YAC9B,QAAQ,EAAE,CAAC,UAAU,EAAE,qBAAqB,EAAE,cAAc,EAAE,cAAc,CAAC;YAC7E,aAAa,EAAE;gBACb,UAAU;gBACV,iBAAiB;gBACjB,kBAAkB;gBAClB,YAAY;gBACZ,mBAAmB;gBACnB,uBAAuB;gBACvB,iBAAiB;gBACjB,iBAAiB;aAClB;SACF,CAAC;QAEF,MAAM,iBAAiB,GAAG,SAAS,CAAC,KAA+B,CAAC,CAAC;QAErE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACvE,IAAI,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBAC7B,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;;;OAOG;IACK,gBAAgB,CAAC,aAAoB,EAAE,KAAa;QAC1D,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;QACnC,MAAM,UAAU,GAAG;YACjB,QAAQ,EAAE,EAAW;YACrB,QAAQ,EAAE,EAAW;YACrB,YAAY,EAAE,EAAW;YACzB,SAAS,EAAE,EAAW;SACvB,CAAC;QAEF,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;YACzC,IAAI,CAAC,YAAY,CAAC,OAAO;gBAAE,SAAS;YAEpC,KAAK,MAAM,MAAM,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;gBAC1C,kBAAkB;gBAClB,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC;oBAAE,SAAS;gBACvC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAEzB,8BAA8B;gBAC9B,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;gBAC9C,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;gBAElD,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC;oBACtE,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;oBACnC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACnC,CAAC;qBAAM,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;oBAC/D,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;oBAC1E,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACnC,CAAC;qBAAM,IAAI,UAAU,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC;oBACrE,UAAU,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;oBACjD,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACvC,CAAC;qBAAM,CAAC;oBACN,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACpC,CAAC;YACH,CAAC;QACH,CAAC;QAED,6BAA6B;QAC7B,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YAC/E,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,CAAC;gBACnC,GAAG,IAAI;gBACP,cAAc,EAAE,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,KAAK,CAAC;aACrD,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC;YAClE,OAAO,GAAG,CAAC;QACb,CAAC,EAAE,EAAS,CAAC,CAAC;QAEd,OAAO;YACL,UAAU,EAAE,gBAAgB;YAC5B,YAAY,EAAE,QAAQ,CAAC,IAAI;YAC3B,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,gBAAgB,EAAE,EAAE,CAAC;SACrD,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACK,kBAAkB,CAAC,MAAW,EAAE,KAAa;QACnD,IAAI,KAAK,GAAG,EAAE,CAAC,CAAC,aAAa;QAE7B,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACpD,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QAC9C,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QAElD,wBAAwB;QACxB,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,KAAK,IAAI,EAAE,CAAC;YAC3C,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,KAAK,IAAI,CAAC,CAAC;QAC9C,CAAC;QAED,+BAA+B;QAC/B,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC;YAAE,KAAK,IAAI,EAAE,CAAC;QACjD,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;QAC7C,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;QAEhD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;;;OAOG;IACK,aAAa,CAAC,UAAe,EAAE,KAAa;QAClD,MAAM,UAAU,GAAU,EAAE,CAAC;QAE7B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9C,UAAU,CAAC,IAAI,CAAC,GAAI,KAAe,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,UAAU;aACd,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,cAAc,CAAC;aACnD,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACrB,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,OAAO,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC,IAAI,KAAK,CAAC,OAAO,GAAG,EAAE,EAAE,CAAC;gBACjF,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBAClE,MAAM,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;YACjE,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,mDAAmD;iBACjE;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,8CAA8C;oBAC3D,OAAO,EAAE,CAAC;oBACV,OAAO,EAAE,CAAC;oBACV,OAAO,EAAE,EAAE;iBACZ;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sBAAsB;oBACnC,IAAI,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,eAAe,CAAC;oBAC5C,OAAO,EAAE,UAAU;iBACpB;aACF;SACF,CAAC;IACJ,CAAC;CACF;AArRD,wDAqRC"}

package/dist/tools/webSearch.d.ts

@@ -0,0 +1,66 @@
+import { ITool } from '@framers/agentos';
+import { SearchProviderService } from '../services/searchProvider';
+/**
+ * Web search tool that queries multiple search providers
+ *
+ * @class WebSearchTool
+ * @implements {ITool}
+ *
+ * @example
+ * ```typescript
+ * const tool = new WebSearchTool(searchService);
+ * const result = await tool.execute({
+ *   query: 'AgentOS extensions',
+ *   maxResults: 10,
+ *   provider: 'serper'
+ * });
+ * ```
+ */
+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[];
+    };
+    /**
+     * 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

@@ -0,0 +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"}

package/dist/tools/webSearch.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSearchTool = void 0;
+/**
+ * Web search tool that queries multiple search providers
+ *
+ * @class WebSearchTool
+ * @implements {ITool}
+ *
+ * @example
+ * ```typescript
+ * const tool = new WebSearchTool(searchService);
+ * const result = await tool.execute({
+ *   query: 'AgentOS extensions',
+ *   maxResults: 10,
+ *   provider: 'serper'
+ * });
+ * ```
+ */
+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) {
+        this.searchService = searchService;
+    }
+    /**
+     * 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) {
+        try {
+            const results = await this.searchService.search(input.query, {
+                maxResults: input.maxResults || 10,
+                provider: input.provider
+            });
+            return {
+                success: true,
+                output: results
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error.message
+            };
+        }
+    }
+    /**
+     * Validates input parameters for the web search
+     *
+     * @param {any} input - The input to validate
+     * @returns {{valid: boolean, errors: string[]}} Validation result
+     */
+    validate(input) {
+        const errors = [];
+        if (!input.query) {
+            errors.push('Query is required');
+        }
+        else if (typeof input.query !== 'string') {
+            errors.push('Query must be a string');
+        }
+        if (input.maxResults !== undefined) {
+            if (typeof input.maxResults !== 'number' || input.maxResults <= 0) {
+                errors.push('maxResults must be a positive number');
+            }
+        }
+        if (input.provider !== undefined) {
+            const validProviders = ['serper', 'serpapi', 'brave', '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']
+                }
+            }
+        };
+    }
+}
+exports.WebSearchTool = WebSearchTool;
+//# sourceMappingURL=webSearch.js.map

package/dist/tools/webSearch.js.map

@@ -0,0 +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"}

package/dist/types.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @file Type definitions for search extension
+ */
+export interface SearchResult {
+    title: string;
+    snippet: string;
+    url: string;
+    source?: string;
+    publishedDate?: string;
+    thumbnail?: string;
+}
+export interface SearchResponse {
+    results: SearchResult[];
+    query: string;
+    provider: string;
+    totalResults?: number;
+    searchTime?: number;
+}
+export interface ResearchResult {
+    topic: string;
+    searchCount: number;
+    aggregatedResults: {
+        query: string;
+        results: SearchResult[];
+    }[];
+    provider: string;
+}
+export interface FactCheckResult {
+    claim: string;
+    context?: string;
+    verificationResults: {
+        query: string;
+        results: SearchResult[];
+    }[];
+    sourcesChecked: number;
+    provider: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +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"}

package/dist/types.js

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

package/dist/types.js.map

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

package/manifest.json

@@ -0,0 +1,65 @@
+{
+  "$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",
+  "author": {
+    "name": "Frame.dev",
+    "email": "support@frame.dev",
+    "url": "https://github.com/framersai"
+  },
+  "license": "MIT",
+  "keywords": ["search", "web", "research", "fact-check", "serper", "serpapi", "brave"],
+  "agentosVersion": "^2.0.0",
+  "categories": ["productivity", "research"],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/framersai/agentos-extensions"
+  },
+  "extensions": [
+    {
+      "kind": "tool",
+      "id": "webSearch",
+      "displayName": "Web Search",
+      "description": "Search the web for information",
+      "entry": "./dist/tools/webSearch.js"
+    },
+    {
+      "kind": "tool",
+      "id": "researchAggregator",
+      "displayName": "Research Aggregator",
+      "description": "Aggregate research from multiple searches",
+      "entry": "./dist/tools/researchAggregator.js"
+    },
+    {
+      "kind": "tool",
+      "id": "factCheck",
+      "displayName": "Fact Checker",
+      "description": "Verify facts across multiple sources",
+      "entry": "./dist/tools/factCheck.js"
+    }
+  ],
+  "configuration": {
+    "properties": {
+      "search.provider": {
+        "type": "string",
+        "enum": ["serper", "serpapi", "brave", "duckduckgo"],
+        "default": "duckduckgo",
+        "description": "Search API provider to use"
+      },
+      "search.apiKey": {
+        "type": "string",
+        "description": "API key for the search provider",
+        "secret": true
+      },
+      "search.rateLimit": {
+        "type": "number",
+        "default": 5,
+        "minimum": 1,
+        "maximum": 20,
+        "description": "Maximum requests per second"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@framers/agentos-ext-web-search",
+  "version": "1.1.0",
+  "description": "Web search, research aggregation, and fact-checking tools for AgentOS",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./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",
+    "search",
+    "research",
+    "web"
+  ],
+  "author": {
+    "name": "Framers AI",
+    "email": "team@frame.dev",
+    "url": "https://frame.dev"
+  },
+  "contributors": [
+    {
+      "name": "Johnny Dunn",
+      "email": "johnnyfived@protonmail.com",
+      "url": "https://github.com/jddunn"
+    }
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/framersai/agentos-extensions.git",
+    "directory": "registry/curated/research/web-search"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@framers/agentos": "^0.1.0"
+  },
+  "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",
+    "@vitest/coverage-v8": "^1.6.0",
+    "eslint": "^9.11.0",
+    "rimraf": "^5.0.7",
+    "typedoc": "^0.25.13",
+    "typescript": "^5.4.5",
+    "vitest": "^1.6.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,123 @@
+/**
+ * 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;