@openclaw/exa-plugin 2026.11.3 → 2026.11.5-beta.2

package/dist/.setup/{exa-web-search-provider-UdcmLdNp.mjs → exa-web-search-provider-D2HeogPB.mjs}

@@ -17,7 +17,7 @@ const EXA_FRESHNESS_VALUES = [
 	"year"
 ];
 const EXA_MAX_SEARCH_COUNT = 100;
-const loadExaWebSearchRuntime = createLazyRuntimeModule(() => import("./exa-web-search-provider.runtime-C73kkrxv.mjs"));
+const loadExaWebSearchRuntime = createLazyRuntimeModule(() => import("./exa-web-search-provider.runtime-DgICTEId.mjs"));
 const ExaSearchSchema = {
 	type: "object",
 	properties: {

package/dist/.setup/{exa-web-search-provider.runtime-C73kkrxv.mjs → exa-web-search-provider.runtime-DgICTEId.mjs}

@@ -1,7 +1,7 @@
-import { createHash } from "node:crypto";
+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, mergeScopedSearchConfig, parseIsoDateRange, readCachedSearchPayload, readConfiguredSecretString, readPositiveIntegerParam, readProviderEnvValue, readStringParam, resolveProviderWebSearchPluginConfig, resolveSearchCacheTtlMs, resolveSearchTimeoutSeconds, resolveSiteName, withTrustedWebSearchEndpoint, wrapWebContent, writeCachedSearchPayload } from "openclaw/plugin-sdk/provider-web-search";
+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";
 //#region extensions/exa/src/exa-web-search-provider.runtime.ts
@@ -23,23 +23,6 @@ const EXA_FRESHNESS_VALUES = [
 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",
@@ -47,23 +30,6 @@ function invalidBaseUrlPayload() {
 		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",
@@ -71,92 +37,42 @@ function invalidContentsPayload(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);
+	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"
 	};
-	const endpointResult = resolveExaSearchEndpoint(exaConfig);
-	if ("error" in endpointResult) return endpointResult;
-	const endpoint = endpointResult.endpoint;
+	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 ?? void 0;
+	}) ?? searchConfig?.maxResults;
 	const rawFreshness = readStringParam(args, "freshness");
-	const freshness = normalizeExaFreshness(rawFreshness);
+	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\".",
@@ -178,13 +94,53 @@ async function executeExaWebSearchProviderTool(ctx, args, signal) {
 	});
 	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 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",
-		createHash("sha256").update(apiKey).digest("hex"),
+		sha256Hex(apiKey),
 		endpoint,
 		type,
 		query,
@@ -206,7 +162,19 @@ async function executeExaWebSearchProviderTool(ctx, args, signal) {
 		contents: contents ?? { highlights: true }
 	};
 	if (dateAfter) body.startPublishedDate = dateAfter;
-	else if (freshness) body.startPublishedDate = resolveFreshnessStartDate(freshness);
+	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",
@@ -228,7 +196,14 @@ async function executeExaWebSearchProviderTool(ctx, args, signal) {
 			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 });
 		}
-		return (await readExaSearchResults(res)).slice(0, resolvedCount);
+		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 = {
@@ -236,12 +211,7 @@ async function executeExaWebSearchProviderTool(ctx, args, signal) {
 		provider: "exa",
 		count: results.length,
 		tookMs: Date.now() - start,
-		externalContent: {
-			untrusted: true,
-			source: "web_search",
-			provider: "exa",
-			wrapped: true
-		},
+		externalContent: externalContentStamp("exa"),
 		results: results.map((entry) => {
 			const title = typeof entry.title === "string" ? entry.title : "";
 			const url = typeof entry.url === "string" ? entry.url : "";

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

@@ -0,0 +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-D2HeogPB.mjs","sha256":"0376e59d945efe6e5dbef89207a011a0a51759b809d3bd91528af9a5c1fed5d4","facadeSource":null,"sources":["extensions/exa/src/exa-web-search-provider.ts"]},{"output":".setup/exa-web-search-provider.runtime-DgICTEId.mjs","sha256":"c748c42f12fbd97cba1a6d541950ba07a1618d18e4b314aebb25727b5aeb8439","facadeSource":"extensions/exa/src/exa-web-search-provider.runtime.ts","sources":["extensions/exa/src/exa-web-search-provider.runtime.ts"]},{"output":"index.js","sha256":"703c4ed77aa96f5957c8c49249c31530654d9d746e8c7639641184bdb0a00874","facadeSource":"extensions/exa/index.ts","sources":["extensions/exa/index.ts"]},{"output":"web-search-contract-api.js","sha256":"1971df1282041c8023828af88b4ce58e91c068917b10fd16ded2fd71dbc6ac42","facadeSource":"extensions/exa/web-search-contract-api.ts","sources":[]},{"output":"web-search-provider.js","sha256":"2b368e8fb211191494aaf0db90c8478a66c86bcd99368e2c1f09b75560f96f59","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,4 +1,4 @@
-import { t as createExaWebSearchProvider } from "./.setup/exa-web-search-provider-UdcmLdNp.mjs";
+import { t as createExaWebSearchProvider } from "./.setup/exa-web-search-provider-D2HeogPB.mjs";
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
 //#region extensions/exa/index.ts
 var exa_default = definePluginEntry({

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

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

package/dist/web-search-provider.js

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

package/package.json

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