@thynker-labs/tools-brave 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import { ToolProvider } from '@thynker-labs/core';
+
+interface BraveToolProviderConfig {
+    apiKeyEnv: string;
+    /** Required scopes for search tools (default: ["web:search"]). */
+    requiredScopes?: string[];
+}
+type BraveFetch = typeof fetch;
+/**
+ * Brave Search ToolProvider — web and news search via Brave Search API.
+ */
+declare function createBraveToolProvider(config: BraveToolProviderConfig, fetchImpl?: BraveFetch): ToolProvider;
+
+export { type BraveFetch, type BraveToolProviderConfig, createBraveToolProvider };

package/dist/index.js

@@ -0,0 +1,112 @@
+// src/index.ts
+var BRAVE_API = "https://api.search.brave.com/res/v1";
+var TOOLS = [
+  {
+    name: "brave_web_search",
+    description: "Search the web using Brave Search. Returns titles, URLs, and snippets for top results.",
+    requiredScopes: ["web:search"],
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: { type: "string", description: "Search query" },
+        count: { type: "number", description: "Number of results (1-20, default 5)" }
+      },
+      required: ["query"]
+    }
+  },
+  {
+    name: "brave_news_search",
+    description: "Search recent news using Brave News Search.",
+    requiredScopes: ["web:search"],
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: { type: "string", description: "News search query" },
+        count: { type: "number", description: "Number of results (1-20, default 5)" }
+      },
+      required: ["query"]
+    }
+  }
+];
+function resolveApiKey(config) {
+  const key = process.env[config.apiKeyEnv];
+  if (!key) {
+    throw new Error(
+      `Missing ${config.apiKeyEnv}. Set it in .env to enable Brave Search tools.`
+    );
+  }
+  return key;
+}
+function scopesFor(config) {
+  return config.requiredScopes ?? ["web:search"];
+}
+function mapWebResults(data) {
+  return (data.web?.results ?? []).map((r) => ({
+    title: r.title ?? "",
+    url: r.url ?? "",
+    snippet: r.description ?? ""
+  }));
+}
+function mapNewsResults(data) {
+  return (data.results ?? []).map((r) => ({
+    title: r.title ?? "",
+    url: r.url ?? "",
+    snippet: r.description ?? ""
+  }));
+}
+function createBraveToolProvider(config, fetchImpl = fetch) {
+  const scopedTools = TOOLS.map((t) => ({
+    ...t,
+    requiredScopes: scopesFor(config)
+  }));
+  return {
+    async list() {
+      resolveApiKey(config);
+      return scopedTools;
+    },
+    async execute(name, args, _authCtx) {
+      const apiKey = resolveApiKey(config);
+      const query = String(args.query ?? "");
+      if (!query.trim()) throw new Error("query is required");
+      const count = Math.min(20, Math.max(1, Number(args.count ?? 5)));
+      if (name === "brave_web_search") {
+        const url = new URL(`${BRAVE_API}/web/search`);
+        url.searchParams.set("q", query);
+        url.searchParams.set("count", String(count));
+        const res = await fetchImpl(url.toString(), {
+          headers: {
+            Accept: "application/json",
+            "X-Subscription-Token": apiKey
+          }
+        });
+        if (!res.ok) {
+          const body = await res.text();
+          throw new Error(`Brave web search failed (${res.status}): ${body}`);
+        }
+        const data = await res.json();
+        return { query, results: mapWebResults(data) };
+      }
+      if (name === "brave_news_search") {
+        const url = new URL(`${BRAVE_API}/news/search`);
+        url.searchParams.set("q", query);
+        url.searchParams.set("count", String(count));
+        const res = await fetchImpl(url.toString(), {
+          headers: {
+            Accept: "application/json",
+            "X-Subscription-Token": apiKey
+          }
+        });
+        if (!res.ok) {
+          const body = await res.text();
+          throw new Error(`Brave news search failed (${res.status}): ${body}`);
+        }
+        const data = await res.json();
+        return { query, results: mapNewsResults(data) };
+      }
+      throw new Error(`Unknown Brave tool: ${name}`);
+    }
+  };
+}
+export {
+  createBraveToolProvider
+};

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@thynker-labs/tools-brave",
+  "version": "0.0.1",
+  "description": "Brave Search API ToolProvider for web search",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@thynker-labs/core": "0.0.1"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}