@openclaw/exa-plugin 2026.10.10-beta.5 → 2026.11.5-beta.1

package/dist/.setup/{exa-web-search-provider-D4XL4FbA.mjs → exa-web-search-provider-9ilJPxIa.mjs}

@@ -1,6 +1,6 @@
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 import { createWebSearchProviderContractFields } from "openclaw/plugin-sdk/provider-web-search-contract";
-//#region extensions/exa/src/exa-web-search-provider.ts
+// extensions/exa/src/exa-web-search-provider.ts
 const EXA_CREDENTIAL_PATH = "plugins.entries.exa.config.webSearch.apiKey";
 const EXA_SEARCH_TYPES = [
 	"auto",
@@ -17,7 +17,7 @@ const EXA_FRESHNESS_VALUES = [
 	"year"
 ];
 const EXA_MAX_SEARCH_COUNT = 100;
-const loadExaWebSearchRuntime = createLazyRuntimeModule(() => import("./exa-web-search-provider.runtime-BHMevXlO.mjs"));
+const loadExaWebSearchRuntime = createLazyRuntimeModule(() => import("./exa-web-search-provider.runtime-Cyx_Cn4E.mjs"));
 const ExaSearchSchema = {
 	type: "object",
 	properties: {
@@ -94,5 +94,4 @@ function createExaWebSearchProvider() {
 		})
 	};
 }
-//#endregion
 export { createExaWebSearchProvider as t };

package/dist/.setup/exa-web-search-provider.runtime-Cyx_Cn4E.mjs

