@memoryblock/plugin-web-search 0.1.0-beta → 0.1.1-beta

package/README.md

@@ -0,0 +1,35 @@
+# @memoryblock/plugin-web-search
+
+Official plugin providing web search capabilities to **memoryblock**.
+
+This package handles:
+- DuckDuckGo deep search queries
+- Search result context aggregation
+- URL extraction
+
+## The `memoryblock` Ecosystem
+
+**memoryblock** is a highly modular system. Here are the official packages:
+
+**The Core**
+*   [**memoryblock**](https://www.npmjs.com/package/memoryblock) - The core engine interface and types.
+*   [**@memoryblock/daemon**](https://www.npmjs.com/package/@memoryblock/daemon) - Background daemon manager.
+*   [**@memoryblock/api**](https://www.npmjs.com/package/@memoryblock/api) - Core REST and WebSocket API server.
+
+**Integrations & Tooling**
+*   [**@memoryblock/adapters**](https://www.npmjs.com/package/@memoryblock/adapters) - LLM adapters (OpenAI, Anthropic, Bedrock, etc).
+*   [**@memoryblock/channels**](https://www.npmjs.com/package/@memoryblock/channels) - Communication channels (CLI, Telegram, Web).
+*   [**@memoryblock/tools**](https://www.npmjs.com/package/@memoryblock/tools) - Standard tool definitions and schemas.
+*   [**@memoryblock/locale**](https://www.npmjs.com/package/@memoryblock/locale) - Localization strings and formatting.
+*   [**@memoryblock/web**](https://www.npmjs.com/package/@memoryblock/web) - Front-end dashboard and Web UI.
+
+**Plugins**
+*   [**@memoryblock/plugin-installer**](https://www.npmjs.com/package/@memoryblock/plugin-installer) - Plugin installer and registry manager.
+*   [**@memoryblock/plugin-agents**](https://www.npmjs.com/package/@memoryblock/plugin-agents) - Secondary AI agents orchestrator.
+*   [**@memoryblock/plugin-aws**](https://www.npmjs.com/package/@memoryblock/plugin-aws) - AWS integrations.
+*   [**@memoryblock/plugin-fetch-webpage**](https://www.npmjs.com/package/@memoryblock/plugin-fetch-webpage) - Web content fetching and parsing.
+*   [**@memoryblock/plugin-web-search**](https://www.npmjs.com/package/@memoryblock/plugin-web-search) - Web search capabilities.
+
+## License
+
+Distributed under the MIT License. See `LICENSE` for more information.

package/package.json

@@ -1,17 +1,54 @@
 {
   "name": "@memoryblock/plugin-web-search",
-  "version": "0.1.0-beta",
+  "version": "0.1.1-beta",
   "type": "module",
+  "description": "Official plugin providing web search capabilities to memoryblock.",
+  "files": [
+    "dist/"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     }
   },
-  "dependencies": {
-    "memoryblock": "0.1.0-beta"
-  },
   "scripts": {
     "build": "tsc -p tsconfig.json"
-  }
+  },
+  "dependencies": {
+    "memoryblock": "^0.1.1-beta"
+  },
+  "keywords": [
+    "memoryblock",
+    "ai-agent",
+    "assistants",
+    "agents",
+    "automation",
+    "multi-agent",
+    "agentic-framework",
+    "plugin",
+    "search",
+    "search-engine",
+    "search-api",
+    "web-search",
+    "brave",
+    "duckduckgo",
+    "google",
+    "bing",
+    "yahoo"
+  ],
+  "author": {
+    "name": "Ghazi",
+    "url": "https://mgks.dev"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/memoryblock-io/memoryblock.git"
+  },
+  "bugs": {
+    "url": "https://github.com/memoryblock-io/memoryblock/issues"
+  },
+  "homepage": "https://memoryblock.io",
+  "funding": "https://github.com/sponsors/mgks",
+  "license": "MIT"
 }

package/src/base.ts

@@ -1,19 +0,0 @@
-/**
- * Search provider contract.
- * All search providers (Brave, Google, etc.) must implement this.
- */
-export interface SearchResult {
-    title: string;
-    url: string;
-    snippet: string;
-}
-
-export interface SearchOptions {
-    count?: number;
-    language?: string;
-}
-
-export interface SearchProvider {
-    readonly name: string;
-    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
-}

package/src/brave/index.ts

@@ -1,57 +0,0 @@
-import { loadAuth } from 'memoryblock';
-import type { SearchProvider, SearchResult, SearchOptions } from '../base.js';
-
-const BRAVE_API_URL = 'https://api.search.brave.com/res/v1/web/search';
-
-interface BraveWebResult {
-    title?: string;
-    url?: string;
-    description?: string;
-}
-
-/**
- * Brave Search API provider.
- * Uses native fetch() (Node 18+ built-in).
- */
-export class BraveSearchProvider implements SearchProvider {
-    readonly name = 'brave';
-
-    async search(query: string, options?: SearchOptions): Promise<SearchResult[]> {
-        const auth = await loadAuth();
-        const apiKey = auth.brave?.apiKey;
-
-        if (!apiKey) {
-            throw new Error(
-                'Brave API key not configured. Add it to ~/.memoryblock/auth.json:\n' +
-                '  { "brave": { "apiKey": "..." } }',
-            );
-        }
-
-        const count = options?.count || 5;
-        const params = new URLSearchParams({
-            q: query,
-            count: String(count),
-        });
-
-        const response = await fetch(`${BRAVE_API_URL}?${params}`, {
-            headers: {
-                'Accept': 'application/json',
-                'Accept-Encoding': 'gzip',
-                'X-Subscription-Token': apiKey,
-            },
-        });
-
-        if (!response.ok) {
-            throw new Error(`Brave Search API error: ${response.status} ${response.statusText}`);
-        }
-
-        const data = await response.json() as { web?: { results?: BraveWebResult[] } };
-        const results = data.web?.results || [];
-
-        return results.map((r: BraveWebResult) => ({
-            title: r.title || '',
-            url: r.url || '',
-            snippet: r.description || '',
-        }));
-    }
-}

package/src/index.ts

@@ -1,53 +0,0 @@
-import type { ToolExecutionResult, ToolContext, ToolDefinition } from 'memoryblock';
-import { BraveSearchProvider } from './brave/index.js';
-
-export type { SearchProvider, SearchResult, SearchOptions } from './base.js';
-export { BraveSearchProvider } from './brave/index.js';
-
-const braveProvider = new BraveSearchProvider();
-
-/**
- * Web search tool definition — registers as a tool in the registry.
- */
-const webSearchToolDefinition: ToolDefinition = {
-    name: 'web_search',
-    description: 'Search the web for current information. Returns titles, URLs, and snippets.',
-    parameters: {
-        type: 'object',
-        properties: {
-            query: { type: 'string', description: 'The search query.' },
-            count: { type: 'number', description: 'Number of results (default: 5, max: 10).' },
-        },
-        required: ['query'],
-        additionalProperties: false,
-    },
-    requiresApproval: false,
-};
-
-/** Web search tool — usable by the tool registry. */
-export const webSearchTool = {
-    definition: webSearchToolDefinition,
-    async execute(params: Record<string, unknown>, _context: ToolContext): Promise<ToolExecutionResult> {
-        try {
-            const query = params.query as string;
-            const count = Math.min((params.count as number) || 5, 10);
-            const results = await braveProvider.search(query, { count });
-
-            if (results.length === 0) {
-                return { content: 'No results found.', isError: false };
-            }
-
-            const formatted = results
-                .map((r, i) => `${i + 1}. **${r.title}**\n   ${r.url}\n   ${r.snippet}`)
-                .join('\n\n');
-
-            return { content: formatted, isError: false };
-        } catch (err) {
-            const message = err instanceof Error ? err.message : String(err);
-            return { content: `Web search failed: ${message}`, isError: true };
-        }
-    },
-};
-
-/** Export as array for registry plugin loading. */
-export const tools = [webSearchTool];

package/tsconfig.json

@@ -1,10 +0,0 @@
-{
-    "extends": "../../../tsconfig.json",
-    "compilerOptions": {
-        "outDir": "dist",
-        "rootDir": "src"
-    },
-    "include": [
-        "src"
-    ]
-}