@openclaw/firecrawl-plugin 2026.7.2-beta.7 → 2026.8.1-beta.3

package/dist/api.js

@@ -1,4 +1,4 @@
-import { n as runFirecrawlScrape } from "./firecrawl-client-DZohiNQK.js";
+import { n as runFirecrawlScrape } from "./firecrawl-client-mz7GIgb4.js";
 import { readStringValue } from "openclaw/plugin-sdk/string-coerce-runtime";
 //#region extensions/firecrawl/api.ts
 async function fetchFirecrawlContent(params) {

package/dist/{firecrawl-client-DZohiNQK.js → firecrawl-client-mz7GIgb4.js}

@@ -1,11 +1,12 @@
+import { parseFiniteNumber } from "openclaw/plugin-sdk/number-runtime";
 import { readProviderJsonObjectResponse } from "openclaw/plugin-sdk/provider-http";
-import { DEFAULT_CACHE_TTL_MINUTES, markdownToText, normalizeCacheKey, readCache, readResponseText, resolveCacheTtlMs, resolvePositiveTimeoutSeconds, truncateText, withSelfHostedWebToolsEndpoint, withStrictWebToolsEndpoint, writeCache } from "openclaw/plugin-sdk/provider-web-fetch";
-import { normalizeSecretInput, resolveSecretInputString } from "openclaw/plugin-sdk/secret-input";
-import { wrapExternalContent, wrapWebContent } from "openclaw/plugin-sdk/security-runtime";
+import { DEFAULT_CACHE_TTL_MINUTES, markdownToText, normalizeCacheKey, readCache, readResponseText, resolveCacheTtlMs, resolvePositiveTimeoutSeconds, withSelfHostedWebToolsEndpoint, withStrictWebToolsEndpoint, writeCache } from "openclaw/plugin-sdk/provider-web-fetch";
+import { normalizeSecretInput } from "openclaw/plugin-sdk/secret-input";
+import { truncateSanitizedExternalContent, wrapExternalContent, wrapWebContent } from "openclaw/plugin-sdk/security-runtime";
 import { SsrFBlockedError, isBlockedHostnameOrIp, isPrivateIpAddress, resolvePinnedHostnameWithPolicy } from "openclaw/plugin-sdk/ssrf-runtime";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
-import { truncateUtf16Safe } from "openclaw/plugin-sdk/text-utility-runtime";
-import { canResolveEnvSecretRefInReadOnlyPath } from "openclaw/plugin-sdk/extension-shared";
+import { z } from "zod";
+import { resolveReadOnlyEnvSecretRef } from "openclaw/plugin-sdk/secret-ref-readonly";
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
 var __exportAll = (all, no_symbols) => {
@@ -30,33 +31,13 @@ function resolveFirecrawlFetchConfig(cfg) {
 	if (pluginWebFetch && typeof pluginWebFetch === "object" && !Array.isArray(pluginWebFetch)) return pluginWebFetch;
 }
 function resolveConfiguredSecret(value, path, cfg) {
-	const resolved = resolveSecretInputString({
+	return resolveReadOnlyEnvSecretRef({
 		value,
 		path,
-		defaults: cfg?.secrets?.defaults,
-		mode: "inspect"
-	});
-	if (resolved.status === "available") {
-		const normalized = normalizeSecretInput(resolved.value);
-		return normalized ? {
-			status: "available",
-			value: normalized
-		} : { status: "missing" };
-	}
-	if (resolved.status === "missing") return { status: "missing" };
-	if (resolved.ref.source !== "env") return { status: "blocked" };
-	const envVarName = resolved.ref.id.trim();
-	if (envVarName !== FIRECRAWL_API_KEY_ENV_VAR) return { status: "blocked" };
-	if (!canResolveEnvSecretRefInReadOnlyPath({
 		cfg,
-		provider: resolved.ref.provider,
-		id: envVarName
-	})) return { status: "blocked" };
-	const envValue = normalizeSecretInput(process.env[envVarName]);
-	return envValue ? {
-		status: "available",
-		value: envValue
-	} : { status: "missing" };
+		expectedEnvId: FIRECRAWL_API_KEY_ENV_VAR,
+		normalizeValue: normalizeSecretInput
+	});
 }
 function resolveFirecrawlApiKey(cfg) {
 	const pluginConfig = cfg?.plugins?.entries?.firecrawl?.config;
@@ -103,7 +84,6 @@ function resolveFirecrawlSearchTimeoutSeconds(override) {
 //#endregion
 //#region extensions/firecrawl/src/firecrawl-client.ts
 var firecrawl_client_exports = /* @__PURE__ */ __exportAll({
-	__testing: () => testing,
 	assertFirecrawlScrapeTargetAllowed: () => assertFirecrawlScrapeTargetAllowed,
 	parseFirecrawlScrapePayload: () => parseFirecrawlScrapePayload,
 	runFirecrawlScrape: () => runFirecrawlScrape,
@@ -111,11 +91,15 @@ var firecrawl_client_exports = /* @__PURE__ */ __exportAll({
 	testing: () => testing
 });
 const SEARCH_CACHE = /* @__PURE__ */ new Map();
-const SCRAPE_CACHE = /* @__PURE__ */ new Map();
 const DEFAULT_SEARCH_COUNT = 5;
+const FIRECRAWL_SEARCH_MAX_RESULTS = 100;
+const FIRECRAWL_SEARCH_MAX_CONTENT_CHARS = 2e4;
 const DEFAULT_SCRAPE_MAX_CHARS = 5e4;
+const FIRECRAWL_SCRAPE_METADATA_MAX_CHARS = 4e3;
+const FIRECRAWL_RESULT_URL_MAX_CHARS = 2048;
 const FIRECRAWL_SCRAPE_RESPONSE_MAX_BYTES = 64 * 1024 * 1024;
 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.";
 async function readFirecrawlJsonResponse(response, label, opts) {
@@ -173,9 +157,10 @@ async function resolveEndpoint(baseUrl, pathname, lookupFn) {
 }
 async function postFirecrawlJson(params, parse) {
 	const apiKey = normalizeSecretInput(params.apiKey);
-	return await ((params.mode ?? await validateFirecrawlBaseUrl(params.url)) === "selfHosted" ? withSelfHostedWebToolsEndpoint : withStrictWebToolsEndpoint)({
+	const result = await ((params.mode ?? await validateFirecrawlBaseUrl(params.url)) === "selfHosted" ? withSelfHostedWebToolsEndpoint : withStrictWebToolsEndpoint)({
 		url: params.url,
 		timeoutSeconds: params.timeoutSeconds,
+		...params.signal ? { signal: params.signal } : {},
 		init: {
 			method: "POST",
 			headers: {
@@ -204,11 +189,13 @@ async function postFirecrawlJson(params, parse) {
 				const errorBody = await readResponseText(response, { maxBytes: 64e3 });
 				if (errorBody.text) detail = errorBody.text;
 			}
-			const safeDetail = wrapWebContent(truncateUtf16Safe(detail, 1e3), "web_fetch");
+			const safeDetail = wrapWebContent(truncateSanitizedExternalContent(detail, 1e3).text, "web_fetch");
 			throw new Error(`${params.errorLabel} API error (${response.status}): ${safeDetail}`);
 		}
 		return await parse(response);
 	});
+	params.signal?.throwIfAborted();
+	return result;
 }
 function resolveSiteName(urlRaw) {
 	try {
@@ -217,27 +204,72 @@ function resolveSiteName(urlRaw) {
 		return;
 	}
 }
+function normalizeFirecrawlResultUrl(value) {
+	if (typeof value !== "string" || value.length > FIRECRAWL_RESULT_URL_MAX_CHARS) return;
+	try {
+		const url = new URL(value);
+		if (url.protocol !== "http:" && url.protocol !== "https:" || url.href.length > FIRECRAWL_RESULT_URL_MAX_CHARS) return;
+		return url.href === `${value}/` ? value : url.href;
+	} catch {
+		return;
+	}
+}
+const optionalFirecrawlStringSchema = z.string().optional().catch(void 0);
+const invalidFirecrawlSearchItemSchema = z.unknown().transform(() => null);
+const firecrawlSearchMetadataSchema = z.object({
+	sourceURL: optionalFirecrawlStringSchema,
+	title: optionalFirecrawlStringSchema,
+	publishedTime: optionalFirecrawlStringSchema,
+	publishedDate: optionalFirecrawlStringSchema
+}).optional().catch(void 0);
+const firecrawlSearchItemSchema = z.object({
+	url: optionalFirecrawlStringSchema,
+	sourceURL: optionalFirecrawlStringSchema,
+	sourceUrl: optionalFirecrawlStringSchema,
+	title: optionalFirecrawlStringSchema,
+	description: optionalFirecrawlStringSchema,
+	snippet: optionalFirecrawlStringSchema,
+	summary: optionalFirecrawlStringSchema,
+	markdown: optionalFirecrawlStringSchema,
+	content: optionalFirecrawlStringSchema,
+	text: optionalFirecrawlStringSchema,
+	publishedDate: optionalFirecrawlStringSchema,
+	published: optionalFirecrawlStringSchema,
+	metadata: firecrawlSearchMetadataSchema
+});
+const firecrawlSearchItemsSchema = z.array(z.union([firecrawlSearchItemSchema, invalidFirecrawlSearchItemSchema])).transform((items) => items.filter((item) => item !== null));
+const firecrawlNestedSearchDataSchema = z.looseObject({
+	results: firecrawlSearchItemsSchema.optional().catch(void 0),
+	data: firecrawlSearchItemsSchema.optional().catch(void 0),
+	web: firecrawlSearchItemsSchema.optional().catch(void 0)
+});
+const firecrawlSearchPayloadSchema = z.looseObject({
+	data: z.union([firecrawlSearchItemsSchema, firecrawlNestedSearchDataSchema]).optional().catch(void 0),
+	results: firecrawlSearchItemsSchema.optional().catch(void 0),
+	web: z.looseObject({ results: firecrawlSearchItemsSchema.optional().catch(void 0) }).optional().catch(void 0)
+});
 function resolveSearchItems(payload) {
+	const parsed = firecrawlSearchPayloadSchema.parse(payload);
+	const nestedData = Array.isArray(parsed.data) ? void 0 : parsed.data;
 	const rawItems = [
-		payload.data,
-		payload.results,
-		payload.data?.results,
-		payload.data?.data,
-		payload.data?.web,
-		payload.web?.results
-	].find((candidate) => Array.isArray(candidate));
-	if (!Array.isArray(rawItems)) return [];
+		Array.isArray(parsed.data) ? parsed.data : void 0,
+		parsed.results,
+		nestedData?.results,
+		nestedData?.data,
+		nestedData?.web,
+		parsed.web?.results
+	].find((candidate) => candidate !== void 0);
+	if (!rawItems) return [];
 	const items = [];
-	for (const entry of rawItems) {
-		if (!entry || typeof entry !== "object") continue;
-		const record = entry;
-		const metadata = record.metadata && typeof record.metadata === "object" ? record.metadata : void 0;
-		const url = typeof record.url === "string" && record.url || typeof record.sourceURL === "string" && record.sourceURL || typeof record.sourceUrl === "string" && record.sourceUrl || typeof metadata?.sourceURL === "string" && metadata.sourceURL || "";
+	for (const entry of rawItems.slice(0, FIRECRAWL_SEARCH_MAX_RESULTS)) {
+		const metadata = entry.metadata;
+		const url = normalizeFirecrawlResultUrl(entry.url || entry.sourceURL || entry.sourceUrl || metadata?.sourceURL || "");
 		if (!url) continue;
-		const title = typeof record.title === "string" && record.title || typeof metadata?.title === "string" && metadata.title || "";
-		const description = typeof record.description === "string" && record.description || typeof record.snippet === "string" && record.snippet || typeof record.summary === "string" && record.summary || void 0;
-		const content = typeof record.markdown === "string" && record.markdown || typeof record.content === "string" && record.content || typeof record.text === "string" && record.text || void 0;
-		const published = typeof record.publishedDate === "string" && record.publishedDate || typeof record.published === "string" && record.published || typeof metadata?.publishedTime === "string" && metadata.publishedTime || typeof metadata?.publishedDate === "string" && metadata.publishedDate || void 0;
+		const title = entry.title || metadata?.title || "";
+		const description = entry.description || entry.snippet || entry.summary || void 0;
+		const content = entry.markdown || entry.content || entry.text || void 0;
+		const rawPublished = entry.publishedDate || entry.published || metadata?.publishedTime || metadata?.publishedDate || void 0;
+		const published = rawPublished && FIRECRAWL_PUBLISHED_DATE_RE.test(rawPublished) ? rawPublished : void 0;
 		items.push({
 			title,
 			url,
@@ -250,6 +282,22 @@ function resolveSearchItems(payload) {
 	return items;
 }
 function buildSearchPayload(params) {
+	let remainingContentChars = FIRECRAWL_SEARCH_MAX_CONTENT_CHARS;
+	let truncated = false;
+	const wrapBoundedContent = (value) => {
+		const bounded = truncateSanitizedExternalContent(value, remainingContentChars);
+		truncated ||= bounded.truncated;
+		remainingContentChars -= bounded.text.length;
+		return wrapWebContent(bounded.text, "web_search");
+	};
+	const results = params.items.map((entry) => ({
+		title: entry.title ? wrapBoundedContent(entry.title) : "",
+		url: entry.url,
+		description: entry.description ? wrapBoundedContent(entry.description) : "",
+		...entry.published ? { published: entry.published } : {},
+		...entry.siteName ? { siteName: entry.siteName } : {},
+		...params.scrapeResults && entry.content ? { content: wrapBoundedContent(entry.content) } : {}
+	}));
 	return {
 		query: params.query,
 		provider: params.provider,
@@ -261,17 +309,12 @@ function buildSearchPayload(params) {
 			provider: params.provider,
 			wrapped: true
 		},
-		results: params.items.map((entry) => ({
-			title: entry.title ? wrapWebContent(entry.title, "web_search") : "",
-			url: entry.url,
-			description: entry.description ? wrapWebContent(entry.description, "web_search") : "",
-			...entry.published ? { published: entry.published } : {},
-			...entry.siteName ? { siteName: entry.siteName } : {},
-			...params.scrapeResults && entry.content ? { content: wrapWebContent(entry.content, "web_search") } : {}
-		}))
+		results,
+		...truncated ? { truncated: true } : {}
 	};
 }
 async function runFirecrawlSearch(params) {
+	params.signal?.throwIfAborted();
 	const keyless = params.access === "keyless";
 	const providerId = keyless ? "firecrawl-free" : "firecrawl";
 	const apiKey = keyless ? void 0 : resolveFirecrawlApiKey(params.cfg);
@@ -328,19 +371,20 @@ async function runFirecrawlSearch(params) {
 		timeoutSeconds,
 		apiKey,
 		body,
-		errorLabel: "Firecrawl Search"
+		errorLabel: "Firecrawl Search",
+		...params.signal ? { signal: params.signal } : {}
 	}, async (response) => {
 		const payloadValue = await readFirecrawlJsonResponse(response, "Firecrawl Search API error");
 		if (payloadValue.success === false) {
-			const error = typeof payloadValue.error === "string" ? payloadValue.error : typeof payloadValue.message === "string" ? payloadValue.message : "unknown error";
-			throw new Error(`Firecrawl Search API error: ${error}`);
+			const safeError = wrapWebContent(truncateSanitizedExternalContent(typeof payloadValue.error === "string" ? payloadValue.error : typeof payloadValue.message === "string" ? payloadValue.message : "unknown error", 1e3).text, "web_search");
+			throw new Error(`Firecrawl Search API error: ${safeError}`);
 		}
 		return payloadValue;
 	});
 	const result = buildSearchPayload({
 		query: params.query,
 		provider: providerId,
-		items: resolveSearchItems(payload),
+		items: resolveSearchItems(payload).slice(0, count),
 		tookMs: Date.now() - start,
 		scrapeResults
 	});
@@ -355,26 +399,33 @@ function resolveScrapeData(payload) {
 function parseFirecrawlScrapePayload(params) {
 	const data = resolveScrapeData(params.payload);
 	const metadata = data.metadata && typeof data.metadata === "object" ? data.metadata : void 0;
+	const rawStatus = parseFiniteNumber(metadata?.statusCode) ?? parseFiniteNumber(data.statusCode);
+	const status = rawStatus === void 0 ? void 0 : Math.floor(rawStatus);
+	if (status !== void 0 && (status < 200 || status >= 300)) throw new Error(`Firecrawl fetch failed (${status}): target returned an unsuccessful HTTP status.`);
 	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 truncated = truncateText(rawText, params.maxChars);
-	const wrappedText = wrapExternalContent(truncated.text, {
+	const boundedText = truncateSanitizedExternalContent(rawText, params.maxChars);
+	let truncated = boundedText.truncated;
+	let remainingMetadataChars = FIRECRAWL_SCRAPE_METADATA_MAX_CHARS;
+	const wrapBoundedMetadata = (value) => {
+		const bounded = truncateSanitizedExternalContent(value, remainingMetadataChars);
+		truncated ||= bounded.truncated;
+		remainingMetadataChars -= bounded.text.length;
+		return wrapExternalContent(bounded.text, {
+			source: "web_fetch",
+			includeWarning: false
+		});
+	};
+	const wrappedText = wrapExternalContent(boundedText.text, {
 		source: "web_fetch",
 		includeWarning: false
 	});
-	const status = typeof metadata?.statusCode === "number" && metadata.statusCode || typeof data.statusCode === "number" && data.statusCode || void 0;
-	const title = typeof metadata?.title === "string" && metadata.title ? wrapExternalContent(metadata.title, {
-		source: "web_fetch",
-		includeWarning: false
-	}) : void 0;
-	const warning = typeof params.payload.warning === "string" && params.payload.warning ? wrapExternalContent(params.payload.warning, {
-		source: "web_fetch",
-		includeWarning: false
-	}) : void 0;
+	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;
 	return {
 		url: params.url,
-		finalUrl: typeof metadata?.sourceURL === "string" && metadata.sourceURL || typeof data.url === "string" && data.url || params.url,
+		finalUrl: normalizeFirecrawlResultUrl(metadata?.sourceURL) ?? normalizeFirecrawlResultUrl(data.url) ?? params.url,
 		...status !== void 0 ? { status } : {},
 		...title ? { title } : {},
 		extractor: "firecrawl",
@@ -384,7 +435,7 @@ function parseFirecrawlScrapePayload(params) {
 			source: "web_fetch",
 			wrapped: true
 		},
-		truncated: truncated.truncated,
+		truncated,
 		rawLength: rawText.length,
 		length: wrappedText.length,
 		text: wrappedText,
@@ -392,6 +443,7 @@ function parseFirecrawlScrapePayload(params) {
 	};
 }
 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.");
@@ -401,31 +453,19 @@ async function runFirecrawlScrape(params) {
 	const maxAgeMs = resolveFirecrawlMaxAgeMs(params.cfg, params.maxAgeMs);
 	const proxy = params.proxy ?? "auto";
 	const storeInCache = params.storeInCache ?? true;
-	const maxChars = typeof params.maxChars === "number" && Number.isFinite(params.maxChars) && params.maxChars > 0 ? Math.floor(params.maxChars) : DEFAULT_SCRAPE_MAX_CHARS;
-	const cacheKey = normalizeCacheKey(JSON.stringify({
-		type: "firecrawl-scrape",
-		url: params.url,
-		extractMode: params.extractMode,
-		baseUrl,
-		onlyMainContent,
-		maxAgeMs,
-		proxy,
-		storeInCache,
-		maxChars
-	}));
-	const cached = readCache(SCRAPE_CACHE, cacheKey);
-	if (cached) return {
-		...cached.value,
-		cached: true
-	};
+	const configuredMaxCharsCap = params.cfg?.tools?.web?.fetch?.maxCharsCap;
+	const maxCharsCap = typeof configuredMaxCharsCap === "number" && Number.isFinite(configuredMaxCharsCap) && configuredMaxCharsCap > 0 ? Math.floor(configuredMaxCharsCap) : DEFAULT_SCRAPE_MAX_CHARS;
+	const requestedMaxChars = typeof params.maxChars === "number" && Number.isFinite(params.maxChars) && params.maxChars > 0 ? Math.floor(params.maxChars) : DEFAULT_SCRAPE_MAX_CHARS;
+	const maxChars = Math.min(requestedMaxChars, maxCharsCap);
 	const endpoint = await resolveEndpoint(baseUrl, "/v2/scrape");
-	const result = parseFirecrawlScrapePayload({
+	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"],
@@ -439,7 +479,7 @@ async function runFirecrawlScrape(params) {
 			const payloadLocal = await readFirecrawlJsonResponse(response, "Firecrawl fetch failed", { maxBytes: FIRECRAWL_SCRAPE_RESPONSE_MAX_BYTES });
 			if (payloadLocal.success === false) {
 				const detail = typeof payloadLocal.error === "string" ? payloadLocal.error : typeof payloadLocal.message === "string" ? payloadLocal.message : response.statusText;
-				throw new Error(`Firecrawl fetch failed (${response.status}): ${wrapWebContent(detail, "web_fetch")}`.trim());
+				throw new Error(`Firecrawl fetch failed (${response.status}): ${wrapWebContent(truncateSanitizedExternalContent(detail, FIRECRAWL_SCRAPE_METADATA_MAX_CHARS).text, "web_fetch")}`.trim());
 			}
 			return payloadLocal;
 		}),
@@ -447,8 +487,6 @@ async function runFirecrawlScrape(params) {
 		extractMode: params.extractMode,
 		maxChars
 	});
-	writeCache(SCRAPE_CACHE, cacheKey, result, resolveCacheTtlMs(void 0, DEFAULT_CACHE_TTL_MINUTES));
-	return result;
 }
 const testing = {
 	assertFirecrawlScrapeTargetAllowed,
@@ -456,7 +494,6 @@ const testing = {
 	postFirecrawlJson,
 	readFirecrawlJsonResponse,
 	resolveEndpoint,
-	validateFirecrawlBaseUrl,
 	resolveSearchItems
 };
 //#endregion

package/dist/{firecrawl-fetch-provider-DXmd_5yB.js → firecrawl-fetch-provider-kMXMNJJw.js}

@@ -1,10 +1,10 @@
-import { t as FIRECRAWL_WEB_FETCH_PROVIDER_SHARED } from "./firecrawl-fetch-provider-shared-BhzfHFkE.js";
+import { t as FIRECRAWL_WEB_FETCH_PROVIDER_SHARED } from "./firecrawl-fetch-provider-shared-DlD5WG_i.js";
 import { readPositiveIntegerParam } from "openclaw/plugin-sdk/param-readers";
 import { enablePluginInConfig } from "openclaw/plugin-sdk/provider-web-fetch-contract";
 //#region extensions/firecrawl/src/firecrawl-fetch-provider.ts
 let firecrawlClientModulePromise;
 function loadFirecrawlClientModule() {
-	firecrawlClientModulePromise ??= import("./firecrawl-client-DZohiNQK.js").then((n) => n.t);
+	firecrawlClientModulePromise ??= import("./firecrawl-client-mz7GIgb4.js").then((n) => n.t);
 	return firecrawlClientModulePromise;
 }
 function createFirecrawlWebFetchProvider() {

package/dist/{firecrawl-fetch-provider-shared-BhzfHFkE.js → firecrawl-fetch-provider-shared-DlD5WG_i.js}

@@ -39,7 +39,10 @@ const FIRECRAWL_WEB_FETCH_PROVIDER_SHARED = {
 		};
 	},
 	setConfiguredCredentialValue: (configTarget, value) => {
-		const webFetch = ensureRecord(ensureRecord(ensureRecord(ensureRecord(ensureRecord(configTarget, "plugins"), "entries"), "firecrawl"), "config"), "webFetch");
+		const plugins = configTarget.plugins ??= {};
+		const entries = plugins.entries ??= {};
+		const firecrawlEntry = entries.firecrawl ??= {};
+		const webFetch = ensureRecord(firecrawlEntry.config ??= {}, "webFetch");
 		webFetch.apiKey = value;
 	}
 };

package/dist/{firecrawl-free-search-provider-D_QqmJGK.js → firecrawl-free-search-provider-BnGTMs5x.js}

@@ -2,7 +2,7 @@ import { buildFirecrawlFreeWebSearchProviderBase, buildFirecrawlWebSearchProvide
 import { readPositiveIntegerParam } from "openclaw/plugin-sdk/param-readers";
 import { createLazyRuntimeModule } from "openclaw/plugin-sdk/lazy-runtime";
 //#region extensions/firecrawl/src/firecrawl-search-provider.ts
-const loadFirecrawlClientModule$1 = createLazyRuntimeModule(() => import("./firecrawl-client-DZohiNQK.js").then((n) => n.t));
+const loadFirecrawlClientModule$1 = createLazyRuntimeModule(() => import("./firecrawl-client-mz7GIgb4.js").then((n) => n.t));
 const GenericFirecrawlSearchSchema = {
 	type: "object",
 	properties: {
@@ -25,7 +25,8 @@ function createFirecrawlWebSearchProvider() {
 		createTool: (ctx) => ({
 			description: "Search the web using Firecrawl. Returns structured results with snippets from Firecrawl Search. Use firecrawl_search for Firecrawl-specific knobs like sources or categories.",
 			parameters: GenericFirecrawlSearchSchema,
-			execute: async (args) => {
+			execute: async (args, executionContext) => {
+				executionContext?.signal?.throwIfAborted();
 				const { runFirecrawlSearch } = await loadFirecrawlClientModule$1();
 				return await runFirecrawlSearch({
 					cfg: ctx.config,
@@ -33,7 +34,8 @@ function createFirecrawlWebSearchProvider() {
 					count: readPositiveIntegerParam(args, "count", {
 						message: "count must be an integer from 1 to 10",
 						max: 10
-					})
+					}),
+					...executionContext?.signal ? { signal: executionContext.signal } : {}
 				});
 			}
 		})
@@ -43,7 +45,7 @@ function createFirecrawlWebSearchProvider() {
 //#region extensions/firecrawl/src/firecrawl-free-search-provider.ts
 let firecrawlClientModulePromise;
 function loadFirecrawlClientModule() {
-	firecrawlClientModulePromise ??= import("./firecrawl-client-DZohiNQK.js").then((n) => n.t);
+	firecrawlClientModulePromise ??= import("./firecrawl-client-mz7GIgb4.js").then((n) => n.t);
 	return firecrawlClientModulePromise;
 }
 function createFirecrawlFreeWebSearchProvider() {
@@ -52,7 +54,8 @@ function createFirecrawlFreeWebSearchProvider() {
 		createTool: (ctx) => ({
 			description: "Search the web using Firecrawl's free hosted starter tier (no API key required). Returns structured results with snippets. Use firecrawl_search for Firecrawl-specific knobs like sources or categories.",
 			parameters: GenericFirecrawlSearchSchema,
-			execute: async (args) => {
+			execute: async (args, executionContext) => {
+				executionContext?.signal?.throwIfAborted();
 				const { runFirecrawlSearch } = await loadFirecrawlClientModule();
 				return await runFirecrawlSearch({
 					cfg: ctx.config,
@@ -61,7 +64,8 @@ function createFirecrawlFreeWebSearchProvider() {
 						message: "count must be an integer from 1 to 10",
 						max: 10
 					}),
-					access: "keyless"
+					access: "keyless",
+					...executionContext?.signal ? { signal: executionContext.signal } : {}
 				});
 			}
 		})

package/dist/index.js

@@ -1,6 +1,6 @@
-import { n as runFirecrawlScrape, r as runFirecrawlSearch } from "./firecrawl-client-DZohiNQK.js";
-import { t as createFirecrawlWebFetchProvider } from "./firecrawl-fetch-provider-DXmd_5yB.js";
-import { n as createFirecrawlWebSearchProvider, t as createFirecrawlFreeWebSearchProvider } from "./firecrawl-free-search-provider-D_QqmJGK.js";
+import { n as runFirecrawlScrape, r as runFirecrawlSearch } from "./firecrawl-client-mz7GIgb4.js";
+import { t as createFirecrawlWebFetchProvider } from "./firecrawl-fetch-provider-kMXMNJJw.js";
+import { n as createFirecrawlWebSearchProvider, t as createFirecrawlFreeWebSearchProvider } from "./firecrawl-free-search-provider-BnGTMs5x.js";
 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";
@@ -33,9 +33,11 @@ function createFirecrawlScrapeTool(api) {
 	return {
 		name: "firecrawl_scrape",
 		label: "Firecrawl Scrape",
-		description: "Scrape a page using Firecrawl v2/scrape. Useful for JS-heavy or bot-protected pages where plain web_fetch is weak.",
+		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) => {
+		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");
@@ -54,7 +56,8 @@ function createFirecrawlScrapeTool(api) {
 				maxAgeMs,
 				proxy,
 				storeInCache,
-				timeoutSeconds
+				timeoutSeconds,
+				...signal ? { signal } : {}
 			}));
 		}
 	};
@@ -85,9 +88,11 @@ 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) => {
+		execute: async (_toolCallId, rawParams, signal) => {
+			signal?.throwIfAborted();
 			const query = readStringParam(rawParams, "query", { required: true });
 			const count = readPositiveIntegerParam(rawParams, "count", {
 				max: 100,
@@ -114,7 +119,8 @@ function createFirecrawlSearchTool(api) {
 				tbs,
 				location,
 				country,
-				scrapeResults
+				scrapeResults,
+				...signal ? { signal } : {}
 			}));
 		}
 	};

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

@@ -1,4 +1,4 @@
-import { t as FIRECRAWL_WEB_FETCH_PROVIDER_SHARED } from "./firecrawl-fetch-provider-shared-BhzfHFkE.js";
+import { t as FIRECRAWL_WEB_FETCH_PROVIDER_SHARED } from "./firecrawl-fetch-provider-shared-DlD5WG_i.js";
 import { enablePluginInConfig } from "openclaw/plugin-sdk/provider-web-fetch-contract";
 //#region extensions/firecrawl/web-fetch-contract-api.ts
 function createFirecrawlWebFetchProvider() {

package/dist/web-fetch-provider.js

@@ -1,2 +1,2 @@
-import { t as createFirecrawlWebFetchProvider } from "./firecrawl-fetch-provider-DXmd_5yB.js";
+import { t as createFirecrawlWebFetchProvider } from "./firecrawl-fetch-provider-kMXMNJJw.js";
 export { createFirecrawlWebFetchProvider };

package/dist/web-search-provider.js

@@ -1,2 +1,2 @@
-import { n as createFirecrawlWebSearchProvider, t as createFirecrawlFreeWebSearchProvider } from "./firecrawl-free-search-provider-D_QqmJGK.js";
+import { n as createFirecrawlWebSearchProvider, t as createFirecrawlFreeWebSearchProvider } from "./firecrawl-free-search-provider-BnGTMs5x.js";
 export { createFirecrawlFreeWebSearchProvider, createFirecrawlWebSearchProvider };

package/node_modules/zod/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Colin McDonnell
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.