@@ -0,0 +1,234 @@
+import { sha256Hex } from "openclaw/plugin-sdk/node-crypto-runtime";
+import { parseStrictPositiveInteger } from "openclaw/plugin-sdk/number-runtime";
+import { ProviderHttpError, readProviderResponseErrorText, redactProviderResponseErrorText } from "openclaw/plugin-sdk/provider-http";
+import { DEFAULT_SEARCH_COUNT, buildSearchCacheKey, externalContentStamp, mergeScopedSearchConfig, parseIsoDateRange, readCachedSearchPayload, readPositiveIntegerParam, readStringParam, readWebSearchApiKey, resolveProviderWebSearchPluginConfig, resolveSearchCacheTtlMs, resolveSearchTimeoutSeconds, resolveSiteName, withTrustedWebSearchEndpoint, wrapWebContent, writeCachedSearchPayload } from "openclaw/plugin-sdk/provider-web-search";
+import { readResponseWithLimit } from "openclaw/plugin-sdk/response-limit-runtime";
+import { asOptionalObjectRecord, asOptionalRecord, isRecord, normalizeOptionalLowercaseString, normalizeOptionalString, normalizeTrimmedStringList } from "openclaw/plugin-sdk/string-coerce-runtime";
+// extensions/exa/src/exa-web-search-provider.runtime.ts
+const EXA_SEARCH_ENDPOINT = "https://api.exa.ai/search";
+const EXA_SEARCH_TYPES = [
+	"auto",
+	"neural",
+	"fast",
+	"deep",
+	"deep-reasoning",
+	"instant"
+];
+const EXA_FRESHNESS_VALUES = [
+	"day",
+	"week",
+	"month",
+	"year"
+];
+const EXA_MAX_SEARCH_COUNT = 100;
+const EXA_ERROR_BODY_LIMIT_BYTES = 8192;
+const EXA_SEARCH_JSON_MAX_BYTES = 16777216;
+function invalidBaseUrlPayload() {
+	return {
+		error: "invalid_base_url",
+		message: "plugins.entries.exa.config.webSearch.baseUrl must be a valid http(s) URL.",
+		docs: "https://docs.openclaw.ai/tools/exa-search"
+	};
+}
+function invalidContentsPayload(message) {
+	return {
+		error: "invalid_contents",
+		message,
+		docs: "https://docs.openclaw.ai/tools/web"
+	};
+}
+async function executeExaWebSearchProviderTool(ctx, args, signal) {
+	const searchConfig = mergeScopedSearchConfig(ctx.searchConfig, "exa", resolveProviderWebSearchPluginConfig(ctx.config, "exa"));
+	const exaConfig = asOptionalRecord(searchConfig?.exa);
+	const apiKey = readWebSearchApiKey(exaConfig?.apiKey, "plugins.entries.exa.config.webSearch.apiKey", ["EXA_API_KEY"]);
+	if (!apiKey) return {
+		error: "missing_exa_api_key",
+		message: "web_search (exa) needs an Exa API key. Set EXA_API_KEY in the Gateway environment, or configure plugins.entries.exa.config.webSearch.apiKey.",
+		docs: "https://docs.openclaw.ai/tools/web"
+	};
+	let endpoint = EXA_SEARCH_ENDPOINT;
+	const configured = normalizeOptionalString(exaConfig?.baseUrl);
+	if (configured) {
+		if (/^[a-z][a-z0-9+.-]*:\/\//i.test(configured) && !/^https?:\/\//i.test(configured)) return invalidBaseUrlPayload();
+		const candidate = /^https?:\/\//i.test(configured) ? configured : `https://${configured}`;
+		let parsed;
+		try {
+			parsed = new URL(candidate);
+		} catch {
+			return invalidBaseUrlPayload();
+		}
+		if (parsed.protocol !== "http:" && parsed.protocol !== "https:") return invalidBaseUrlPayload();
+		const pathname = parsed.pathname.replace(/\/+$/, "");
+		parsed.pathname = pathname.endsWith("/search") ? pathname : `${pathname}/search`;
+		parsed.hash = "";
+		endpoint = parsed.toString();
+	}
+	const query = readStringParam(args, "query", { required: true });
+	const rawType = readStringParam(args, "type");
+	const type = EXA_SEARCH_TYPES.find((candidate) => candidate === rawType) ?? "auto";
+	const count = readPositiveIntegerParam(args, "count", {
+		max: EXA_MAX_SEARCH_COUNT,
+		message: `count must be an integer from 1 to ${EXA_MAX_SEARCH_COUNT}.`
+	}) ?? searchConfig?.maxResults;
+	const rawFreshness = readStringParam(args, "freshness");
+	const normalizedFreshness = normalizeOptionalLowercaseString(rawFreshness);
+	const freshness = EXA_FRESHNESS_VALUES.find((value) => value === normalizedFreshness);
+	if (rawFreshness && !freshness) return {
+		error: "invalid_freshness",
+		message: "freshness must be one of \"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 (freshness && (rawDateAfter || rawDateBefore)) return {
+		error: "conflicting_time_filters",
+		message: "freshness cannot be combined with date_after or date_before. Use one time-filter mode.",
+		docs: "https://docs.openclaw.ai/tools/web"
+	};
+	const parsedDateRange = parseIsoDateRange({
+		rawDateAfter,
+		rawDateBefore,
+		invalidDateAfterMessage: "date_after must be YYYY-MM-DD format.",
+		invalidDateBeforeMessage: "date_before must be YYYY-MM-DD format.",
+		invalidDateRangeMessage: "date_after must be earlier than or equal to date_before."
+	});
+	if ("error" in parsedDateRange) return parsedDateRange;
+	const { dateAfter, dateBefore } = parsedDateRange;
+	const parsedContents = {};
+	const rawContents = args.contents;
+	if (rawContents !== void 0) {
+		if (!isRecord(rawContents)) return invalidContentsPayload("contents must be an object with optional text, highlights, and summary fields.");
+		const allowedKeys = /* @__PURE__ */ new Set([
+			"text",
+			"highlights",
+			"summary"
+		]);
+		for (const key of Object.keys(rawContents)) if (!allowedKeys.has(key)) return invalidContentsPayload(`contents has unknown field "${key}". Only "text", "highlights", and "summary" are allowed.`);
+		const fieldsBySection = {
+			text: ["maxCharacters"],
+			highlights: [
+				"maxCharacters",
+				"query",
+				"numSentences",
+				"highlightsPerUrl"
+			],
+			summary: ["query"]
+		};
+		for (const section of [
+			"text",
+			"highlights",
+			"summary"
+		]) {
+			if (!(section in rawContents)) continue;
+			const value = rawContents[section];
+			if (typeof value === "boolean") {
+				parsedContents[section] = value;
+				continue;
+			}
+			if (!isRecord(value)) return invalidContentsPayload(`contents.${section} must be a boolean or an object.`);
+			const option = value;
+			const fields = fieldsBySection[section];
+			for (const key of Object.keys(option)) if (!fields.includes(key)) return invalidContentsPayload(`contents.${section} has unknown field "${key}". ${section === "highlights" ? "Allowed fields are \"maxCharacters\", \"query\", \"numSentences\", and \"highlightsPerUrl\"." : `Only "${fields[0]}" is allowed.`}`);
+			for (const field of fields) if (field !== "query" && field in option && !(typeof option[field] === "number" && Number.isInteger(option[field]) && option[field] > 0)) return invalidContentsPayload(`contents.${section}.${field} must be a positive integer.`);
+			if (section !== "text" && "query" in option && typeof option.query !== "string") return invalidContentsPayload(`contents.${section}.query must be a string.`);
+			const normalized = {};
+			for (const field of fields) if (field in option) normalized[field] = option[field];
+			Object.assign(parsedContents, { [section]: normalized });
+		}
+	}
+	const contents = Object.keys(parsedContents).length > 0 ? parsedContents : void 0;
+	const resolvedCount = Math.min(EXA_MAX_SEARCH_COUNT, parseStrictPositiveInteger(count) ?? DEFAULT_SEARCH_COUNT);
+	const cacheKey = buildSearchCacheKey([
+		"exa",
+		sha256Hex(apiKey),
+		endpoint,
+		type,
+		query,
+		resolvedCount,
+		freshness,
+		dateAfter,
+		dateBefore,
+		JSON.stringify(contents ?? { highlights: true })
+	]);
+	const cacheTtlMs = resolveSearchCacheTtlMs(searchConfig);
+	const cached = readCachedSearchPayload(cacheKey, cacheTtlMs);
+	if (cached) return cached;
+	const start = Date.now();
+	const timeoutSeconds = resolveSearchTimeoutSeconds(searchConfig);
+	const body = {
+		query,
+		numResults: resolvedCount,
+		type,
+		contents: contents ?? { highlights: true }
+	};
+	if (dateAfter) body.startPublishedDate = dateAfter;
+	else if (freshness) {
+		const now = /* @__PURE__ */ new Date();
+		if (freshness === "day") now.setUTCDate(now.getUTCDate() - 1);
+		else if (freshness === "week") now.setUTCDate(now.getUTCDate() - 7);
+		else if (freshness === "month") {
+			const currentDay = now.getUTCDate();
+			now.setUTCDate(1);
+			now.setUTCMonth(now.getUTCMonth() - 1);
+			const lastDayOfTargetMonth = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth() + 1, 0)).getUTCDate();
+			now.setUTCDate(Math.min(currentDay, lastDayOfTargetMonth));
+		} else now.setUTCFullYear(now.getUTCFullYear() - 1);
+		body.startPublishedDate = now.toISOString();
+	}
+	if (dateBefore) body.endPublishedDate = dateBefore;
+	const headers = {
+		Accept: "application/json",
+		"Content-Type": "application/json",
+		"x-api-key": apiKey,
+		"x-exa-integration": "openclaw"
+	};
+	const results = await withTrustedWebSearchEndpoint({
+		url: endpoint,
+		timeoutSeconds,
+		signal,
+		init: {
+			method: "POST",
+			headers,
+			body: JSON.stringify(body)
+		}
+	}, async (res) => {
+		if (!res.ok) {
+			const detail = await readProviderResponseErrorText(res, EXA_ERROR_BODY_LIMIT_BYTES, headers, signal);
+			throw new ProviderHttpError(`Exa API error (${res.status}): ${detail || redactProviderResponseErrorText(res.statusText, headers)}`, { status: res.status });
+		}
+		const bytes = await readResponseWithLimit(res, EXA_SEARCH_JSON_MAX_BYTES, { onOverflow: ({ maxBytes: maxBytesLocal }) => /* @__PURE__ */ new Error(`Exa API response exceeds ${maxBytesLocal} bytes`) });
+		try {
+			const payload = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes));
+			const rows = asOptionalObjectRecord(payload)?.results;
+			return (Array.isArray(rows) ? rows.filter(isRecord) : []).slice(0, resolvedCount);
+		} catch (cause) {
+			throw new Error("Exa API returned malformed JSON", { cause });
+		}
+	});
+	signal?.throwIfAborted();
+	const payload = {
+		query,
+		provider: "exa",
+		count: results.length,
+		tookMs: Date.now() - start,
+		externalContent: externalContentStamp("exa"),
+		results: results.map((entry) => {
+			const title = typeof entry.title === "string" ? entry.title : "";
+			const url = typeof entry.url === "string" ? entry.url : "";
+			const description = normalizeTrimmedStringList(entry.highlights).join("\n") || normalizeOptionalString(entry.summary) || normalizeOptionalString(entry.text) || "";
+			const summary = normalizeOptionalString(entry.summary) ?? "";
+			const highlightScores = Array.isArray(entry.highlightScores) ? entry.highlightScores.filter((score) => typeof score === "number" && Number.isFinite(score)) : [];
+			const published = typeof entry.publishedDate === "string" && entry.publishedDate ? entry.publishedDate : void 0;
+			return Object.assign({
+				title: title ? wrapWebContent(title, `web_search`) : ``,
+				url,
+				description: description ? wrapWebContent(description, `web_search`) : ``,
+				published,
+				siteName: resolveSiteName(url) || void 0
+			}, summary ? { summary: wrapWebContent(summary, `web_search`) } : {}, highlightScores.length > 0 ? { highlightScores } : {});
+		})
+	};
+	writeCachedSearchPayload(cacheKey, payload, cacheTtlMs);
+	return payload;
+}
+export { executeExaWebSearchProviderTool };

