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

package/dist/.setup/{firecrawl-client--j4MjwgU.mjs → firecrawl-client-Bx1Mas0Y.mjs}

@@ -1,13 +1,15 @@
-import { resolveSiteName } from "openclaw/plugin-sdk/provider-web-search";
-import { hash } from "node:crypto";
+import { externalContentStamp, readCachedSearchPayload, resolveSearchCacheTtlMs, resolveSiteName, writeCachedSearchPayload } from "openclaw/plugin-sdk/provider-web-search";
+import { sha256Hex } from "openclaw/plugin-sdk/node-crypto-runtime";
 import { asNonNegativeFiniteNumber, asPositiveFiniteNumber, parseDateStringTimestampMs, parseFiniteNumber, resolveIntegerOption } from "openclaw/plugin-sdk/number-runtime";
+import { resolvePluginConfigObject } from "openclaw/plugin-sdk/plugin-config-runtime";
 import { ProviderHttpError, readProviderJsonObjectResponse } from "openclaw/plugin-sdk/provider-http";
-import { DEFAULT_CACHE_TTL_MINUTES, markdownToText, normalizeCacheKey, readCache, readResponseText, resolveCacheTtlMs, resolvePositiveTimeoutSeconds, withSelfHostedWebToolsEndpoint, withStrictWebToolsEndpoint, writeCache } from "openclaw/plugin-sdk/provider-web-fetch";
+import { markdownToText, readResponseText, resolvePositiveTimeoutSeconds, withSelfHostedWebToolsEndpoint, withStrictWebToolsEndpoint } from "openclaw/plugin-sdk/provider-web-fetch";
+import { resolveProviderWebSearchPluginConfig } from "openclaw/plugin-sdk/provider-web-search-config-contract";
 import { normalizeSecretInput } from "openclaw/plugin-sdk/secret-input";
+import { resolveReadOnlyEnvSecretRef } from "openclaw/plugin-sdk/secret-ref-readonly";
 import { truncateSanitizedExternalContent, wrapExternalContent, wrapWebContent } from "openclaw/plugin-sdk/security-runtime";
 import { SsrFBlockedError, isBlockedHostnameOrIp, isPrivateIpAddress, resolvePinnedHostnameWithPolicy } from "openclaw/plugin-sdk/ssrf-runtime";
 import { asBoolean, asOptionalObjectRecord, asOptionalRecord, asRecord, normalizeOptionalString, readStringField } from "openclaw/plugin-sdk/string-coerce-runtime";
