@openclaw/exa-plugin 2026.9.7 → 2026.10.1-beta.1

package/dist/.setup/{exa-web-search-provider-DgKhV-9B.mjs → exa-web-search-provider-DkWJpeaV.mjs}

@@ -1,34 +1,7 @@
 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.shared.ts
-const EXA_CREDENTIAL_PATH = "plugins.entries.exa.config.webSearch.apiKey";
-const EXA_ONBOARDING_SCOPES = ["text-inference"];
-function createExaWebSearchProviderBase() {
-	return {
-		id: "exa",
-		label: "Exa Search",
-		hint: "Neural + keyword search with date filters and content extraction",
-		onboardingScopes: [...EXA_ONBOARDING_SCOPES],
-		credentialLabel: "Exa API key",
-		envVars: ["EXA_API_KEY"],
-		placeholder: "exa-...",
-		signupUrl: "https://exa.ai/",
-		docsUrl: "https://docs.openclaw.ai/tools/web",
-		autoDetectOrder: 65,
-		credentialPath: EXA_CREDENTIAL_PATH,
-		...createWebSearchProviderContractFields({
-			credentialPath: EXA_CREDENTIAL_PATH,
-			searchCredential: {
-				type: "scoped",
-				scopeId: "exa"
-			},
-			configuredCredential: { pluginId: "exa" },
-			selectionPluginId: "exa"
-		})
-	};
-}
-//#endregion
 //#region extensions/exa/src/exa-web-search-provider.ts