package/dist/.source-module-urls/5cfcb03c5b0024dec174889a3f9c18da47ed3402dc2c1542d3c7152d85411a6d.json

@@ -1 +1 @@
-{"version":3,"entries":[{"output":"index.js","source":"extensions/exa/index.ts"},{"output":"web-search-contract-api.js","source":"extensions/exa/web-search-contract-api.ts"},{"output":"web-search-provider.js","source":"extensions/exa/web-search-provider.ts"}],"chunks":[{"output":".setup/exa-web-search-provider-D4XL4FbA.mjs","sha256":"ff4076f65d5805620dd6bef6926a8af9532bda8ebeb16a19d9d397d2bfacd8a8","facadeSource":null,"sources":["extensions/exa/src/exa-web-search-provider.ts"]},{"output":".setup/exa-web-search-provider.runtime-BHMevXlO.mjs","sha256":"a72abd12d5fc1be0282b78c4a20bc47dfec001a2c507019008a4a2d14411f6b5","facadeSource":"extensions/exa/src/exa-web-search-provider.runtime.ts","sources":["extensions/exa/src/exa-web-search-provider.runtime.ts"]},{"output":"index.js","sha256":"93e440b278672a33fcbe10570119060f8f414632fbe05bf04771b65b038397f4","facadeSource":"extensions/exa/index.ts","sources":["extensions/exa/index.ts"]},{"output":"web-search-contract-api.js","sha256":"8b9afbbff151a0c846cfac5561bd89972d67ba43d6057eb728b23282526ad6ad","facadeSource":"extensions/exa/web-search-contract-api.ts","sources":[]},{"output":"web-search-provider.js","sha256":"ebb4426904f3597aac31c81c3adb691a0ad470a9c000514bf528ceca90dff029","facadeSource":"extensions/exa/web-search-provider.ts","sources":[]}],"unrenderedSources":["extensions/exa/web-search-contract-api.ts","extensions/exa/web-search-provider.ts"]}
+{"version":3,"entries":[{"output":"index.js","source":"extensions/exa/index.ts"},{"output":"web-search-contract-api.js","source":"extensions/exa/web-search-contract-api.ts"},{"output":"web-search-provider.js","source":"extensions/exa/web-search-provider.ts"}],"chunks":[{"output":".setup/exa-web-search-provider-9ilJPxIa.mjs","sha256":"7848e32ecdf272b34d2b848c2c598860a056286519108ef2332adbff7f57e4bb","facadeSource":null,"sources":["extensions/exa/src/exa-web-search-provider.ts"]},{"output":".setup/exa-web-search-provider.runtime-Cyx_Cn4E.mjs","sha256":"6c96f753cdc3988c4c61316af73322de9ea892ab44cc5a1564487ba2d80eb88b","facadeSource":"extensions/exa/src/exa-web-search-provider.runtime.ts","sources":["extensions/exa/src/exa-web-search-provider.runtime.ts"]},{"output":"index.js","sha256":"f0c0714147e48fb96b10c63c71086ae926b95410fd15da94c3512300ce3e4f05","facadeSource":"extensions/exa/index.ts","sources":["extensions/exa/index.ts"]},{"output":"web-search-contract-api.js","sha256":"62cf1f37c9b0231bbefb3e888395ee4dce094e3da087bacef986b9e30d91fe7e","facadeSource":"extensions/exa/web-search-contract-api.ts","sources":[]},{"output":"web-search-provider.js","sha256":"63a6db6f966c7c513ce0ad97e1afb68c5ad6be28866dad8de9c6d8b311d25848","facadeSource":"extensions/exa/web-search-provider.ts","sources":[]}],"unrenderedSources":["extensions/exa/web-search-contract-api.ts","extensions/exa/web-search-provider.ts"]}