-import { resolveReadOnlyEnvSecretRef } from "openclaw/plugin-sdk/secret-ref-readonly";
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
 var __exportAll = (all, no_symbols) => {
@@ -19,64 +21,17 @@ var __exportAll = (all, no_symbols) => {
 	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
 	return target;
 };
-const DEFAULT_FIRECRAWL_SEARCH_TIMEOUT_SECONDS = 30;
-const DEFAULT_FIRECRAWL_SCRAPE_TIMEOUT_SECONDS = 60;
-const DEFAULT_FIRECRAWL_MAX_AGE_MS = 1728e5;
-const FIRECRAWL_API_KEY_ENV_VAR = "FIRECRAWL_API_KEY";
-function resolveFirecrawlSearchConfig(cfg) {
-	const pluginConfig = cfg?.plugins?.entries?.firecrawl?.config;
-	return asOptionalRecord(pluginConfig?.webSearch);
-}
-function resolveFirecrawlFetchConfig(cfg) {
-	const pluginConfig = cfg?.plugins?.entries?.firecrawl?.config;
-	return asOptionalRecord(pluginConfig?.webFetch);
-}
-function resolveConfiguredSecret(value, path, cfg) {
-	return resolveReadOnlyEnvSecretRef({
-		value,
-		path,
-		cfg,
-		expectedEnvId: FIRECRAWL_API_KEY_ENV_VAR,
-		normalizeValue: normalizeSecretInput
-	});
-}
-function resolveFirecrawlConnection(cfg, scope) {
-	const scopes = {
-		webSearch: resolveFirecrawlSearchConfig(cfg),
-		webFetch: resolveFirecrawlFetchConfig(cfg)
-	};
-	const primary = scopes[scope];
-	const selectedScope = primary?.apiKey === void 0 && !normalizeOptionalString(primary?.baseUrl) ? scope === "webSearch" ? "webFetch" : "webSearch" : scope;
-	const connection = scopes[selectedScope];
-	const resolved = resolveConfiguredSecret(connection?.apiKey, `plugins.entries.firecrawl.config.${selectedScope}.apiKey`, cfg);
-	return {
-		apiKey: resolved.status === "available" ? resolved.value : resolved.status === "blocked" ? void 0 : normalizeSecretInput(process.env[FIRECRAWL_API_KEY_ENV_VAR]) || void 0,
-		baseUrl: normalizeOptionalString(connection?.baseUrl) || normalizeSecretInput(process.env.FIRECRAWL_BASE_URL) || "https://api.firecrawl.dev"
-	};
-}
-function resolveFirecrawlOnlyMainContent(cfg, override) {
-	return asBoolean(override) ?? asBoolean(resolveFirecrawlFetchConfig(cfg)?.onlyMainContent) ?? true;
-}
-function resolveFirecrawlMaxAgeMs(cfg, override) {
-	return Math.floor(asNonNegativeFiniteNumber(override) ?? asNonNegativeFiniteNumber(resolveFirecrawlFetchConfig(cfg)?.maxAgeMs) ?? DEFAULT_FIRECRAWL_MAX_AGE_MS);
-}
-function resolveFirecrawlScrapeTimeoutSeconds(cfg, override) {
-	const fetch = resolveFirecrawlFetchConfig(cfg);
-	return resolvePositiveTimeoutSeconds(override, resolvePositiveTimeoutSeconds(fetch?.timeoutSeconds, DEFAULT_FIRECRAWL_SCRAPE_TIMEOUT_SECONDS));
-}
-function resolveFirecrawlSearchTimeoutSeconds(override) {
-	return resolvePositiveTimeoutSeconds(override, DEFAULT_FIRECRAWL_SEARCH_TIMEOUT_SECONDS);
-}
 //#endregion
 //#region extensions/firecrawl/src/firecrawl-client.ts
 var firecrawl_client_exports = /* @__PURE__ */ __exportAll({
-	assertFirecrawlScrapeTargetAllowed: () => assertFirecrawlScrapeTargetAllowed,
-	parseFirecrawlScrapePayload: () => parseFirecrawlScrapePayload,
 	runFirecrawlScrape: () => runFirecrawlScrape,
-	runFirecrawlSearch: () => runFirecrawlSearch,
-	testing: () => testing
+	runFirecrawlSearch: () => runFirecrawlSearch
 });
-const SEARCH_CACHE = /* @__PURE__ */ new Map();
+const DEFAULT_FIRECRAWL_BASE_URL = "https://api.firecrawl.dev";
+const DEFAULT_FIRECRAWL_SEARCH_TIMEOUT_SECONDS = 30;
+const DEFAULT_FIRECRAWL_SCRAPE_TIMEOUT_SECONDS = 60;
+const DEFAULT_FIRECRAWL_MAX_AGE_MS = 1728e5;
+const FIRECRAWL_API_KEY_ENV_VAR = "FIRECRAWL_API_KEY";
 const DEFAULT_SEARCH_COUNT = 5;
 const FIRECRAWL_SEARCH_MAX_RESULTS = 100;
 const FIRECRAWL_SEARCH_MAX_CONTENT_CHARS = 2e4;
@@ -88,6 +43,39 @@ const ALLOWED_FIRECRAWL_HOSTS = /* @__PURE__ */ new Set(["api.firecrawl.dev"]);
 const FIRECRAWL_PUBLISHED_DATE_RE = /^\d{4}-\d{2}-\d{2}(?:[T ][\d:.+Z-]{0,20})?$/u;
 const FIRECRAWL_SELF_HOSTED_PRIVATE_ERROR = "Firecrawl custom baseUrl must target a private or internal self-hosted endpoint.";
 const FIRECRAWL_HTTP_PRIVATE_ERROR = "Firecrawl HTTP baseUrl must target a private or internal self-hosted endpoint. Use https:// for public hosts.";
+function resolveFirecrawlFetchConfig(cfg) {
+	return asOptionalRecord(resolvePluginConfigObject(cfg, "firecrawl")?.webFetch);
+}
+function resolveFirecrawlApiKey(cfg) {
+	const fetch = resolveFirecrawlFetchConfig(cfg);
+	const search = resolveProviderWebSearchPluginConfig(cfg, "firecrawl");
+	const configuredCandidates = [{
+		value: fetch?.apiKey,
+		path: "plugins.entries.firecrawl.config.webFetch.apiKey"
+	}, {
+		value: search?.apiKey,
+		path: "plugins.entries.firecrawl.config.webSearch.apiKey"
+	}];
+	let blockedConfiguredSecret = false;
+	for (const candidate of configuredCandidates) {
+		const resolved = resolveReadOnlyEnvSecretRef({
+			value: candidate.value,
+			path: candidate.path,
+			cfg,
+			expectedEnvId: FIRECRAWL_API_KEY_ENV_VAR,
+			normalizeValue: normalizeSecretInput
+		});
+		if (resolved.status === "available") return resolved.value;
+		if (resolved.status === "blocked") blockedConfiguredSecret = true;
+	}
+	if (blockedConfiguredSecret) return;
+	return normalizeSecretInput(process.env[FIRECRAWL_API_KEY_ENV_VAR]) || void 0;
+}
+function resolveFirecrawlBaseUrl(cfg) {
+	const search = resolveProviderWebSearchPluginConfig(cfg, "firecrawl");
+	const fetch = resolveFirecrawlFetchConfig(cfg);
+	return normalizeOptionalString(search?.baseUrl) || normalizeOptionalString(fetch?.baseUrl) || normalizeSecretInput(process.env.FIRECRAWL_BASE_URL) || DEFAULT_FIRECRAWL_BASE_URL;
+}
 function assertFirecrawlScrapeTargetAllowed(url) {
 	let parsed;
 	try {
@@ -101,27 +89,24 @@ function assertFirecrawlScrapeTargetAllowed(url) {
 function isOfficialFirecrawlEndpoint(url) {
 	return url.protocol === "https:" && ALLOWED_FIRECRAWL_HOSTS.has(url.hostname);
 }
-async function firecrawlEndpointTargetsPrivateNetwork(url, lookupFn) {
+async function firecrawlEndpointTargetsPrivateNetwork(url) {
 	if (isBlockedHostnameOrIp(url.hostname)) return true;
 	try {
-		return (await resolvePinnedHostnameWithPolicy(url.hostname, {
-			lookupFn,
-			policy: { allowPrivateNetwork: true }
-		})).addresses.every((address) => isPrivateIpAddress(address));
+		return (await resolvePinnedHostnameWithPolicy(url.hostname, { policy: { allowPrivateNetwork: true } })).addresses.every((address) => isPrivateIpAddress(address));
 	} catch {
 		return false;
 	}
 }
-async function validateFirecrawlBaseUrl(url, lookupFn) {
+async function validateFirecrawlBaseUrl(url) {
 	if (url.protocol !== "http:" && url.protocol !== "https:") throw new Error("Firecrawl baseUrl must use http:// or https://.");
 	if (isOfficialFirecrawlEndpoint(url)) return "strict";
-	if (await firecrawlEndpointTargetsPrivateNetwork(url, lookupFn)) return "selfHosted";
+	if (await firecrawlEndpointTargetsPrivateNetwork(url)) return "selfHosted";
 	if (url.protocol === "http:") throw new Error(FIRECRAWL_HTTP_PRIVATE_ERROR);
 	throw new Error(`${FIRECRAWL_SELF_HOSTED_PRIVATE_ERROR} Host: ${url.hostname}`);
 }
-async function resolveEndpoint(baseUrl, pathname, lookupFn) {
-	const url = new URL(baseUrl.trim() || "https://api.firecrawl.dev");
-	const mode = await validateFirecrawlBaseUrl(url, lookupFn);
+async function resolveEndpoint(baseUrl, pathname) {
+	const url = new URL(baseUrl.trim() || DEFAULT_FIRECRAWL_BASE_URL);
+	const mode = await validateFirecrawlBaseUrl(url);
 	url.username = "";
 	url.password = "";
 	url.search = "";
@@ -231,28 +216,27 @@ async function runFirecrawlSearch(params) {
 	params.signal?.throwIfAborted();
 	const keyless = params.access === "keyless";
 	const providerId = keyless ? "firecrawl-free" : "firecrawl";
-	const connection = resolveFirecrawlConnection(params.cfg, "webSearch");
-	const apiKey = keyless ? void 0 : connection.apiKey;
+	const apiKey = keyless ? void 0 : resolveFirecrawlApiKey(params.cfg);
 	if (!apiKey && !keyless) throw new Error("web_search (firecrawl) needs a Firecrawl API key. Set FIRECRAWL_API_KEY in the Gateway environment, or configure plugins.entries.firecrawl.config.webSearch.apiKey.");
 	const count = resolveIntegerOption(params.count, DEFAULT_SEARCH_COUNT, {
 		min: 1,
 		max: 100
 	});
-	const timeoutSeconds = resolveFirecrawlSearchTimeoutSeconds(params.timeoutSeconds);
+	const timeoutSeconds = resolvePositiveTimeoutSeconds(params.timeoutSeconds, DEFAULT_FIRECRAWL_SEARCH_TIMEOUT_SECONDS);
 	const scrapeResults = params.scrapeResults === true;
-	const sources = Array.isArray(params.sources) ? params.sources.filter(Boolean) : [];
-	const categories = Array.isArray(params.categories) ? params.categories.filter(Boolean) : [];
-	const includeDomains = Array.isArray(params.includeDomains) ? params.includeDomains.filter(Boolean) : [];
-	const excludeDomains = Array.isArray(params.excludeDomains) ? params.excludeDomains.filter(Boolean) : [];
+	const sources = params.sources?.filter(Boolean) ?? [];
+	const categories = params.categories?.filter(Boolean) ?? [];
+	const includeDomains = params.includeDomains?.filter(Boolean) ?? [];
+	const excludeDomains = params.excludeDomains?.filter(Boolean) ?? [];
 	if (includeDomains.length > 0 && excludeDomains.length > 0) throw new Error("Firecrawl search accepts includeDomains or excludeDomains, not both.");
 	const tbs = normalizeOptionalString(params.tbs);
 	const location = normalizeOptionalString(params.location);
 	const country = normalizeOptionalString(params.country);
-	const baseUrl = connection.baseUrl;
-	const cacheKey = normalizeCacheKey(JSON.stringify({
+	const baseUrl = resolveFirecrawlBaseUrl(params.cfg);
+	const cacheKey = JSON.stringify({
 		type: "firecrawl-search",
 		provider: providerId,
-		credential: apiKey ? hash("sha256", apiKey, "hex") : void 0,
+		credential: apiKey ? sha256Hex(apiKey) : void 0,
 		q: params.query,
 		count,
 		baseUrl,
@@ -264,13 +248,10 @@ async function runFirecrawlSearch(params) {
 		location,
 		country,
 		scrapeResults
-	}));
-	const cacheTtlMs = resolveCacheTtlMs(params.cfg?.tools?.web?.search?.cacheTtlMinutes, DEFAULT_CACHE_TTL_MINUTES);
-	const cached = readCache(SEARCH_CACHE, cacheKey, cacheTtlMs);
-	if (cached) return {
-		...cached.value,
-		cached: true
-	};
+	});
+	const cacheTtlMs = resolveSearchCacheTtlMs(params.cfg?.tools?.web?.search);
+	const cached = readCachedSearchPayload(cacheKey, cacheTtlMs);
+	if (cached) return cached;
 	const body = {
 		query: params.query,
 		limit: count,
@@ -324,20 +305,52 @@ async function runFirecrawlSearch(params) {
 		provider: providerId,
 		count: items.length,
 		tookMs,
-		externalContent: {
-			untrusted: true,
-			source: "web_search",
-			provider: providerId,
-			wrapped: true
-		},
+		externalContent: externalContentStamp(providerId),
 		results,
 		...truncated ? { truncated: true } : {}
 	};
-	writeCache(SEARCH_CACHE, cacheKey, result, cacheTtlMs);
+	writeCachedSearchPayload(cacheKey, result, cacheTtlMs);
 	return result;
 }
-function parseFirecrawlScrapePayload(params) {
-	const data = asRecord(params.payload.data);
+async function runFirecrawlScrape(params) {
+	params.signal?.throwIfAborted();
+	assertFirecrawlScrapeTargetAllowed(params.url);
+	const apiKey = resolveFirecrawlApiKey(params.cfg);
+	if (!apiKey && params.access !== "keyless") throw new Error("firecrawl_scrape needs a Firecrawl API key. Set FIRECRAWL_API_KEY in the Gateway environment, or configure plugins.entries.firecrawl.config.webFetch.apiKey.");
+	const baseUrl = resolveFirecrawlBaseUrl(params.cfg);
+	const fetch = resolveFirecrawlFetchConfig(params.cfg);
+	const timeoutSeconds = resolvePositiveTimeoutSeconds(params.timeoutSeconds, resolvePositiveTimeoutSeconds(fetch?.timeoutSeconds, DEFAULT_FIRECRAWL_SCRAPE_TIMEOUT_SECONDS));
+	const onlyMainContent = asBoolean(params.onlyMainContent) ?? asBoolean(resolveFirecrawlFetchConfig(params.cfg)?.onlyMainContent) ?? true;
+	const maxAgeMs = Math.floor(asNonNegativeFiniteNumber(params.maxAgeMs) ?? asNonNegativeFiniteNumber(resolveFirecrawlFetchConfig(params.cfg)?.maxAgeMs) ?? DEFAULT_FIRECRAWL_MAX_AGE_MS);
+	const proxy = params.proxy ?? "auto";
+	const storeInCache = params.storeInCache ?? true;
+	const maxChars = Math.floor(Math.min(asPositiveFiniteNumber(params.maxChars) ?? DEFAULT_SCRAPE_MAX_CHARS, asPositiveFiniteNumber(params.cfg?.tools?.web?.fetch?.maxCharsCap) ?? DEFAULT_SCRAPE_MAX_CHARS));
+	const endpoint = await resolveEndpoint(baseUrl, "/v2/scrape");
+	const payload = await postFirecrawlJson({
+		url: endpoint.url,
+		mode: endpoint.mode,
+		timeoutSeconds,
+		apiKey,
+		errorLabel: "Firecrawl",
+		...params.signal ? { signal: params.signal } : {},
+		body: {
+			url: params.url,
+			formats: ["markdown"],
+			onlyMainContent,
+			timeout: timeoutSeconds * 1e3,
+			maxAge: maxAgeMs,
+			proxy,
+			storeInCache
+		}
+	}, async (response) => {
+		const data = await readProviderJsonObjectResponse(response, "Firecrawl fetch failed", { maxBytes: FIRECRAWL_SCRAPE_RESPONSE_MAX_BYTES });
+		if (data.success === false) {
+			const detail = readFirecrawlErrorDetail(data, response.statusText);
+			throw new Error(`Firecrawl fetch failed (${response.status}): ${wrapWebContent(truncateSanitizedExternalContent(detail, FIRECRAWL_SCRAPE_METADATA_MAX_CHARS).text, "web_fetch")}`.trim());
+		}
+		return data;
+	});
+	const data = asRecord(payload.data);
 	const metadata = asOptionalObjectRecord(data.metadata);
 	const rawStatus = parseFiniteNumber(metadata?.statusCode) ?? parseFiniteNumber(data.statusCode);
 	const status = rawStatus === void 0 ? void 0 : Math.floor(rawStatus);
@@ -345,7 +358,7 @@ function parseFirecrawlScrapePayload(params) {
 	const markdown = typeof data.markdown === "string" && data.markdown || typeof data.content === "string" && data.content || "";
 	if (!markdown) throw new Error("Firecrawl scrape returned no content.");
 	const rawText = params.extractMode === "text" ? markdownToText(markdown) : markdown;
-	const boundedText = truncateSanitizedExternalContent(rawText, params.maxChars);
+	const boundedText = truncateSanitizedExternalContent(rawText, maxChars);
 	let truncated = boundedText.truncated;
 	let remainingMetadataChars = FIRECRAWL_SCRAPE_METADATA_MAX_CHARS;
 	const wrapBoundedMetadata = (value) => {
@@ -362,7 +375,7 @@ function parseFirecrawlScrapePayload(params) {
 		includeWarning: false
 	});
 	const title = typeof metadata?.title === "string" && metadata.title ? wrapBoundedMetadata(metadata.title) : void 0;
-	const warning = typeof params.payload.warning === "string" && params.payload.warning ? wrapBoundedMetadata(params.payload.warning) : void 0;
+	const warning = typeof payload.warning === "string" && payload.warning ? wrapBoundedMetadata(payload.warning) : void 0;
 	return {
 		url: params.url,
 		finalUrl: normalizeFirecrawlResultUrl(metadata?.sourceURL) ?? normalizeFirecrawlResultUrl(data.url) ?? params.url,
@@ -382,53 +395,5 @@ function parseFirecrawlScrapePayload(params) {
 		...warning ? { warning } : {}
 	};
 }
-async function runFirecrawlScrape(params) {
-	params.signal?.throwIfAborted();
-	assertFirecrawlScrapeTargetAllowed(params.url);
-	const { apiKey, baseUrl } = resolveFirecrawlConnection(params.cfg, "webFetch");
-	if (!apiKey && params.access !== "keyless") throw new Error("firecrawl_scrape needs a Firecrawl API key. Set FIRECRAWL_API_KEY in the Gateway environment, or configure plugins.entries.firecrawl.config.webFetch.apiKey.");
-	const timeoutSeconds = resolveFirecrawlScrapeTimeoutSeconds(params.cfg, params.timeoutSeconds);
-	const onlyMainContent = resolveFirecrawlOnlyMainContent(params.cfg, params.onlyMainContent);
-	const maxAgeMs = resolveFirecrawlMaxAgeMs(params.cfg, params.maxAgeMs);
-	const proxy = params.proxy ?? "auto";
-	const storeInCache = params.storeInCache ?? true;
-	const maxChars = Math.floor(Math.min(asPositiveFiniteNumber(params.maxChars) ?? DEFAULT_SCRAPE_MAX_CHARS, asPositiveFiniteNumber(params.cfg?.tools?.web?.fetch?.maxCharsCap) ?? DEFAULT_SCRAPE_MAX_CHARS));
-	const endpoint = await resolveEndpoint(baseUrl, "/v2/scrape");
-	return parseFirecrawlScrapePayload({
-		payload: await postFirecrawlJson({
-			url: endpoint.url,
-			mode: endpoint.mode,
-			timeoutSeconds,
-			apiKey,
-			errorLabel: "Firecrawl",
-			...params.signal ? { signal: params.signal } : {},
-			body: {
-				url: params.url,
-				formats: ["markdown"],
-				onlyMainContent,
-				timeout: timeoutSeconds * 1e3,
-				maxAge: maxAgeMs,
-				proxy,
-				storeInCache
-			}
-		}, async (response) => {
-			const data = await readProviderJsonObjectResponse(response, "Firecrawl fetch failed", { maxBytes: FIRECRAWL_SCRAPE_RESPONSE_MAX_BYTES });
-			if (data.success === false) {
-				const detail = readFirecrawlErrorDetail(data, response.statusText);
-				throw new Error(`Firecrawl fetch failed (${response.status}): ${wrapWebContent(truncateSanitizedExternalContent(detail, FIRECRAWL_SCRAPE_METADATA_MAX_CHARS).text, "web_fetch")}`.trim());
-			}
-			return data;
-		}),
-		url: params.url,
-		extractMode: params.extractMode,
-		maxChars
-	});
-}
-const testing = {
-	assertFirecrawlScrapeTargetAllowed,
-	parseFirecrawlScrapePayload,
-	resolveEndpoint,
-	resolveSearchItems
-};
 //#endregion
 export { runFirecrawlScrape as n, runFirecrawlSearch as r, firecrawl_client_exports as t };

package/dist/.setup/{firecrawl-fetch-provider-Br32KRpR.mjs → firecrawl-fetch-provider-DTGxGqmO.mjs}

@@ -1,14 +1,8 @@
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 import { readPositiveIntegerParam } from "openclaw/plugin-sdk/param-readers";
 import { enablePluginInConfig } from "openclaw/plugin-sdk/provider-web-fetch-contract";
+import { ensureRecord } from "openclaw/plugin-sdk/collection-input-runtime";
 //#region extensions/firecrawl/src/firecrawl-fetch-provider-shared.ts
-function ensureRecord(target, key) {
-	const current = target[key];
-	if (current && typeof current === "object" && !Array.isArray(current)) return current;
-	const next = {};
-	target[key] = next;
-	return next;
-}
 const FIRECRAWL_WEB_FETCH_PROVIDER_SHARED = {
 	id: "firecrawl",
 	label: "Firecrawl",
@@ -45,13 +39,14 @@ const FIRECRAWL_WEB_FETCH_PROVIDER_SHARED = {
 		const plugins = configTarget.plugins ??= {};
 		const entries = plugins.entries ??= {};
 		const firecrawlEntry = entries.firecrawl ??= {};
-		const webFetch = ensureRecord(firecrawlEntry.config ??= {}, "webFetch");
+		const pluginConfig = firecrawlEntry.config ??= {};
+		const webFetch = ensureRecord(pluginConfig, "webFetch");
 		webFetch.apiKey = value;
 	}
 };
 //#endregion
 //#region extensions/firecrawl/src/firecrawl-fetch-provider.ts
-const loadFirecrawlClientModule = createLazyRuntimeModule(() => import("./firecrawl-client--j4MjwgU.mjs").then((n) => n.t));
+const loadFirecrawlClientModule = createLazyRuntimeModule(() => import("./firecrawl-client-Bx1Mas0Y.mjs").then((n) => n.t));
 function createFirecrawlWebFetchProvider() {
 	return {
 		...FIRECRAWL_WEB_FETCH_PROVIDER_SHARED,

package/dist/.setup/{firecrawl-search-provider-D_gyroLO.mjs → firecrawl-search-provider-DBouVH9p.mjs}

@@ -1,29 +1,18 @@
+import { resolvePluginConfigObject } from "openclaw/plugin-sdk/plugin-config-runtime";
+import { asOptionalRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 import { readPositiveIntegerParam } from "openclaw/plugin-sdk/param-readers";
-import { asOptionalRecord } from "openclaw/plugin-sdk/string-coerce-runtime";
-import { createWebSearchProviderContractFields, enablePluginInConfig } from "openclaw/plugin-sdk/provider-web-search-contract";
+import { WEB_SEARCH_QUERY_COUNT_PROPERTIES, createWebSearchProviderContractFields, enablePluginInConfig } from "openclaw/plugin-sdk/provider-web-search-contract";
 //#region extensions/firecrawl/src/firecrawl-search-provider.ts
 const FIRECRAWL_CREDENTIAL_PATH = "plugins.entries.firecrawl.config.webSearch.apiKey";
-const loadFirecrawlClientModule = createLazyRuntimeModule(() => import("./firecrawl-client--j4MjwgU.mjs").then((n) => n.t));
+const loadFirecrawlClientModule = createLazyRuntimeModule(() => import("./firecrawl-client-Bx1Mas0Y.mjs").then((n) => n.t));
 const GenericFirecrawlSearchSchema = {
 	type: "object",
-	properties: {
-		query: {
-			type: "string",
-			description: "Search query string."
-		},
-		count: {
-			type: "integer",
-			description: "Number of results to return (1-10).",
-			minimum: 1,
-			maximum: 10
-		}
-	},
+	properties: { ...WEB_SEARCH_QUERY_COUNT_PROPERTIES },
 	additionalProperties: false
 };
 function getConfiguredFirecrawlFetchCredentialFallback(config) {
-	const pluginConfig = asOptionalRecord(config?.plugins?.entries?.firecrawl?.config);
-	const value = asOptionalRecord(pluginConfig?.webFetch)?.apiKey;
+	const value = asOptionalRecord(resolvePluginConfigObject(config, "firecrawl")?.webFetch)?.apiKey;
 	return value === void 0 ? void 0 : {
 		path: "plugins.entries.firecrawl.config.webFetch.apiKey",
 		value

package/dist/.source-module-urls/ad8205c790d921269d4ea28d22ab658579b9674fd00e025664fcf0b8ea32155c.json

@@ -0,0 +1 @@
+{"version":3,"entries":[{"output":"api.js","source":"extensions/firecrawl/api.ts"},{"output":"index.js","source":"extensions/firecrawl/index.ts"},{"output":"web-fetch-contract-api.js","source":"extensions/firecrawl/web-fetch-contract-api.ts"},{"output":"web-fetch-provider.js","source":"extensions/firecrawl/web-fetch-provider.ts"},{"output":"web-search-contract-api.js","source":"extensions/firecrawl/web-search-contract-api.ts"},{"output":"web-search-provider.js","source":"extensions/firecrawl/web-search-provider.ts"}],"chunks":[{"output":".setup/firecrawl-client-Bx1Mas0Y.mjs","sha256":"2f749e101e8e3d49510d61a1a4720f9c5866cd17347bc62a45d46e6c7f0247c2","facadeSource":null,"sources":["extensions/firecrawl/src/firecrawl-client.ts"]},{"output":".setup/firecrawl-fetch-provider-DTGxGqmO.mjs","sha256":"bd3e1a3ef358f1d2f83d56f982f50ceb28360b9a5e4b138e012d256dccf4d2de","facadeSource":null,"sources":["extensions/firecrawl/src/firecrawl-fetch-provider-shared.ts","extensions/firecrawl/src/firecrawl-fetch-provider.ts"]},{"output":".setup/firecrawl-search-provider-DBouVH9p.mjs","sha256":"dfb053d94025351de94b96962361cde962a5dc68bdc46d6d38e81e4bf353088c","facadeSource":null,"sources":["extensions/firecrawl/src/firecrawl-search-provider.ts"]},{"output":"api.js","sha256":"d762f8210fd4a9474e0ec4e8e19f3abac0412313be417861578a3b3d1334dd8b","facadeSource":"extensions/firecrawl/api.ts","sources":["extensions/firecrawl/api.ts"]},{"output":"index.js","sha256":"f68acf9490b4d1a11d4fb3bbb1b2cbb126593099bdfc548d0bad697f4632e7da","facadeSource":"extensions/firecrawl/index.ts","sources":["extensions/firecrawl/index.ts"]},{"output":"web-fetch-contract-api.js","sha256":"bb2810073bde8e6640a78714e399d0091117f942f30633e09ec373949f72759a","facadeSource":"extensions/firecrawl/web-fetch-contract-api.ts","sources":[]},{"output":"web-fetch-provider.js","sha256":"d275807de9c003a3a1cb294707cd4e4ace442e3df63878734f6b7237cd550931","facadeSource":"extensions/firecrawl/web-fetch-provider.ts","sources":[]},{"output":"web-search-contract-api.js","sha256":"ad13994cc134d279bbdc467bcc99f8244c8dbe6e30ab1e723868d5be120c7948","facadeSource":"extensions/firecrawl/web-search-contract-api.ts","sources":[]},{"output":"web-search-provider.js","sha256":"f37a3f9840de307207f49c8e064147a2fed045508d43e0d3b1d53d325e07a1cf","facadeSource":"extensions/firecrawl/web-search-provider.ts","sources":[]}],"unrenderedSources":["extensions/firecrawl/web-fetch-contract-api.ts","extensions/firecrawl/web-fetch-provider.ts","extensions/firecrawl/web-search-contract-api.ts","extensions/firecrawl/web-search-provider.ts"]}

package/dist/api.js

@@ -1,4 +1,4 @@
-import { n as runFirecrawlScrape } from "./.setup/firecrawl-client--j4MjwgU.mjs";
+import { n as runFirecrawlScrape } from "./.setup/firecrawl-client-Bx1Mas0Y.mjs";
 //#region extensions/firecrawl/api.ts
 async function fetchFirecrawlContent(params) {
 	const cfg = { plugins: { entries: { firecrawl: {

package/dist/index.js

@@ -1,11 +1,11 @@
-import { n as runFirecrawlScrape, r as runFirecrawlSearch } from "./.setup/firecrawl-client--j4MjwgU.mjs";
-import { t as createFirecrawlWebFetchProvider } from "./.setup/firecrawl-fetch-provider-Br32KRpR.mjs";
-import { n as createFirecrawlWebSearchProvider, t as createFirecrawlFreeWebSearchProvider } from "./.setup/firecrawl-search-provider-D_gyroLO.mjs";
+import { n as runFirecrawlScrape, r as runFirecrawlSearch } from "./.setup/firecrawl-client-Bx1Mas0Y.mjs";
+import { t as createFirecrawlWebFetchProvider } from "./.setup/firecrawl-fetch-provider-DTGxGqmO.mjs";
+import { n as createFirecrawlWebSearchProvider, t as createFirecrawlFreeWebSearchProvider } from "./.setup/firecrawl-search-provider-DBouVH9p.mjs";
+import { optionalNonNegativeIntegerSchema, optionalPositiveIntegerSchema, optionalStringEnum } from "openclaw/plugin-sdk/channel-actions";
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
-import { optionalStringEnum } from "openclaw/plugin-sdk/channel-actions";
 import { jsonResult, readNonNegativeIntegerParam, readPositiveIntegerParam, readStringArrayParam, readStringParam } from "openclaw/plugin-sdk/provider-web-search";
 import { Type } from "typebox";
-//#region extensions/firecrawl/src/firecrawl-scrape-tool.ts
+//#region extensions/firecrawl/index.ts
 const FirecrawlScrapeToolSchema = Type.Object({
 	url: Type.String({ description: "HTTP or HTTPS URL to scrape via Firecrawl." }),
 	extractMode: optionalStringEnum(["markdown", "text"], { description: "Extraction mode (\"markdown\" or \"text\"). Default: markdown." }),
@@ -14,63 +14,21 @@ const FirecrawlScrapeToolSchema = Type.Object({
 		minimum: 100
 	})),
 	onlyMainContent: Type.Optional(Type.Boolean({ description: "Keep only main content when Firecrawl supports it." })),
-	maxAgeMs: Type.Optional(Type.Integer({
-		description: "Maximum Firecrawl cache age in milliseconds.",
-		minimum: 0
-	})),
+	maxAgeMs: optionalNonNegativeIntegerSchema({ description: "Maximum Firecrawl cache age in milliseconds." }),
 	proxy: optionalStringEnum([
 		"auto",
 		"basic",
 		"stealth"
 	], { description: "Firecrawl proxy mode (\"auto\", \"basic\", or \"stealth\")." }),
 	storeInCache: Type.Optional(Type.Boolean({ description: "Whether Firecrawl should store the scrape in its cache." })),
-	timeoutSeconds: Type.Optional(Type.Integer({
-		description: "Timeout in seconds for the Firecrawl scrape request.",
-		minimum: 1
-	}))
+	timeoutSeconds: optionalPositiveIntegerSchema({ description: "Timeout in seconds for the Firecrawl scrape request." })
 }, { additionalProperties: false });
-function createFirecrawlScrapeTool(api) {
-	return {
-		name: "firecrawl_scrape",
-		label: "Firecrawl Scrape",
-		resultContentSource: "network",
-		description: "Scrape a page using Firecrawl v2/scrape. Useful for JS-heavy or bot-protected pages where a plain URL fetch is weak.",
-		parameters: FirecrawlScrapeToolSchema,
-		execute: async (_toolCallId, rawParams, signal) => {
-			signal?.throwIfAborted();
-			const url = readStringParam(rawParams, "url", { required: true });
-			const extractMode = readStringParam(rawParams, "extractMode") === "text" ? "text" : "markdown";
-			const maxChars = readPositiveIntegerParam(rawParams, "maxChars");
-			const maxAgeMs = readNonNegativeIntegerParam(rawParams, "maxAgeMs");
-			const timeoutSeconds = readPositiveIntegerParam(rawParams, "timeoutSeconds");
-			const proxyRaw = readStringParam(rawParams, "proxy");
-			const proxy = proxyRaw === "basic" || proxyRaw === "stealth" || proxyRaw === "auto" ? proxyRaw : void 0;
-			const onlyMainContent = typeof rawParams.onlyMainContent === "boolean" ? rawParams.onlyMainContent : void 0;
-			const storeInCache = typeof rawParams.storeInCache === "boolean" ? rawParams.storeInCache : void 0;
-			return jsonResult(await runFirecrawlScrape({
-				cfg: api.config,
-				url,
-				extractMode,
-				maxChars,
-				onlyMainContent,
-				maxAgeMs,
-				proxy,
-				storeInCache,
-				timeoutSeconds,
-				...signal ? { signal } : {}
-			}));
-		}
-	};
-}
-//#endregion
-//#region extensions/firecrawl/src/firecrawl-search-tool.ts
 const FirecrawlSearchToolSchema = Type.Object({
 	query: Type.String({ description: "Search query string." }),
-	count: Type.Optional(Type.Integer({
+	count: optionalPositiveIntegerSchema({
 		description: "Number of results to return (1-100).",
-		minimum: 1,
 		maximum: 100
-	})),
+	}),
 	sources: Type.Optional(Type.Array(Type.String(), { description: "Optional sources list, for example [\"web\"], [\"news\"], or [\"images\"]." })),
 	categories: Type.Optional(Type.Array(Type.String(), { description: "Optional Firecrawl categories, for example [\"github\"] or [\"research\"]." })),
 	includeDomains: Type.Optional(Type.Array(Type.String(), { description: "Restrict results to these hostnames (no protocol or path). Cannot be combined with excludeDomains." })),
@@ -79,43 +37,8 @@ const FirecrawlSearchToolSchema = Type.Object({
 	location: Type.Optional(Type.String({ description: "Geo-target location, for example \"Germany\" or \"San Francisco,California,United States\"." })),
 	country: Type.Optional(Type.String({ description: "ISO country code for geo-targeting, for example \"US\", \"DE\", or \"JP\"." })),
 	scrapeResults: Type.Optional(Type.Boolean({ description: "Include scraped result content when Firecrawl returns it." })),
-	timeoutSeconds: Type.Optional(Type.Integer({
-		description: "Timeout in seconds for the Firecrawl Search request.",
-		minimum: 1
-	}))
+	timeoutSeconds: optionalPositiveIntegerSchema({ description: "Timeout in seconds for the Firecrawl Search request." })
 }, { additionalProperties: false });
-function createFirecrawlSearchTool(api) {
-	return {
-		name: "firecrawl_search",
-		label: "Firecrawl Search",
-		resultContentSource: "network",
-		description: "Search the web using Firecrawl v2/search. Supports includeDomains/excludeDomains filtering and tbs time filters (day/week/month/year). Can optionally include scraped content from result pages.",
-		parameters: FirecrawlSearchToolSchema,
-		execute: async (_toolCallId, rawParams, signal) => {
-			signal?.throwIfAborted();
-			return jsonResult(await runFirecrawlSearch({
-				query: readStringParam(rawParams, "query", { required: true }),
-				count: readPositiveIntegerParam(rawParams, "count", {
-					max: 100,
-					message: "count must be an integer from 1 to 100"
-				}),
-				timeoutSeconds: readPositiveIntegerParam(rawParams, "timeoutSeconds"),
-				sources: readStringArrayParam(rawParams, "sources"),
-				categories: readStringArrayParam(rawParams, "categories"),
-				includeDomains: readStringArrayParam(rawParams, "includeDomains"),
-				excludeDomains: readStringArrayParam(rawParams, "excludeDomains"),
-				tbs: readStringParam(rawParams, "tbs"),
-				location: readStringParam(rawParams, "location"),
-				country: readStringParam(rawParams, "country"),
-				scrapeResults: rawParams.scrapeResults === true,
-				cfg: api.config,
-				...signal ? { signal } : {}
-			}));
-		}
-	};
-}
-//#endregion
-//#region extensions/firecrawl/index.ts
 var firecrawl_default = definePluginEntry({
 	id: "firecrawl",
 	name: "Firecrawl Plugin",
@@ -124,8 +47,65 @@ var firecrawl_default = definePluginEntry({
 		api.registerWebFetchProvider(createFirecrawlWebFetchProvider());
 		api.registerWebSearchProvider(createFirecrawlWebSearchProvider());
 		api.registerWebSearchProvider(createFirecrawlFreeWebSearchProvider());
-		api.registerTool(createFirecrawlSearchTool(api));
-		api.registerTool(createFirecrawlScrapeTool(api));
+		api.registerTool({
+			name: "firecrawl_search",
+			label: "Firecrawl Search",
+			resultContentSource: "network",
+			description: "Search the web using Firecrawl v2/search. Supports includeDomains/excludeDomains filtering and tbs time filters (day/week/month/year). Can optionally include scraped content from result pages.",
+			parameters: FirecrawlSearchToolSchema,
+			execute: async (_toolCallId, rawParams, signal) => {
+				signal?.throwIfAborted();
+				return jsonResult(await runFirecrawlSearch({
+					query: readStringParam(rawParams, "query", { required: true }),
+					count: readPositiveIntegerParam(rawParams, "count", {
+						max: 100,
+						message: "count must be an integer from 1 to 100"
+					}),
+					timeoutSeconds: readPositiveIntegerParam(rawParams, "timeoutSeconds"),
+					sources: readStringArrayParam(rawParams, "sources"),
+					categories: readStringArrayParam(rawParams, "categories"),
+					includeDomains: readStringArrayParam(rawParams, "includeDomains"),
+					excludeDomains: readStringArrayParam(rawParams, "excludeDomains"),
+					tbs: readStringParam(rawParams, "tbs"),
+					location: readStringParam(rawParams, "location"),
+					country: readStringParam(rawParams, "country"),
+					scrapeResults: rawParams.scrapeResults === true,
+					cfg: api.config,
+					...signal ? { signal } : {}
+				}));
+			}
+		});
+		api.registerTool({
+			name: "firecrawl_scrape",
+			label: "Firecrawl Scrape",
+			resultContentSource: "network",
+			description: "Scrape a page using Firecrawl v2/scrape. Useful for JS-heavy or bot-protected pages where a plain URL fetch is weak.",
+			parameters: FirecrawlScrapeToolSchema,
+			execute: async (_toolCallId, rawParams, signal) => {
+				signal?.throwIfAborted();
+				const url = readStringParam(rawParams, "url", { required: true });
+				const extractMode = readStringParam(rawParams, "extractMode") === "text" ? "text" : "markdown";
+				const maxChars = readPositiveIntegerParam(rawParams, "maxChars");
+				const maxAgeMs = readNonNegativeIntegerParam(rawParams, "maxAgeMs");
+				const timeoutSeconds = readPositiveIntegerParam(rawParams, "timeoutSeconds");
+				const proxyRaw = readStringParam(rawParams, "proxy");
+				const proxy = proxyRaw === "basic" || proxyRaw === "stealth" || proxyRaw === "auto" ? proxyRaw : void 0;
+				const onlyMainContent = typeof rawParams.onlyMainContent === "boolean" ? rawParams.onlyMainContent : void 0;
+				const storeInCache = typeof rawParams.storeInCache === "boolean" ? rawParams.storeInCache : void 0;
+				return jsonResult(await runFirecrawlScrape({
+					cfg: api.config,
+					url,
+					extractMode,
+					maxChars,
+					onlyMainContent,
+					maxAgeMs,
+					proxy,
+					storeInCache,
+					timeoutSeconds,
+					...signal ? { signal } : {}
+				}));
+			}
+		});
 	}
 });
 //#endregion

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

@@ -1,3 +1,2 @@
-import { t as createFirecrawlWebFetchProvider } from "./.setup/firecrawl-fetch-provider-Br32KRpR.mjs";
+export { t as createFirecrawlWebFetchProvider } from "./.setup/firecrawl-fetch-provider-DTGxGqmO.mjs";
 import "./web-fetch-provider.js";
-export { createFirecrawlWebFetchProvider };

package/dist/web-fetch-provider.js

@@ -1,2 +1 @@
-import { t as createFirecrawlWebFetchProvider } from "./.setup/firecrawl-fetch-provider-Br32KRpR.mjs";
-export { createFirecrawlWebFetchProvider };
+export { t as createFirecrawlWebFetchProvider } from "./.setup/firecrawl-fetch-provider-DTGxGqmO.mjs";