+const EXA_CREDENTIAL_PATH = "plugins.entries.exa.config.webSearch.apiKey";
 const EXA_SEARCH_TYPES = [
 	"auto",
 	"neural",
@@ -44,7 +17,7 @@ const EXA_FRESHNESS_VALUES = [
 	"year"
 ];
 const EXA_MAX_SEARCH_COUNT = 100;
-const loadExaWebSearchRuntime = createLazyRuntimeModule(() => import("./exa-web-search-provider.runtime-DE40-fMu.mjs"));
+const loadExaWebSearchRuntime = createLazyRuntimeModule(() => import("./exa-web-search-provider.runtime-ClUkM3ZN.mjs"));
 const ExaSearchSchema = {
 	type: "object",
 	properties: {
@@ -90,7 +63,26 @@ const ExaSearchSchema = {
 };
 function createExaWebSearchProvider() {
 	return {
-		...createExaWebSearchProviderBase(),
+		id: "exa",
+		label: "Exa Search",
+		hint: "Neural + keyword search with date filters and content extraction",
+		onboardingScopes: ["text-inference"],
+		credentialLabel: "Exa API key",
+		envVars: ["EXA_API_KEY"],
+		placeholder: "exa-...",
+		signupUrl: "https://exa.ai/",
+		docsUrl: "https://docs.openclaw.ai/tools/web",
+		autoDetectOrder: 65,
+		credentialPath: EXA_CREDENTIAL_PATH,
+		...createWebSearchProviderContractFields({
+			credentialPath: EXA_CREDENTIAL_PATH,
+			searchCredential: {
+				type: "scoped",
+				scopeId: "exa"
+			},
+			configuredCredential: { pluginId: "exa" },
+			selectionPluginId: "exa"
+		}),
 		createTool: (ctx) => ({
 			description: "Search the web using Exa AI. Supports neural or keyword search, publication date filters, and optional highlights or text extraction.",
 			parameters: ExaSearchSchema,

package/dist/.setup/{exa-web-search-provider.runtime-DE40-fMu.mjs → exa-web-search-provider.runtime-ClUkM3ZN.mjs}

@@ -2,7 +2,7 @@ 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 } from "openclaw/plugin-sdk/string-coerce-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 = [
@@ -25,15 +25,16 @@ 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 {
-		return normalizeExaResults(JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes)));
+		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);
-	if (!trimmed) return;
-	return EXA_FRESHNESS_VALUES.includes(trimmed) ? trimmed : void 0;
+	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"]);
@@ -58,23 +59,10 @@ function resolveExaSearchEndpoint(exa) {
 	}
 	if (parsed.protocol !== "http:" && parsed.protocol !== "https:") return invalidBaseUrlPayload(configured);
 	const pathname = parsed.pathname.replace(/\/+$/, "");
-	parsed.pathname = pathname.endsWith("/search") ? pathname : `${pathname === "" ? "" : pathname}/search`;
+	parsed.pathname = pathname.endsWith("/search") ? pathname : `${pathname}/search`;
 	parsed.hash = "";
 	return { endpoint: parsed.toString() };
 }
-function resolveExaDescription(result) {
-	const highlights = result.highlights;
-	if (Array.isArray(highlights)) {
-		const highlightText = highlights.map((entry) => normalizeOptionalString(entry)).filter((entry) => Boolean(entry)).join("\n");
-		if (highlightText) return highlightText;
-	}
-	const summary = normalizeOptionalString(result.summary);
-	if (summary) return summary;
-	return normalizeOptionalString(result.text) ?? "";
-}
-function parsePositiveInteger(value) {
-	return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : void 0;
-}
 function invalidContentsPayload(message) {
 	return {
 		error: "invalid_contents",
@@ -118,7 +106,7 @@ function parseExaContents(rawContents) {
 		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 && parsePositiveInteger(option[field]) === void 0) return invalidContentsPayload(`contents.${section}.${field} must be a positive integer.`);
+		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];
@@ -126,10 +114,6 @@ function parseExaContents(rawContents) {
 	}
 	return { value: parsed };
 }
-function normalizeExaResults(payload) {
-	const results = asOptionalObjectRecord(payload)?.results;
-	return Array.isArray(results) ? results.filter(isRecord) : [];
-}
 function resolveFreshnessStartDate(freshness) {
 	const now = /* @__PURE__ */ new Date();
 	if (freshness === "day") {
@@ -151,70 +135,21 @@ function resolveFreshnessStartDate(freshness) {
 	now.setUTCFullYear(now.getUTCFullYear() - 1);
 	return now.toISOString();
 }
-async function runExaSearch(params) {
-	const body = {
-		query: params.query,
-		numResults: params.count,
-		type: params.type,
-		contents: params.contents ?? { highlights: true }
-	};
-	if (params.dateAfter) body.startPublishedDate = params.dateAfter;
-	else if (params.freshness) body.startPublishedDate = resolveFreshnessStartDate(params.freshness);
-	if (params.dateBefore) body.endPublishedDate = params.dateBefore;
-	return withTrustedWebSearchEndpoint({
-		url: params.endpoint,
-		timeoutSeconds: params.timeoutSeconds,
-		signal: params.signal,
-		init: {
-			method: "POST",
-			headers: {
-				Accept: "application/json",
-				"Content-Type": "application/json",
-				"x-api-key": params.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, params.count);
-	});
-}
-function missingExaKeyPayload() {
-	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"
-	};
-}
-function buildExaCacheKey(params) {
-	const contents = params.contents ?? { highlights: true };
-	return buildSearchCacheKey([
-		"exa",
-		params.endpoint,
-		params.type,
-		params.query,
-		params.count,
-		params.freshness,
-		params.dateAfter,
-		params.dateBefore,
-		JSON.stringify(contents)
-	]);
-}
 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 missingExaKeyPayload();
+	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.includes(rawType) ? rawType : "auto";
+	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}.`
@@ -246,32 +181,51 @@ async function executeExaWebSearchProviderTool(ctx, args, signal) {
 	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 = buildExaCacheKey({
+	const cacheKey = buildSearchCacheKey([
+		"exa",
 		endpoint,
 		type,
 		query,
-		count: resolvedCount,
+		resolvedCount,
 		freshness,
 		dateAfter,
 		dateBefore,
-		contents
-	});
+		JSON.stringify(contents ?? { highlights: true })
+	]);
 	const cacheTtlMs = resolveSearchCacheTtlMs(searchConfig);
 	const cached = readCachedSearchPayload(cacheKey, cacheTtlMs);
 	if (cached) return cached;
 	const start = Date.now();
-	const results = await runExaSearch({
-		apiKey,
-		endpoint,
+	const timeoutSeconds = resolveSearchTimeoutSeconds(searchConfig);
+	const body = {
 		query,
-		count: resolvedCount,
-		freshness,
-		dateAfter,
-		dateBefore,
+		numResults: resolvedCount,
 		type,
-		contents,
-		timeoutSeconds: resolveSearchTimeoutSeconds(searchConfig),
-		signal
+		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 = {
@@ -288,7 +242,7 @@ async function executeExaWebSearchProviderTool(ctx, args, signal) {
 		results: results.map((entry) => {
 			const title = typeof entry.title === "string" ? entry.title : "";
 			const url = typeof entry.url === "string" ? entry.url : "";
-			const description = resolveExaDescription(entry);
+			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;

package/dist/index.js

@@ -1,4 +1,4 @@
-import { t as createExaWebSearchProvider } from "./.setup/exa-web-search-provider-DgKhV-9B.mjs";
+import { t as createExaWebSearchProvider } from "./.setup/exa-web-search-provider-DkWJpeaV.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,3 @@
-import { t as createExaWebSearchProvider } from "./.setup/exa-web-search-provider-DgKhV-9B.mjs";
+import { t as createExaWebSearchProvider } from "./.setup/exa-web-search-provider-DkWJpeaV.mjs";
 import "./web-search-provider.js";
 export { createExaWebSearchProvider };

package/dist/web-search-provider.js

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

package/package.json

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