package/dist/index.js

@@ -1,6 +1,6 @@
-import { t as createExaWebSearchProvider } from "./.setup/exa-web-search-provider-D4XL4FbA.mjs";
+import { t as createExaWebSearchProvider } from "./.setup/exa-web-search-provider-9ilJPxIa.mjs";
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
-//#region extensions/exa/index.ts
+// extensions/exa/index.ts
 var exa_default = definePluginEntry({
 	id: "exa",
 	name: "Exa Plugin",
@@ -9,5 +9,4 @@ var exa_default = definePluginEntry({
 		api.registerWebSearchProvider(createExaWebSearchProvider());
 	}
 });
-//#endregion
 export { exa_default as default };

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

@@ -1,2 +1,2 @@
-export { t as createExaWebSearchProvider } from "./.setup/exa-web-search-provider-D4XL4FbA.mjs";
+export { t as createExaWebSearchProvider } from "./.setup/exa-web-search-provider-9ilJPxIa.mjs";
 import "./web-search-provider.js";

package/dist/web-search-provider.js

@@ -1 +1 @@
-export { t as createExaWebSearchProvider } from "./.setup/exa-web-search-provider-D4XL4FbA.mjs";
+export { t as createExaWebSearchProvider } from "./.setup/exa-web-search-provider-9ilJPxIa.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/exa-plugin",
-  "version": "2026.10.10-beta.5",
+  "version": "2026.11.5-beta.1",
   "description": "OpenClaw Exa plugin.",
   "repository": {
     "type": "git",
@@ -18,10 +18,10 @@
       "minHostVersion": ">=2026.6.8"
     },
     "compat": {
-      "pluginApi": ">=2026.10.10-beta.5"
+      "pluginApi": ">=2026.11.5-beta.1"
     },
     "build": {
-      "openclawVersion": "2026.10.10-beta.5",
+      "openclawVersion": "2026.11.5-beta.1",
       "bundledDist": false
     },
     "release": {
@@ -40,7 +40,7 @@
     "assets/activity.svg"
   ],
   "peerDependencies": {
-    "openclaw": ">=2026.10.10-beta.5"
+    "openclaw": ">=2026.11.5-beta.1"
   },
   "peerDependenciesMeta": {
     "openclaw": {

package/dist/.setup/exa-web-search-provider.runtime-BHMevXlO.mjs

@@ -1,262 +0,0 @@
-import { parseStrictPositiveInteger } from "openclaw/plugin-sdk/number-runtime";
-import { ProviderHttpError, readResponseTextLimited } from "openclaw/plugin-sdk/provider-http";
-import { DEFAULT_SEARCH_COUNT, buildSearchCacheKey, mergeScopedSearchConfig, parseIsoDateRange, readCachedSearchPayload, readConfiguredSecretString, readPositiveIntegerParam, readProviderEnvValue, readStringParam, resolveProviderWebSearchPluginConfig, resolveSearchCacheTtlMs, resolveSearchTimeoutSeconds, resolveSiteName, withTrustedWebSearchEndpoint, wrapWebContent, writeCachedSearchPayload } from "openclaw/plugin-sdk/provider-web-search";
-import { readResponseWithLimit } from "openclaw/plugin-sdk/response-limit-runtime";
-import { asOptionalObjectRecord, asOptionalRecord, isRecord, normalizeOptionalLowercaseString, normalizeOptionalString, normalizeTrimmedStringList } from "openclaw/plugin-sdk/string-coerce-runtime";
-//#region extensions/exa/src/exa-web-search-provider.runtime.ts
-const EXA_SEARCH_ENDPOINT = "https://api.exa.ai/search";
-const EXA_SEARCH_TYPES = [
-	"auto",
-	"neural",
-	"fast",
-	"deep",
-	"deep-reasoning",
-	"instant"
-];
-const EXA_FRESHNESS_VALUES = [
-	"day",
-	"week",
-	"month",
-	"year"
-];
-const EXA_MAX_SEARCH_COUNT = 100;
-const EXA_ERROR_BODY_LIMIT_BYTES = 8192;
-const EXA_SEARCH_JSON_MAX_BYTES = 16777216;
-async function readExaSearchResults(response) {
-	const bytes = await readResponseWithLimit(response, EXA_SEARCH_JSON_MAX_BYTES, { onOverflow: ({ maxBytes: maxBytesLocal }) => /* @__PURE__ */ new Error(`Exa API response exceeds ${maxBytesLocal} bytes`) });
-	try {
-		const payload = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes));
-		const results = asOptionalObjectRecord(payload)?.results;
-		return Array.isArray(results) ? results.filter(isRecord) : [];
-	} catch (cause) {
-		throw new Error("Exa API returned malformed JSON", { cause });
-	}
-}
-function normalizeExaFreshness(value) {
-	const trimmed = normalizeOptionalLowercaseString(value);
-	return EXA_FRESHNESS_VALUES.find((freshness) => freshness === trimmed);
-}
-function resolveExaApiKey(exa) {
-	return readConfiguredSecretString(exa?.apiKey, "plugins.entries.exa.config.webSearch.apiKey") ?? readProviderEnvValue(["EXA_API_KEY"]);
-}
-function invalidBaseUrlPayload() {
-	return {
-		error: "invalid_base_url",
-		message: "plugins.entries.exa.config.webSearch.baseUrl must be a valid http(s) URL.",
-		docs: "https://docs.openclaw.ai/tools/exa-search"
-	};
-}
-function resolveExaSearchEndpoint(exa) {
-	const configured = normalizeOptionalString(exa?.baseUrl);
-	if (!configured) return { endpoint: EXA_SEARCH_ENDPOINT };
-	if (/^[a-z][a-z0-9+.-]*:\/\//i.test(configured) && !/^https?:\/\//i.test(configured)) return invalidBaseUrlPayload();
-	const candidate = /^https?:\/\//i.test(configured) ? configured : `https://${configured}`;
-	let parsed;
-	try {
-		parsed = new URL(candidate);
-	} catch {
-		return invalidBaseUrlPayload();
-	}
-	if (parsed.protocol !== "http:" && parsed.protocol !== "https:") return invalidBaseUrlPayload();
-	const pathname = parsed.pathname.replace(/\/+$/, "");
-	parsed.pathname = pathname.endsWith("/search") ? pathname : `${pathname}/search`;
-	parsed.hash = "";
-	return { endpoint: parsed.toString() };
-}
-function invalidContentsPayload(message) {
-	return {
-		error: "invalid_contents",
-		message,
-		docs: "https://docs.openclaw.ai/tools/web"
-	};
-}
-function parseExaContents(rawContents) {
-	if (rawContents === void 0) return { value: void 0 };
-	if (!isRecord(rawContents)) return invalidContentsPayload("contents must be an object with optional text, highlights, and summary fields.");
-	const raw = rawContents;
-	const allowedKeys = /* @__PURE__ */ new Set([
-		"text",
-		"highlights",
-		"summary"
-	]);
-	for (const key of Object.keys(raw)) if (!allowedKeys.has(key)) return invalidContentsPayload(`contents has unknown field "${key}". Only "text", "highlights", and "summary" are allowed.`);
-	const parsed = {};
-	const fieldsBySection = {
-		text: ["maxCharacters"],
-		highlights: [
-			"maxCharacters",
-			"query",
-			"numSentences",
-			"highlightsPerUrl"
-		],
-		summary: ["query"]
-	};
-	for (const section of [
-		"text",
-		"highlights",
-		"summary"
-	]) {
-		if (!(section in raw)) continue;
-		const value = raw[section];
-		if (typeof value === "boolean") {
-			parsed[section] = value;
-			continue;
-		}
-		if (!isRecord(value)) return invalidContentsPayload(`contents.${section} must be a boolean or an object.`);
-		const option = value;
-		const fields = fieldsBySection[section];
-		for (const key of Object.keys(option)) if (!fields.includes(key)) return invalidContentsPayload(`contents.${section} has unknown field "${key}". ${section === "highlights" ? "Allowed fields are \"maxCharacters\", \"query\", \"numSentences\", and \"highlightsPerUrl\"." : `Only "${fields[0]}" is allowed.`}`);
-		for (const field of fields) if (field !== "query" && field in option && !(typeof option[field] === "number" && Number.isInteger(option[field]) && option[field] > 0)) return invalidContentsPayload(`contents.${section}.${field} must be a positive integer.`);
-		if (section !== "text" && "query" in option && typeof option.query !== "string") return invalidContentsPayload(`contents.${section}.query must be a string.`);
-		const normalized = {};
-		for (const field of fields) if (field in option) normalized[field] = option[field];
-		Object.assign(parsed, { [section]: normalized });
-	}
-	return { value: parsed };
-}
-function resolveFreshnessStartDate(freshness) {
-	const now = /* @__PURE__ */ new Date();
-	if (freshness === "day") {
-		now.setUTCDate(now.getUTCDate() - 1);
-		return now.toISOString();
-	}
-	if (freshness === "week") {
-		now.setUTCDate(now.getUTCDate() - 7);
-		return now.toISOString();
-	}
-	if (freshness === "month") {
-		const currentDay = now.getUTCDate();
-		now.setUTCDate(1);
-		now.setUTCMonth(now.getUTCMonth() - 1);
-		const lastDayOfTargetMonth = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth() + 1, 0)).getUTCDate();
-		now.setUTCDate(Math.min(currentDay, lastDayOfTargetMonth));
-		return now.toISOString();
-	}
-	now.setUTCFullYear(now.getUTCFullYear() - 1);
-	return now.toISOString();
-}
-async function executeExaWebSearchProviderTool(ctx, args, signal) {
-	const searchConfig = mergeScopedSearchConfig(ctx.searchConfig, "exa", resolveProviderWebSearchPluginConfig(ctx.config, "exa"));
-	const exaConfig = asOptionalRecord(searchConfig?.exa);
-	const apiKey = resolveExaApiKey(exaConfig);
-	if (!apiKey) return {
-		error: "missing_exa_api_key",
-		message: "web_search (exa) needs an Exa API key. Set EXA_API_KEY in the Gateway environment, or configure plugins.entries.exa.config.webSearch.apiKey.",
-		docs: "https://docs.openclaw.ai/tools/web"
-	};
-	const endpointResult = resolveExaSearchEndpoint(exaConfig);
-	if ("error" in endpointResult) return endpointResult;
-	const endpoint = endpointResult.endpoint;
-	const query = readStringParam(args, "query", { required: true });
-	const rawType = readStringParam(args, "type");
-	const type = EXA_SEARCH_TYPES.find((candidate) => candidate === rawType) ?? "auto";
-	const count = readPositiveIntegerParam(args, "count", {
-		max: EXA_MAX_SEARCH_COUNT,
-		message: `count must be an integer from 1 to ${EXA_MAX_SEARCH_COUNT}.`
-	}) ?? searchConfig?.maxResults ?? void 0;
-	const rawFreshness = readStringParam(args, "freshness");
-	const freshness = normalizeExaFreshness(rawFreshness);
-	if (rawFreshness && !freshness) return {
-		error: "invalid_freshness",
-		message: "freshness must be one of \"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 (freshness && (rawDateAfter || rawDateBefore)) return {
-		error: "conflicting_time_filters",
-		message: "freshness cannot be combined with date_after or date_before. Use one time-filter mode.",
-		docs: "https://docs.openclaw.ai/tools/web"
-	};
-	const parsedDateRange = parseIsoDateRange({
-		rawDateAfter,
-		rawDateBefore,
-		invalidDateAfterMessage: "date_after must be YYYY-MM-DD format.",
-		invalidDateBeforeMessage: "date_before must be YYYY-MM-DD format.",
-		invalidDateRangeMessage: "date_after must be earlier than or equal to date_before."
-	});
-	if ("error" in parsedDateRange) return parsedDateRange;
-	const { dateAfter, dateBefore } = parsedDateRange;
-	const parsedContents = parseExaContents(args.contents);
-	if ("error" in parsedContents) return parsedContents;
-	const contents = parsedContents.value && Object.keys(parsedContents.value).length > 0 ? parsedContents.value : void 0;
-	const resolvedCount = Math.min(EXA_MAX_SEARCH_COUNT, parseStrictPositiveInteger(count) ?? DEFAULT_SEARCH_COUNT);
-	const cacheKey = buildSearchCacheKey([
-		"exa",
-		endpoint,
-		type,
-		query,
-		resolvedCount,
-		freshness,
-		dateAfter,
-		dateBefore,
-		JSON.stringify(contents ?? { highlights: true })
-	]);
-	const cacheTtlMs = resolveSearchCacheTtlMs(searchConfig);
-	const cached = readCachedSearchPayload(cacheKey, cacheTtlMs);
-	if (cached) return cached;
-	const start = Date.now();
-	const timeoutSeconds = resolveSearchTimeoutSeconds(searchConfig);
-	const body = {
-		query,
-		numResults: resolvedCount,
-		type,
-		contents: contents ?? { highlights: true }
-	};
-	if (dateAfter) body.startPublishedDate = dateAfter;
-	else if (freshness) body.startPublishedDate = resolveFreshnessStartDate(freshness);
-	if (dateBefore) body.endPublishedDate = dateBefore;
-	const results = await withTrustedWebSearchEndpoint({
-		url: endpoint,
-		timeoutSeconds,
-		signal,
-		init: {
-			method: "POST",
-			headers: {
-				Accept: "application/json",
-				"Content-Type": "application/json",
-				"x-api-key": apiKey,
-				"x-exa-integration": "openclaw"
-			},
-			body: JSON.stringify(body)
-		}
-	}, async (res) => {
-		if (!res.ok) {
-			const detail = await readResponseTextLimited(res, EXA_ERROR_BODY_LIMIT_BYTES);
-			throw new ProviderHttpError(`Exa API error (${res.status}): ${detail || res.statusText}`, { status: res.status });
-		}
-		return (await readExaSearchResults(res)).slice(0, resolvedCount);
-	});
-	signal?.throwIfAborted();
-	const payload = {
-		query,
-		provider: "exa",
-		count: results.length,
-		tookMs: Date.now() - start,
-		externalContent: {
-			untrusted: true,
-			source: "web_search",
-			provider: "exa",
-			wrapped: true
-		},
-		results: results.map((entry) => {
-			const title = typeof entry.title === "string" ? entry.title : "";
-			const url = typeof entry.url === "string" ? entry.url : "";
-			const description = normalizeTrimmedStringList(entry.highlights).join("\n") || normalizeOptionalString(entry.summary) || normalizeOptionalString(entry.text) || "";
-			const summary = normalizeOptionalString(entry.summary) ?? "";
-			const highlightScores = Array.isArray(entry.highlightScores) ? entry.highlightScores.filter((score) => typeof score === "number" && Number.isFinite(score)) : [];
-			const published = typeof entry.publishedDate === "string" && entry.publishedDate ? entry.publishedDate : void 0;
-			return Object.assign({
-				title: title ? wrapWebContent(title, `web_search`) : ``,
-				url,
-				description: description ? wrapWebContent(description, `web_search`) : ``,
-				published,
-				siteName: resolveSiteName(url) || void 0
-			}, summary ? { summary: wrapWebContent(summary, `web_search`) } : {}, highlightScores.length > 0 ? { highlightScores } : {});
-		})
-	};
-	writeCachedSearchPayload(cacheKey, payload, cacheTtlMs);
-	return payload;
-}
-//#endregion
-export { executeExaWebSearchProviderTool };