@openclaw/brave-plugin 2026.6.1 → 2026.6.5-beta.1

package/dist/{brave-web-search-provider-BzuOscZC.js → brave-web-search-provider-6mNi77fe.js}

@@ -3,9 +3,13 @@ import { isDiagnosticFlagEnabled } from "openclaw/plugin-sdk/diagnostic-runtime"
 import { mergeScopedSearchConfig, resolveProviderWebSearchPluginConfig } from "openclaw/plugin-sdk/provider-web-search-config-contract";
 import { isRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 //#region extensions/brave/src/brave-web-search-provider.ts
+/**
+* Brave web-search provider factory. It builds the agent tool definition and
+* lazy-loads HTTP execution only when a search is run.
+*/
 let braveWebSearchRuntimePromise;
 function loadBraveWebSearchRuntime() {
-	braveWebSearchRuntimePromise ??= import("./brave-web-search-provider.runtime-SKsUJmbH.js");
+	braveWebSearchRuntimePromise ??= import("./brave-web-search-provider.runtime-D_z2neAi.js");
 	return braveWebSearchRuntimePromise;
 }
 const BraveSearchSchema = {
@@ -66,6 +70,7 @@ function createBraveToolDefinition(searchConfig, config) {
 		}
 	};
 }
+/** Create the runtime Brave Search provider descriptor. */
 function createBraveWebSearchProvider() {
 	return {
 		...buildBraveWebSearchProviderBase(),

package/dist/{brave-web-search-provider.runtime-SKsUJmbH.js → brave-web-search-provider.runtime-D_z2neAi.js}

@@ -4,6 +4,10 @@ import { DEFAULT_SEARCH_COUNT, MAX_SEARCH_COUNT, buildSearchCacheKey, formatCliC
 import { createSubsystemLogger } from "openclaw/plugin-sdk/runtime-env";
 import { assertHttpUrlTargetsPrivateNetwork, isBlockedHostnameOrIp, isPrivateIpAddress, resolvePinnedHostnameWithPolicy } from "openclaw/plugin-sdk/ssrf-runtime";
 //#region extensions/brave/src/brave-web-search-provider.shared.ts
+/**
+* Brave Search request normalization and result mapping. It validates Brave
+* country/language params and converts LLM-context responses into web results.
+*/
 const BRAVE_COUNTRY_CODES = new Set([
 	"AR",
 	"AU",
@@ -115,6 +119,7 @@ function normalizeBraveSearchLang(value) {
 	if (!BRAVE_SEARCH_LANG_CODES.has(canonical)) return;
 	return canonical;
 }
+/** Normalize Brave country filter values. */
 function normalizeBraveCountry(value) {
 	if (!value) return;
 	const trimmed = value.trim();
@@ -131,13 +136,16 @@ function normalizeBraveUiLang(value) {
 	const [, language, region] = match;
 	return `${normalizeLowercaseStringOrEmpty(language)}-${region.toUpperCase()}`;
 }
+/** Resolve Brave-specific web-search config from scoped search config. */
 function resolveBraveConfig(searchConfig) {
 	const brave = searchConfig?.brave;
 	return brave && typeof brave === "object" && !Array.isArray(brave) ? brave : {};
 }
+/** Resolve whether Brave should use web search or LLM Context API mode. */
 function resolveBraveMode(brave) {
 	return brave?.mode === "llm-context" ? "llm-context" : "web";
 }
+/** Normalize Brave search and UI language params, detecting swapped fields. */
 function normalizeBraveLanguageParams(params) {
 	const rawSearchLang = normalizeOptionalString(params.search_lang);
 	const rawUiLang = normalizeOptionalString(params.ui_lang);
@@ -164,6 +172,7 @@ function resolveSiteName$1(url) {
 		return;
 	}
 }
+/** Map Brave LLM Context API grounding results into web-search result rows. */
 function mapBraveLlmContextResults(data) {
 	return (Array.isArray(data.grounding?.generic) ? data.grounding.generic : []).map((entry) => ({
 		url: entry.url ?? "",
@@ -174,6 +183,10 @@ function mapBraveLlmContextResults(data) {
 }
 //#endregion
 //#region extensions/brave/src/brave-web-search-provider.runtime.ts
+/**
+* Brave Search HTTP runtime. It resolves credentials, enforces endpoint safety,
+* applies caching, and maps Brave web/LLM-context API responses.
+*/
 const DEFAULT_BRAVE_BASE_URL = "https://api.search.brave.com";
 const BRAVE_SEARCH_ENDPOINT_PATH = "/res/v1/web/search";
 const BRAVE_LLM_CONTEXT_ENDPOINT_PATH = "/res/v1/llm/context";
@@ -326,6 +339,7 @@ async function runBraveWebSearch(params) {
 		};
 	});
 }
+/** Execute one Brave Search request using web or LLM-context mode. */
 async function executeBraveSearch(args, searchConfig, options) {
 	const apiKey = resolveBraveApiKey(searchConfig);
 	if (!apiKey) return missingBraveKeyPayload();

package/dist/index.js

@@ -1,6 +1,11 @@
-import { t as createBraveWebSearchProvider } from "./brave-web-search-provider-BzuOscZC.js";
+import { t as createBraveWebSearchProvider } from "./brave-web-search-provider-6mNi77fe.js";
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 //#region extensions/brave/index.ts
+/**
+* Brave Search plugin entry. It registers the Brave web-search provider and
+* keeps runtime HTTP execution lazy.
+*/
+/** Plugin entry for Brave Search. */
 var brave_default = definePluginEntry({
 	id: "brave",
 	name: "Brave Plugin",

package/dist/web-search-contract-api.js

@@ -1,5 +1,6 @@
 import { buildBraveWebSearchProviderBase } from "./web-search-shared.js";
 //#region extensions/brave/web-search-contract-api.ts
+/** Create the Brave provider descriptor for contract checks. */
 function createBraveWebSearchProvider() {
 	return {
 		...buildBraveWebSearchProviderBase(),

package/dist/web-search-provider.js

@@ -1,2 +1,2 @@
-import { t as createBraveWebSearchProvider } from "./brave-web-search-provider-BzuOscZC.js";
+import { t as createBraveWebSearchProvider } from "./brave-web-search-provider-6mNi77fe.js";
 export { createBraveWebSearchProvider };

package/dist/web-search-shared.js

@@ -1,7 +1,13 @@
 import { createWebSearchProviderContractFields } from "openclaw/plugin-sdk/provider-web-search-config-contract";
 import { isRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 //#region extensions/brave/web-search-shared.ts
+/**
+* Shared Brave Search provider metadata and credential lookup. Contract tests
+* and runtime provider creation both use this lightweight descriptor.
+*/
+/** Canonical config path for the Brave Search API key. */
 const BRAVE_CREDENTIAL_PATH = "plugins.entries.brave.config.webSearch.apiKey";
+/** Resolve legacy top-level Brave credentials from old web-search config. */
 function resolveLegacyTopLevelBraveCredential(config) {
 	if (!isRecord(config)) return;
 	const tools = isRecord(config.tools) ? config.tools : void 0;
@@ -21,9 +27,11 @@ function resolveBraveWebSearchPluginConfig(config) {
 	const pluginConfig = isRecord(entry?.config) ? entry.config : void 0;
 	return isRecord(pluginConfig?.webSearch) ? pluginConfig.webSearch : void 0;
 }
+/** Resolve Brave credentials from current plugin config or legacy fallback. */
 function resolveConfiguredBraveCredential(config) {
 	return resolveBraveWebSearchPluginConfig(config)?.apiKey ?? resolveLegacyTopLevelBraveCredential(config)?.value;
 }
+/** Build the common Brave provider metadata without the runtime tool executor. */
 function buildBraveWebSearchProviderBase() {
 	return {
 		id: "brave",

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@openclaw/brave-plugin",
-  "version": "2026.6.1",
+  "version": "2026.6.5-beta.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@openclaw/brave-plugin",
-      "version": "2026.6.1"
+      "version": "2026.6.5-beta.1"
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/brave-plugin",
-  "version": "2026.6.1",
+  "version": "2026.6.5-beta.1",
   "description": "OpenClaw Brave Search provider plugin for web search.",
   "repository": {
     "type": "git",
@@ -18,10 +18,10 @@
       "allowInvalidConfigRecovery": true
     },
     "compat": {
-      "pluginApi": ">=2026.6.1"
+      "pluginApi": ">=2026.6.5-beta.1"
     },
     "build": {
-      "openclawVersion": "2026.6.1"
+      "openclawVersion": "2026.6.5-beta.1"
     },
     "release": {
       "publishToClawHub": true,
@@ -38,7 +38,7 @@
     "README.md"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.6.1"
+    "openclaw": ">=2026.6.5-beta.1"
   },
   "peerDependenciesMeta": {
     "openclaw": {