@memoryblock/plugin-web-search 0.1.0-beta

package/dist/base.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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[]>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CAC3E"}

package/dist/base.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base.js.map

package/dist/base.js.map

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

package/dist/brave/index.d.ts

@@ -0,0 +1,10 @@
+import type { SearchProvider, SearchResult, SearchOptions } from '../base.js';
+/**
+ * Brave Search API provider.
+ * Uses native fetch() (Node 18+ built-in).
+ */
+export declare class BraveSearchProvider implements SearchProvider {
+    readonly name = "brave";
+    search(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/brave/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/brave/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAU9E;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IACtD,QAAQ,CAAC,IAAI,WAAW;IAElB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAsChF"}

package/dist/brave/index.js

@@ -0,0 +1,40 @@
+import { loadAuth } from 'memoryblock';
+const BRAVE_API_URL = 'https://api.search.brave.com/res/v1/web/search';
+/**
+ * Brave Search API provider.
+ * Uses native fetch() (Node 18+ built-in).
+ */
+export class BraveSearchProvider {
+    name = 'brave';
+    async search(query, options) {
+        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();
+        const results = data.web?.results || [];
+        return results.map((r) => ({
+            title: r.title || '',
+            url: r.url || '',
+            snippet: r.description || '',
+        }));
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/brave/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/brave/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,MAAM,aAAa,GAAG,gDAAgD,CAAC;AAQvE;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IACnB,IAAI,GAAG,OAAO,CAAC;IAExB,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,OAAuB;QAC/C,MAAM,IAAI,GAAG,MAAM,QAAQ,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC;QAElC,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CACX,qEAAqE;gBACrE,oCAAoC,CACvC,CAAC;QACN,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;YAC/B,CAAC,EAAE,KAAK;YACR,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;SACvB,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,aAAa,IAAI,MAAM,EAAE,EAAE;YACvD,OAAO,EAAE;gBACL,QAAQ,EAAE,kBAAkB;gBAC5B,iBAAiB,EAAE,MAAM;gBACzB,sBAAsB,EAAE,MAAM;aACjC;SACJ,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACzF,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAA8C,CAAC;QAC/E,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,IAAI,EAAE,CAAC;QAExC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAiB,EAAE,EAAE,CAAC,CAAC;YACvC,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;YACpB,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE;YAChB,OAAO,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE;SAC/B,CAAC,CAAC,CAAC;IACR,CAAC;CACJ"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import type { ToolExecutionResult, ToolContext, ToolDefinition } from 'memoryblock';
+export type { SearchProvider, SearchResult, SearchOptions } from './base.js';
+export { BraveSearchProvider } from './brave/index.js';
+/** Web search tool — usable by the tool registry. */
+export declare const webSearchTool: {
+    definition: ToolDefinition;
+    execute(params: Record<string, unknown>, _context: ToolContext): Promise<ToolExecutionResult>;
+};
+/** Export as array for registry plugin loading. */
+export declare const tools: {
+    definition: ToolDefinition;
+    execute(params: Record<string, unknown>, _context: ToolContext): Promise<ToolExecutionResult>;
+}[];
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGpF,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAsBvD,qDAAqD;AACrD,eAAO,MAAM,aAAa;;oBAEA,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAoBtG,CAAC;AAEF,mDAAmD;AACnD,eAAO,MAAM,KAAK;;oBAvBQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;GAuBnE,CAAC"}

package/dist/index.js

@@ -0,0 +1,45 @@
+import { BraveSearchProvider } from './brave/index.js';
+export { BraveSearchProvider } from './brave/index.js';
+const braveProvider = new BraveSearchProvider();
+/**
+ * Web search tool definition — registers as a tool in the registry.
+ */
+const webSearchToolDefinition = {
+    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, _context) {
+        try {
+            const query = params.query;
+            const count = Math.min(params.count || 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];
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,aAAa,GAAG,IAAI,mBAAmB,EAAE,CAAC;AAEhD;;GAEG;AACH,MAAM,uBAAuB,GAAmB;IAC5C,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,6EAA6E;IAC1F,UAAU,EAAE;QACR,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACR,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;YAC3D,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0CAA0C,EAAE;SACrF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,oBAAoB,EAAE,KAAK;KAC9B;IACD,gBAAgB,EAAE,KAAK;CAC1B,CAAC;AAEF,qDAAqD;AACrD,MAAM,CAAC,MAAM,aAAa,GAAG;IACzB,UAAU,EAAE,uBAAuB;IACnC,KAAK,CAAC,OAAO,CAAC,MAA+B,EAAE,QAAqB;QAChE,IAAI,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAe,CAAC;YACrC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAE,MAAM,CAAC,KAAgB,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1D,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAE7D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAC5D,CAAC;YAED,MAAM,SAAS,GAAG,OAAO;iBACpB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;iBACvE,IAAI,CAAC,MAAM,CAAC,CAAC;YAElB,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAClD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO,EAAE,OAAO,EAAE,sBAAsB,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACvE,CAAC;IACL,CAAC;CACJ,CAAC;AAEF,mDAAmD;AACnD,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,aAAa,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@memoryblock/plugin-web-search",
+  "version": "0.1.0-beta",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "memoryblock": "0.1.0-beta"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  }
+}

package/src/base.ts

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

@@ -0,0 +1,57 @@
+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

@@ -0,0 +1,53 @@
+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

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