@openclaw/brave-plugin 2026.5.28 → 2026.5.30-beta.1

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

@@ -5,7 +5,7 @@ import { isRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 //#region extensions/brave/src/brave-web-search-provider.ts
 let braveWebSearchRuntimePromise;
 function loadBraveWebSearchRuntime() {
-	braveWebSearchRuntimePromise ??= import("./brave-web-search-provider.runtime-DqjJHSR5.js");
+	braveWebSearchRuntimePromise ??= import("./brave-web-search-provider.runtime-SKsUJmbH.js");
 	return braveWebSearchRuntimePromise;
 }
 const BraveSearchSchema = {

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

@@ -1,6 +1,6 @@
 import { normalizeLowercaseStringOrEmpty, normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { assertOkOrThrowProviderError, readProviderJsonResponse } from "openclaw/plugin-sdk/provider-http";
-import { DEFAULT_SEARCH_COUNT, MAX_SEARCH_COUNT, buildSearchCacheKey, formatCliCommand, normalizeFreshness, parseIsoDateRange, readCachedSearchPayload, readConfiguredSecretString, readPositiveIntegerParam, readProviderEnvValue, readStringParam, resolveSearchCacheTtlMs, resolveSearchCount, resolveSearchTimeoutSeconds, resolveSiteName, withSelfHostedWebSearchEndpoint, withTrustedWebSearchEndpoint, wrapWebContent, writeCachedSearchPayload } from "openclaw/plugin-sdk/provider-web-search";
+import { DEFAULT_SEARCH_COUNT, MAX_SEARCH_COUNT, buildSearchCacheKey, formatCliCommand, parseWebSearchTimeFilters, readCachedSearchPayload, readConfiguredSecretString, readPositiveIntegerParam, readProviderEnvValue, readStringParam, resolveSearchCacheTtlMs, resolveSearchCount, resolveSearchTimeoutSeconds, resolveSiteName, withSelfHostedWebSearchEndpoint, withTrustedWebSearchEndpoint, wrapWebContent, writeCachedSearchPayload } from "openclaw/plugin-sdk/provider-web-search";
 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
@@ -236,19 +236,23 @@ function missingBraveKeyPayload() {
 		docs: "https://docs.openclaw.ai/tools/web"
 	};
 }
-async function runBraveLlmContextSearch(params) {
-	const url = buildBraveEndpointUrl({
-		baseUrl: params.baseUrl,
-		endpointPath: BRAVE_LLM_CONTEXT_ENDPOINT_PATH
-	});
+function setBraveSearchUrlParams(url, params) {
 	url.searchParams.set("q", params.query);
 	if (params.country) url.searchParams.set("country", params.country);
 	if (params.search_lang) url.searchParams.set("search_lang", params.search_lang);
 	if (params.freshness) url.searchParams.set("freshness", params.freshness);
 	else if (params.dateAfter && params.dateBefore) url.searchParams.set("freshness", `${params.dateAfter}to${params.dateBefore}`);
 	else if (params.dateAfter) url.searchParams.set("freshness", `${params.dateAfter}to${(/* @__PURE__ */ new Date()).toISOString().slice(0, 10)}`);
+	else if (params.allowDateBeforeOnly && params.dateBefore) url.searchParams.set("freshness", `1970-01-01to${params.dateBefore}`);
+}
+async function runBraveJsonRequest(params, errorLabel) {
+	const url = buildBraveEndpointUrl({
+		baseUrl: params.baseUrl,
+		endpointPath: params.endpointPath
+	});
+	params.configureUrl(url);
 	logBraveHttp(params.diagnostics, "request", {
-		mode: "llm-context",
+		mode: params.mode,
 		...describeBraveRequestUrl(url)
 	});
 	const startedAt = Date.now();
@@ -264,69 +268,62 @@ async function runBraveLlmContextSearch(params) {
 		}
 	}, async (response) => {
 		logBraveHttp(params.diagnostics, "response", {
-			mode: "llm-context",
+			mode: params.mode,
 			status: response.status,
 			ok: response.ok,
 			durationMs: Date.now() - startedAt
 		});
-		await assertOkOrThrowProviderError(response, "Brave LLM Context API error");
-		const data = await readProviderJsonResponse(response, "Brave LLM Context API error");
-		return {
-			results: mapBraveLlmContextResults(data),
-			sources: data.sources
-		};
+		await assertOkOrThrowProviderError(response, errorLabel);
+		return readProviderJsonResponse(response, errorLabel);
 	});
 }
+async function runBraveLlmContextSearch(params) {
+	const data = await runBraveJsonRequest({
+		baseUrl: params.baseUrl,
+		endpointPath: BRAVE_LLM_CONTEXT_ENDPOINT_PATH,
+		mode: "llm-context",
+		endpointMode: params.endpointMode,
+		apiKey: params.apiKey,
+		timeoutSeconds: params.timeoutSeconds,
+		diagnostics: params.diagnostics,
+		configureUrl: (url) => {
+			setBraveSearchUrlParams(url, params);
+		}
+	}, "Brave LLM Context API error");
+	return {
+		results: mapBraveLlmContextResults(data),
+		sources: data.sources
+	};
+}
 async function runBraveWebSearch(params) {
-	const url = buildBraveEndpointUrl({
+	const data = await runBraveJsonRequest({
 		baseUrl: params.baseUrl,
-		endpointPath: BRAVE_SEARCH_ENDPOINT_PATH
-	});
-	url.searchParams.set("q", params.query);
-	url.searchParams.set("count", String(params.count));
-	if (params.country) url.searchParams.set("country", params.country);
-	if (params.search_lang) url.searchParams.set("search_lang", params.search_lang);
-	if (params.ui_lang) url.searchParams.set("ui_lang", params.ui_lang);
-	if (params.freshness) url.searchParams.set("freshness", params.freshness);
-	else if (params.dateAfter && params.dateBefore) url.searchParams.set("freshness", `${params.dateAfter}to${params.dateBefore}`);
-	else if (params.dateAfter) url.searchParams.set("freshness", `${params.dateAfter}to${(/* @__PURE__ */ new Date()).toISOString().slice(0, 10)}`);
-	else if (params.dateBefore) url.searchParams.set("freshness", `1970-01-01to${params.dateBefore}`);
-	logBraveHttp(params.diagnostics, "request", {
+		endpointPath: BRAVE_SEARCH_ENDPOINT_PATH,
 		mode: "web",
-		...describeBraveRequestUrl(url)
-	});
-	const startedAt = Date.now();
-	return (params.endpointMode === "selfHosted" ? withSelfHostedWebSearchEndpoint : withTrustedWebSearchEndpoint)({
-		url: url.toString(),
+		endpointMode: params.endpointMode,
+		apiKey: params.apiKey,
 		timeoutSeconds: params.timeoutSeconds,
-		init: {
-			method: "GET",
-			headers: {
-				Accept: "application/json",
-				"X-Subscription-Token": params.apiKey
-			}
+		diagnostics: params.diagnostics,
+		configureUrl: (url) => {
+			setBraveSearchUrlParams(url, {
+				...params,
+				allowDateBeforeOnly: true
+			});
+			url.searchParams.set("count", String(params.count));
+			if (params.ui_lang) url.searchParams.set("ui_lang", params.ui_lang);
 		}
-	}, async (response) => {
-		logBraveHttp(params.diagnostics, "response", {
-			mode: "web",
-			status: response.status,
-			ok: response.ok,
-			durationMs: Date.now() - startedAt
-		});
-		await assertOkOrThrowProviderError(response, "Brave Search API error");
-		const data = await readProviderJsonResponse(response, "Brave Search API error");
-		return (Array.isArray(data.web?.results) ? data.web?.results ?? [] : []).map((entry) => {
-			const description = entry.description ?? "";
-			const title = entry.title ?? "";
-			const url = entry.url ?? "";
-			return {
-				title: title ? wrapWebContent(title, "web_search") : "",
-				url,
-				description: description ? wrapWebContent(description, "web_search") : "",
-				published: entry.age || void 0,
-				siteName: resolveSiteName(url) || void 0
-			};
-		});
+	}, "Brave Search API error");
+	return (Array.isArray(data.web?.results) ? data.web?.results ?? [] : []).map((entry) => {
+		const description = entry.description ?? "";
+		const title = entry.title ?? "";
+		const url = entry.url ?? "";
+		return {
+			title: title ? wrapWebContent(title, "web_search") : "",
+			url,
+			description: description ? wrapWebContent(description, "web_search") : "",
+			published: entry.age || void 0,
+			siteName: resolveSiteName(url) || void 0
+		};
 	});
 }
 async function executeBraveSearch(args, searchConfig, options) {
@@ -365,28 +362,18 @@ async function executeBraveSearch(args, searchConfig, options) {
 		docs: "https://docs.openclaw.ai/tools/web"
 	};
 	const rawFreshness = readStringParam(args, "freshness");
-	const freshness = rawFreshness ? normalizeFreshness(rawFreshness, "brave") : void 0;
-	if (rawFreshness && !freshness) return {
-		error: "invalid_freshness",
-		message: "freshness must be day, week, month, or year.",
-		docs: "https://docs.openclaw.ai/tools/web"
-	};
-	const rawDateAfter = readStringParam(args, "date_after");
-	const rawDateBefore = readStringParam(args, "date_before");
-	if (rawFreshness && (rawDateAfter || rawDateBefore)) return {
-		error: "conflicting_time_filters",
-		message: "freshness and date_after/date_before cannot be used together. Use either freshness (day/week/month/year) or a date range (date_after/date_before), not both.",
-		docs: "https://docs.openclaw.ai/tools/web"
-	};
-	const parsedDateRange = parseIsoDateRange({
-		rawDateAfter,
-		rawDateBefore,
+	const parsedTimeFilters = parseWebSearchTimeFilters({
+		rawDateAfter: readStringParam(args, "date_after"),
+		rawDateBefore: readStringParam(args, "date_before"),
+		rawFreshness,
+		freshnessProvider: "brave",
+		invalidFreshnessMessage: "freshness must be day, week, month, or year.",
 		invalidDateAfterMessage: "date_after must be YYYY-MM-DD format.",
 		invalidDateBeforeMessage: "date_before must be YYYY-MM-DD format.",
 		invalidDateRangeMessage: "date_after must be before date_before."
 	});
-	if ("error" in parsedDateRange) return parsedDateRange;
-	const { dateAfter, dateBefore } = parsedDateRange;
+	if ("error" in parsedTimeFilters) return parsedTimeFilters;
+	const { freshness, dateAfter, dateBefore } = parsedTimeFilters;
 	if (braveMode === "llm-context") {
 		const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
 		if (dateAfter && !dateBefore && dateAfter > today) return {

package/dist/index.js

@@ -1,4 +1,4 @@
-import { t as createBraveWebSearchProvider } from "./brave-web-search-provider-CjlXA4SO.js";
+import { t as createBraveWebSearchProvider } from "./brave-web-search-provider-BzuOscZC.js";
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 //#region extensions/brave/index.ts
 var brave_default = definePluginEntry({

package/dist/web-search-provider.js

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

package/npm-shrinkwrap.json

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

package/package.json

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