firecrawl 4.40.0 → 4.41.0

package/dist/{chunk-OJ4YJQ4J.js → chunk-I2DFXQYR.js}

@@ -12,7 +12,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@mendable/firecrawl-js",
-      version: "4.40.0",
+      version: "4.41.0",
       description: "JavaScript SDK for the Firecrawl API: web scraping, crawling, web search, and scientific literature search over a research paper index of PubMed, bioRxiv, medRxiv and arXiv abstracts",
       main: "dist/index.js",
       types: "dist/index.d.ts",

package/dist/index.cjs

@@ -39,7 +39,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@mendable/firecrawl-js",
-      version: "4.40.0",
+      version: "4.41.0",
       description: "JavaScript SDK for the Firecrawl API: web scraping, crawling, web search, and scientific literature search over a research paper index of PubMed, bioRxiv, medRxiv and arXiv abstracts",
       main: "dist/index.js",
       types: "dist/index.d.ts",
@@ -779,6 +779,7 @@ function prepareSearchPayload(req) {
   const payload = {
     query: req.query
   };
+  if (req.toolDetail != null) payload.toolDetail = req.toolDetail;
   if (req.domainTools != null) payload.domainTools = req.domainTools;
   if (req.sources) payload.sources = req.sources;
   if (req.categories) payload.categories = req.categories;
@@ -1447,7 +1448,8 @@ function prepareExtractPayload(args) {
     body.threatProtection = args.threatProtection;
   if (args.scrapeOptions) {
     ensureValidScrapeOptions(args.scrapeOptions);
-    body.scrapeOptions = args.scrapeOptions;
+    const { toolDetail, domainTools, ...scrapeOptions } = args.scrapeOptions;
+    body.scrapeOptions = scrapeOptions;
   }
   return body;
 }

package/dist/index.d.cts

@@ -118,6 +118,15 @@ type ActionOption = WaitAction | ScreenshotAction | ClickAction | WriteAction |
 interface AuditMetadata$1 {
     username: string;
 }
+/**
+ * OCR raster images (PNG, JPEG, JPEG 2000, TIFF, GIF, BMP, WebP, AVIF) as
+ * one-page documents. Part of the default parsers list next to "pdf"; takes
+ * no options, so the string "image" is equivalent. Omit it from an explicit
+ * list to keep image URLs failing as unsupported files.
+ */
+type ImageParser = {
+    type: "image";
+};
 type PDFParser = {
     type: "pdf";
     mode?: "fast" | "auto" | "ocr";
@@ -174,7 +183,7 @@ interface ScrapeOptions {
     timeout?: number;
     waitFor?: number;
     mobile?: boolean;
-    parsers?: Array<string | PDFParser>;
+    parsers?: Array<string | PDFParser | ImageParser>;
     actions?: ActionOption[];
     location?: LocationConfig$1;
     skipTlsVerification?: boolean;
@@ -200,8 +209,10 @@ interface ScrapeOptions {
     };
     integration?: string;
     origin?: string;
-    /** Include domain-matched Alexandria contracts for this URL in `tools`. Default off. */
+    /** Include domain-matched Alexandria tools for this URL in `tools`. Default off. */
     domainTools?: boolean;
+    /** Summary by default; compact returns identity and description, full includes contracts. */
+    toolDetail?: "compact" | "summary" | "full";
 }
 type RedactPIIEntity = "PERSON" | "EMAIL" | "PHONE" | "LOCATION" | "FINANCIAL" | "SECRET";
 interface RedactPIIOptions {
@@ -227,8 +238,14 @@ interface RedactPIIOptions {
  * fields you provide replace the team policy's values.
  */
 interface ThreatProtectionOptions {
-    /** "off" disables scanning for this request; "normal" applies the policy. */
-    mode?: "off" | "normal";
+    /**
+     * "off" disables scanning for this request; "manual-only" enforces only the
+     * blacklist / whitelist / blocked TLDs (no provider scan, no scan fee);
+     * "normal" scans with Google Web Risk; "zscaler" classifies through your
+     * organization's Zscaler connection. Enforced teams may raise the mode per
+     * request but never lower it.
+     */
+    mode?: "off" | "manual-only" | "normal" | "zscaler";
     /** Block verdicts at or above this risk score (integer 0-100). */
     riskScoreThreshold?: number;
     /** Exact domains or globs like "*.example.com" to always block (max 1000). */
@@ -246,7 +263,7 @@ interface ParseFile {
     filename: string;
     contentType?: string;
 }
-type ParseOptions = Omit<ScrapeOptions, "formats" | "waitFor" | "mobile" | "actions" | "location" | "maxAge" | "minAge" | "storeInCache" | "lockdown" | "proxy" | "threatProtection"> & {
+type ParseOptions = Omit<ScrapeOptions, "formats" | "waitFor" | "mobile" | "actions" | "location" | "maxAge" | "minAge" | "storeInCache" | "lockdown" | "proxy" | "threatProtection" | "toolDetail"> & {
     formats?: ParseFormatOption[];
     proxy?: "basic" | "auto";
 };
@@ -662,14 +679,15 @@ interface SearchData {
 }
 /** A complete tool contract returned by semantic or contextual discovery. */
 interface DiscoveredTool {
+    next?: AlexandriaCall;
     id?: string;
     provider: string;
     capability: string;
-    name: string;
+    name?: string;
     description: string;
-    creditsCost: number;
-    perRecord: boolean;
-    options: Array<{
+    creditsCost?: number;
+    perRecord?: boolean;
+    options?: Array<{
         name: string;
         type: string;
         required?: boolean;
@@ -797,8 +815,10 @@ interface CategoryOption {
 }
 interface SearchRequest {
     query: string;
-    /** Include domain-matched contracts in tools alongside semantic matches. */
+    /** Include domain-matched tools in tools alongside semantic matches. */
     domainTools?: boolean;
+    /** Compact by default; summary adds metadata, full includes contracts. */
+    toolDetail?: "compact" | "summary" | "full";
     sources?: Array<"web" | "news" | "images" | "alexandria" | {
         type: "web" | "news" | "images" | "alexandria";
     }>;
@@ -822,7 +842,7 @@ interface SearchRequest {
     timeout?: number;
     /** Generate query-relevant highlights for search results. Defaults to true. */
     highlights?: boolean;
-    scrapeOptions?: ScrapeOptions;
+    scrapeOptions?: Omit<ScrapeOptions, "toolDetail">;
     /**
      * Enterprise search options. Use `["zdr"]` for end-to-end Zero Data
      * Retention or `["anon"]` for anonymized search. Must be enabled for
@@ -850,7 +870,7 @@ interface CrawlOptions {
     delay?: number | null;
     maxConcurrency?: number | null;
     webhook?: string | WebhookConfig | null;
-    scrapeOptions?: ScrapeOptions | null;
+    scrapeOptions?: Omit<ScrapeOptions, "toolDetail"> | null;
     regexOnFullURL?: boolean;
     zeroDataRetention?: boolean;
     integration?: string;
@@ -871,7 +891,7 @@ interface CrawlJob {
     data: Document[];
 }
 interface BatchScrapeOptions {
-    options?: ScrapeOptions;
+    options?: Omit<ScrapeOptions, "toolDetail">;
     webhook?: string | WebhookConfig;
     appendToId?: string;
     ignoreInvalidURLs?: boolean;
@@ -1005,14 +1025,14 @@ interface MonitorScrapeTarget {
     id?: string;
     type: "scrape";
     urls: string[];
-    scrapeOptions?: ScrapeOptions;
+    scrapeOptions?: Omit<ScrapeOptions, "toolDetail">;
 }
 interface MonitorCrawlTarget {
     id?: string;
     type: "crawl";
     url: string;
     crawlOptions?: CrawlOptions;
-    scrapeOptions?: ScrapeOptions;
+    scrapeOptions?: Omit<ScrapeOptions, "toolDetail">;
 }
 interface MonitorSearchTarget {
     id?: string;
@@ -3389,4 +3409,4 @@ declare class Firecrawl extends FirecrawlClient {
     get v1(): FirecrawlApp;
 }
 
-export { type ActionOption, type ActiveCrawl, type ActiveCrawlsResponse, type AgentEffort, type AgentExchangeOptions, type AgentExchangeSummary, type AgentListItem, type AgentListOptions, type AgentListResponse, type AgentMode, type AgentOptions$1 as AgentOptions, type AgentResponse, type AgentSnapshotResponse, type AgentStatusResponse, type AgentSuggestion, type AgentThread, type AgentThreadResponse, type AgentThreadRun, type AgentTraceActiveBrowserSession, type AgentTraceAgentFinishedEvent, type AgentTraceAgentIdentity, type AgentTraceAgentRole, type AgentTraceAgentStartedEvent, type AgentTraceArtifactChange, type AgentTraceArtifactUpdatedEvent, type AgentTraceBrowserSessionFinishedEvent, type AgentTraceBrowserSessionStartedEvent, type AgentTraceError, type AgentTraceErrorOccurredEvent, type AgentTraceEvent, type AgentTraceProgressReportedEvent, type AgentTraceReasoningSummaryEvent, type AgentTraceResponse, type AgentTraceRunCancelRequestedEvent, type AgentTraceRunFinishedEvent, type AgentTraceRunStartedEvent, type AgentTraceToolCallFinishedEvent, type AgentTraceToolCallStartedEvent, type AgentWebhookConfig, type AgentWebhookEvent, type AlexandriaCall, type AlexandriaOptions, type AlexandriaScrapeData, type AlexandriaScrapeError, type AlexandriaScrapeRequest, type AlexandriaScrapeResult, type AttributesFormat, type AuditMetadata$1 as AuditMetadata, type BatchScrapeJob, type BatchScrapeOptions, type BatchScrapeResponse$1 as BatchScrapeResponse, type BrandingProfile, type BrowserCreateResponse, type BrowserDeleteResponse, type BrowserExecuteResponse, type BrowserListResponse, type BrowserSession, type CategoryOption, type ChangeTrackingFormat, type ClickAction, type ConcurrencyCheck, type CrawlErrorsResponse$1 as CrawlErrorsResponse, type CrawlJob, type CrawlOptions, type CrawlResponse$1 as CrawlResponse, type CreateMonitorRequest, type CreditUsage, type CreditUsageHistoricalPeriod, type CreditUsageHistoricalResponse, type DeveloperSearchLicenseDisclosure, type DeveloperSearchOptions, type DeveloperSearchPassage, type DeveloperSearchRepoStatus, type DeveloperSearchResponse, type DeveloperSearchResult, type DeveloperSearchSourceStatus, type DeveloperSearchType, type DiscoveredTool, type Document, type DocumentMetadata, type EndpointFeedbackEndpoint, type EndpointFeedbackRequest, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, type FeedbackMissingContent, type FeedbackRating, type FeedbackResponse, type FeedbackValuableSource, type FindToolsData, type FindToolsOptions, Firecrawl, FirecrawlApp as FirecrawlAppV1, FirecrawlClient, type FirecrawlClientInput, type FirecrawlClientOptions, type Format, type FormatOption, type FormatString, type GetMonitorCheckOptions, type GetPaperOptions, type GitHubScoreBreakdown, type GitHubSearchItem, type GitHubSearchResponse, type HighlightsFormat, type IdMap, JobTimeoutError, type JsonFormat, type ListMonitorChecksOptions, type ListMonitorsOptions, type LocationConfig$1 as LocationConfig, type MapData, type MapOptions, type MenuAvailability, type MenuImage, type MenuItem, type MenuItemIdentifiers, type MenuMerchant, type MenuPrice, type MenuProfile, type MenuSection, type Monitor, type MonitorCheck, type MonitorCheckDetail, type MonitorCheckPage, type MonitorCrawlTarget, type MonitorCrawlTargetResult, type MonitorEmailNotification, type MonitorEmailRecipientSubscription, type MonitorJsonFieldDiff, type MonitorNotification, type MonitorPageDiff, type MonitorPageJudgment, type MonitorPageSnapshot, type MonitorSchedule, type MonitorScrapeTarget, type MonitorScrapeTargetResult, type MonitorSearchTarget, type MonitorSearchTargetResult, type MonitorSummary, type MonitorTarget, type MonitorTargetResult, type MonitorWebhookConfig, type PDFAction, type PDFParser, type PaginationConfig, type PaperMetadata, type PaperMetadataResponse, type PaperResult, type PaperSignals, type ParseFile, type ParseFileData, type ParseFormat, type ParseFormatOption, type ParseFormatString, type ParseOptions, type Passage, type PdfBlockConfidence, type PdfBlockItem, type PdfPage, type PdfPageBlocks, type PendingApproval, type PressAction, type ProductAvailability, type ProductImage, type ProductPrice, type ProductProfile, type ProductSale, type ProductVariant, type QueryFormat, type QuestionFormat, type QueueStatusResponse$1 as QueueStatusResponse, type ReadPaperResponse, type RedactPIIEntity, type RedactPIIOptions, type RequiresAction, ResearchClient, type ScrapeAction, type ScrapeBrowserDeleteResponse, type ScrapeExecuteRequest, type ScrapeExecuteResponse, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchFeedbackRequest, type SearchGithubOptions, type SearchPapersOptions, type SearchPapersResponse, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type SimilarPapersOptions, type SimilarPapersResponse, type ThreatProtectionOptions, type TokenUsage, type TokenUsageHistoricalPeriod, type TokenUsageHistoricalResponse, type UpdateMonitorRequest, type Viewport, type WaitAction, Watcher, type WatcherOptions, type WebhookConfig, type WriteAction, Firecrawl as default, parseRequiresAction };
+export { type ActionOption, type ActiveCrawl, type ActiveCrawlsResponse, type AgentEffort, type AgentExchangeOptions, type AgentExchangeSummary, type AgentListItem, type AgentListOptions, type AgentListResponse, type AgentMode, type AgentOptions$1 as AgentOptions, type AgentResponse, type AgentSnapshotResponse, type AgentStatusResponse, type AgentSuggestion, type AgentThread, type AgentThreadResponse, type AgentThreadRun, type AgentTraceActiveBrowserSession, type AgentTraceAgentFinishedEvent, type AgentTraceAgentIdentity, type AgentTraceAgentRole, type AgentTraceAgentStartedEvent, type AgentTraceArtifactChange, type AgentTraceArtifactUpdatedEvent, type AgentTraceBrowserSessionFinishedEvent, type AgentTraceBrowserSessionStartedEvent, type AgentTraceError, type AgentTraceErrorOccurredEvent, type AgentTraceEvent, type AgentTraceProgressReportedEvent, type AgentTraceReasoningSummaryEvent, type AgentTraceResponse, type AgentTraceRunCancelRequestedEvent, type AgentTraceRunFinishedEvent, type AgentTraceRunStartedEvent, type AgentTraceToolCallFinishedEvent, type AgentTraceToolCallStartedEvent, type AgentWebhookConfig, type AgentWebhookEvent, type AlexandriaCall, type AlexandriaOptions, type AlexandriaScrapeData, type AlexandriaScrapeError, type AlexandriaScrapeRequest, type AlexandriaScrapeResult, type AttributesFormat, type AuditMetadata$1 as AuditMetadata, type BatchScrapeJob, type BatchScrapeOptions, type BatchScrapeResponse$1 as BatchScrapeResponse, type BrandingProfile, type BrowserCreateResponse, type BrowserDeleteResponse, type BrowserExecuteResponse, type BrowserListResponse, type BrowserSession, type CategoryOption, type ChangeTrackingFormat, type ClickAction, type ConcurrencyCheck, type CrawlErrorsResponse$1 as CrawlErrorsResponse, type CrawlJob, type CrawlOptions, type CrawlResponse$1 as CrawlResponse, type CreateMonitorRequest, type CreditUsage, type CreditUsageHistoricalPeriod, type CreditUsageHistoricalResponse, type DeveloperSearchLicenseDisclosure, type DeveloperSearchOptions, type DeveloperSearchPassage, type DeveloperSearchRepoStatus, type DeveloperSearchResponse, type DeveloperSearchResult, type DeveloperSearchSourceStatus, type DeveloperSearchType, type DiscoveredTool, type Document, type DocumentMetadata, type EndpointFeedbackEndpoint, type EndpointFeedbackRequest, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, type FeedbackMissingContent, type FeedbackRating, type FeedbackResponse, type FeedbackValuableSource, type FindToolsData, type FindToolsOptions, Firecrawl, FirecrawlApp as FirecrawlAppV1, FirecrawlClient, type FirecrawlClientInput, type FirecrawlClientOptions, type Format, type FormatOption, type FormatString, type GetMonitorCheckOptions, type GetPaperOptions, type GitHubScoreBreakdown, type GitHubSearchItem, type GitHubSearchResponse, type HighlightsFormat, type IdMap, type ImageParser, JobTimeoutError, type JsonFormat, type ListMonitorChecksOptions, type ListMonitorsOptions, type LocationConfig$1 as LocationConfig, type MapData, type MapOptions, type MenuAvailability, type MenuImage, type MenuItem, type MenuItemIdentifiers, type MenuMerchant, type MenuPrice, type MenuProfile, type MenuSection, type Monitor, type MonitorCheck, type MonitorCheckDetail, type MonitorCheckPage, type MonitorCrawlTarget, type MonitorCrawlTargetResult, type MonitorEmailNotification, type MonitorEmailRecipientSubscription, type MonitorJsonFieldDiff, type MonitorNotification, type MonitorPageDiff, type MonitorPageJudgment, type MonitorPageSnapshot, type MonitorSchedule, type MonitorScrapeTarget, type MonitorScrapeTargetResult, type MonitorSearchTarget, type MonitorSearchTargetResult, type MonitorSummary, type MonitorTarget, type MonitorTargetResult, type MonitorWebhookConfig, type PDFAction, type PDFParser, type PaginationConfig, type PaperMetadata, type PaperMetadataResponse, type PaperResult, type PaperSignals, type ParseFile, type ParseFileData, type ParseFormat, type ParseFormatOption, type ParseFormatString, type ParseOptions, type Passage, type PdfBlockConfidence, type PdfBlockItem, type PdfPage, type PdfPageBlocks, type PendingApproval, type PressAction, type ProductAvailability, type ProductImage, type ProductPrice, type ProductProfile, type ProductSale, type ProductVariant, type QueryFormat, type QuestionFormat, type QueueStatusResponse$1 as QueueStatusResponse, type ReadPaperResponse, type RedactPIIEntity, type RedactPIIOptions, type RequiresAction, ResearchClient, type ScrapeAction, type ScrapeBrowserDeleteResponse, type ScrapeExecuteRequest, type ScrapeExecuteResponse, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchFeedbackRequest, type SearchGithubOptions, type SearchPapersOptions, type SearchPapersResponse, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type SimilarPapersOptions, type SimilarPapersResponse, type ThreatProtectionOptions, type TokenUsage, type TokenUsageHistoricalPeriod, type TokenUsageHistoricalResponse, type UpdateMonitorRequest, type Viewport, type WaitAction, Watcher, type WatcherOptions, type WebhookConfig, type WriteAction, Firecrawl as default, parseRequiresAction };

package/dist/index.d.ts

@@ -118,6 +118,15 @@ type ActionOption = WaitAction | ScreenshotAction | ClickAction | WriteAction |
 interface AuditMetadata$1 {
     username: string;
 }
+/**
+ * OCR raster images (PNG, JPEG, JPEG 2000, TIFF, GIF, BMP, WebP, AVIF) as
+ * one-page documents. Part of the default parsers list next to "pdf"; takes
+ * no options, so the string "image" is equivalent. Omit it from an explicit
+ * list to keep image URLs failing as unsupported files.
+ */
+type ImageParser = {
+    type: "image";
+};
 type PDFParser = {
     type: "pdf";
     mode?: "fast" | "auto" | "ocr";
@@ -174,7 +183,7 @@ interface ScrapeOptions {
     timeout?: number;
     waitFor?: number;
     mobile?: boolean;
-    parsers?: Array<string | PDFParser>;
+    parsers?: Array<string | PDFParser | ImageParser>;
     actions?: ActionOption[];
     location?: LocationConfig$1;
     skipTlsVerification?: boolean;
@@ -200,8 +209,10 @@ interface ScrapeOptions {
     };
     integration?: string;
     origin?: string;
-    /** Include domain-matched Alexandria contracts for this URL in `tools`. Default off. */
+    /** Include domain-matched Alexandria tools for this URL in `tools`. Default off. */
     domainTools?: boolean;
+    /** Summary by default; compact returns identity and description, full includes contracts. */
+    toolDetail?: "compact" | "summary" | "full";
 }
 type RedactPIIEntity = "PERSON" | "EMAIL" | "PHONE" | "LOCATION" | "FINANCIAL" | "SECRET";
 interface RedactPIIOptions {
@@ -227,8 +238,14 @@ interface RedactPIIOptions {
  * fields you provide replace the team policy's values.
  */
 interface ThreatProtectionOptions {
-    /** "off" disables scanning for this request; "normal" applies the policy. */
-    mode?: "off" | "normal";
+    /**
+     * "off" disables scanning for this request; "manual-only" enforces only the
+     * blacklist / whitelist / blocked TLDs (no provider scan, no scan fee);
+     * "normal" scans with Google Web Risk; "zscaler" classifies through your
+     * organization's Zscaler connection. Enforced teams may raise the mode per
+     * request but never lower it.
+     */
+    mode?: "off" | "manual-only" | "normal" | "zscaler";
     /** Block verdicts at or above this risk score (integer 0-100). */
     riskScoreThreshold?: number;
     /** Exact domains or globs like "*.example.com" to always block (max 1000). */
@@ -246,7 +263,7 @@ interface ParseFile {
     filename: string;
     contentType?: string;
 }
-type ParseOptions = Omit<ScrapeOptions, "formats" | "waitFor" | "mobile" | "actions" | "location" | "maxAge" | "minAge" | "storeInCache" | "lockdown" | "proxy" | "threatProtection"> & {
+type ParseOptions = Omit<ScrapeOptions, "formats" | "waitFor" | "mobile" | "actions" | "location" | "maxAge" | "minAge" | "storeInCache" | "lockdown" | "proxy" | "threatProtection" | "toolDetail"> & {
     formats?: ParseFormatOption[];
     proxy?: "basic" | "auto";
 };
@@ -662,14 +679,15 @@ interface SearchData {
 }
 /** A complete tool contract returned by semantic or contextual discovery. */
 interface DiscoveredTool {
+    next?: AlexandriaCall;
     id?: string;
     provider: string;
     capability: string;
-    name: string;
+    name?: string;
     description: string;
-    creditsCost: number;
-    perRecord: boolean;
-    options: Array<{
+    creditsCost?: number;
+    perRecord?: boolean;
+    options?: Array<{
         name: string;
         type: string;
         required?: boolean;
@@ -797,8 +815,10 @@ interface CategoryOption {
 }
 interface SearchRequest {
     query: string;
-    /** Include domain-matched contracts in tools alongside semantic matches. */
+    /** Include domain-matched tools in tools alongside semantic matches. */
     domainTools?: boolean;
+    /** Compact by default; summary adds metadata, full includes contracts. */
+    toolDetail?: "compact" | "summary" | "full";
     sources?: Array<"web" | "news" | "images" | "alexandria" | {
         type: "web" | "news" | "images" | "alexandria";
     }>;
@@ -822,7 +842,7 @@ interface SearchRequest {
     timeout?: number;
     /** Generate query-relevant highlights for search results. Defaults to true. */
     highlights?: boolean;
-    scrapeOptions?: ScrapeOptions;
+    scrapeOptions?: Omit<ScrapeOptions, "toolDetail">;
     /**
      * Enterprise search options. Use `["zdr"]` for end-to-end Zero Data
      * Retention or `["anon"]` for anonymized search. Must be enabled for
@@ -850,7 +870,7 @@ interface CrawlOptions {
     delay?: number | null;
     maxConcurrency?: number | null;
     webhook?: string | WebhookConfig | null;
-    scrapeOptions?: ScrapeOptions | null;
+    scrapeOptions?: Omit<ScrapeOptions, "toolDetail"> | null;
     regexOnFullURL?: boolean;
     zeroDataRetention?: boolean;
     integration?: string;
@@ -871,7 +891,7 @@ interface CrawlJob {
     data: Document[];
 }
 interface BatchScrapeOptions {
-    options?: ScrapeOptions;
+    options?: Omit<ScrapeOptions, "toolDetail">;
     webhook?: string | WebhookConfig;
     appendToId?: string;
     ignoreInvalidURLs?: boolean;
@@ -1005,14 +1025,14 @@ interface MonitorScrapeTarget {
     id?: string;
     type: "scrape";
     urls: string[];
-    scrapeOptions?: ScrapeOptions;
+    scrapeOptions?: Omit<ScrapeOptions, "toolDetail">;
 }
 interface MonitorCrawlTarget {
     id?: string;
     type: "crawl";
     url: string;
     crawlOptions?: CrawlOptions;
-    scrapeOptions?: ScrapeOptions;
+    scrapeOptions?: Omit<ScrapeOptions, "toolDetail">;
 }
 interface MonitorSearchTarget {
     id?: string;
@@ -3389,4 +3409,4 @@ declare class Firecrawl extends FirecrawlClient {
     get v1(): FirecrawlApp;
 }
 
-export { type ActionOption, type ActiveCrawl, type ActiveCrawlsResponse, type AgentEffort, type AgentExchangeOptions, type AgentExchangeSummary, type AgentListItem, type AgentListOptions, type AgentListResponse, type AgentMode, type AgentOptions$1 as AgentOptions, type AgentResponse, type AgentSnapshotResponse, type AgentStatusResponse, type AgentSuggestion, type AgentThread, type AgentThreadResponse, type AgentThreadRun, type AgentTraceActiveBrowserSession, type AgentTraceAgentFinishedEvent, type AgentTraceAgentIdentity, type AgentTraceAgentRole, type AgentTraceAgentStartedEvent, type AgentTraceArtifactChange, type AgentTraceArtifactUpdatedEvent, type AgentTraceBrowserSessionFinishedEvent, type AgentTraceBrowserSessionStartedEvent, type AgentTraceError, type AgentTraceErrorOccurredEvent, type AgentTraceEvent, type AgentTraceProgressReportedEvent, type AgentTraceReasoningSummaryEvent, type AgentTraceResponse, type AgentTraceRunCancelRequestedEvent, type AgentTraceRunFinishedEvent, type AgentTraceRunStartedEvent, type AgentTraceToolCallFinishedEvent, type AgentTraceToolCallStartedEvent, type AgentWebhookConfig, type AgentWebhookEvent, type AlexandriaCall, type AlexandriaOptions, type AlexandriaScrapeData, type AlexandriaScrapeError, type AlexandriaScrapeRequest, type AlexandriaScrapeResult, type AttributesFormat, type AuditMetadata$1 as AuditMetadata, type BatchScrapeJob, type BatchScrapeOptions, type BatchScrapeResponse$1 as BatchScrapeResponse, type BrandingProfile, type BrowserCreateResponse, type BrowserDeleteResponse, type BrowserExecuteResponse, type BrowserListResponse, type BrowserSession, type CategoryOption, type ChangeTrackingFormat, type ClickAction, type ConcurrencyCheck, type CrawlErrorsResponse$1 as CrawlErrorsResponse, type CrawlJob, type CrawlOptions, type CrawlResponse$1 as CrawlResponse, type CreateMonitorRequest, type CreditUsage, type CreditUsageHistoricalPeriod, type CreditUsageHistoricalResponse, type DeveloperSearchLicenseDisclosure, type DeveloperSearchOptions, type DeveloperSearchPassage, type DeveloperSearchRepoStatus, type DeveloperSearchResponse, type DeveloperSearchResult, type DeveloperSearchSourceStatus, type DeveloperSearchType, type DiscoveredTool, type Document, type DocumentMetadata, type EndpointFeedbackEndpoint, type EndpointFeedbackRequest, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, type FeedbackMissingContent, type FeedbackRating, type FeedbackResponse, type FeedbackValuableSource, type FindToolsData, type FindToolsOptions, Firecrawl, FirecrawlApp as FirecrawlAppV1, FirecrawlClient, type FirecrawlClientInput, type FirecrawlClientOptions, type Format, type FormatOption, type FormatString, type GetMonitorCheckOptions, type GetPaperOptions, type GitHubScoreBreakdown, type GitHubSearchItem, type GitHubSearchResponse, type HighlightsFormat, type IdMap, JobTimeoutError, type JsonFormat, type ListMonitorChecksOptions, type ListMonitorsOptions, type LocationConfig$1 as LocationConfig, type MapData, type MapOptions, type MenuAvailability, type MenuImage, type MenuItem, type MenuItemIdentifiers, type MenuMerchant, type MenuPrice, type MenuProfile, type MenuSection, type Monitor, type MonitorCheck, type MonitorCheckDetail, type MonitorCheckPage, type MonitorCrawlTarget, type MonitorCrawlTargetResult, type MonitorEmailNotification, type MonitorEmailRecipientSubscription, type MonitorJsonFieldDiff, type MonitorNotification, type MonitorPageDiff, type MonitorPageJudgment, type MonitorPageSnapshot, type MonitorSchedule, type MonitorScrapeTarget, type MonitorScrapeTargetResult, type MonitorSearchTarget, type MonitorSearchTargetResult, type MonitorSummary, type MonitorTarget, type MonitorTargetResult, type MonitorWebhookConfig, type PDFAction, type PDFParser, type PaginationConfig, type PaperMetadata, type PaperMetadataResponse, type PaperResult, type PaperSignals, type ParseFile, type ParseFileData, type ParseFormat, type ParseFormatOption, type ParseFormatString, type ParseOptions, type Passage, type PdfBlockConfidence, type PdfBlockItem, type PdfPage, type PdfPageBlocks, type PendingApproval, type PressAction, type ProductAvailability, type ProductImage, type ProductPrice, type ProductProfile, type ProductSale, type ProductVariant, type QueryFormat, type QuestionFormat, type QueueStatusResponse$1 as QueueStatusResponse, type ReadPaperResponse, type RedactPIIEntity, type RedactPIIOptions, type RequiresAction, ResearchClient, type ScrapeAction, type ScrapeBrowserDeleteResponse, type ScrapeExecuteRequest, type ScrapeExecuteResponse, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchFeedbackRequest, type SearchGithubOptions, type SearchPapersOptions, type SearchPapersResponse, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type SimilarPapersOptions, type SimilarPapersResponse, type ThreatProtectionOptions, type TokenUsage, type TokenUsageHistoricalPeriod, type TokenUsageHistoricalResponse, type UpdateMonitorRequest, type Viewport, type WaitAction, Watcher, type WatcherOptions, type WebhookConfig, type WriteAction, Firecrawl as default, parseRequiresAction };
+export { type ActionOption, type ActiveCrawl, type ActiveCrawlsResponse, type AgentEffort, type AgentExchangeOptions, type AgentExchangeSummary, type AgentListItem, type AgentListOptions, type AgentListResponse, type AgentMode, type AgentOptions$1 as AgentOptions, type AgentResponse, type AgentSnapshotResponse, type AgentStatusResponse, type AgentSuggestion, type AgentThread, type AgentThreadResponse, type AgentThreadRun, type AgentTraceActiveBrowserSession, type AgentTraceAgentFinishedEvent, type AgentTraceAgentIdentity, type AgentTraceAgentRole, type AgentTraceAgentStartedEvent, type AgentTraceArtifactChange, type AgentTraceArtifactUpdatedEvent, type AgentTraceBrowserSessionFinishedEvent, type AgentTraceBrowserSessionStartedEvent, type AgentTraceError, type AgentTraceErrorOccurredEvent, type AgentTraceEvent, type AgentTraceProgressReportedEvent, type AgentTraceReasoningSummaryEvent, type AgentTraceResponse, type AgentTraceRunCancelRequestedEvent, type AgentTraceRunFinishedEvent, type AgentTraceRunStartedEvent, type AgentTraceToolCallFinishedEvent, type AgentTraceToolCallStartedEvent, type AgentWebhookConfig, type AgentWebhookEvent, type AlexandriaCall, type AlexandriaOptions, type AlexandriaScrapeData, type AlexandriaScrapeError, type AlexandriaScrapeRequest, type AlexandriaScrapeResult, type AttributesFormat, type AuditMetadata$1 as AuditMetadata, type BatchScrapeJob, type BatchScrapeOptions, type BatchScrapeResponse$1 as BatchScrapeResponse, type BrandingProfile, type BrowserCreateResponse, type BrowserDeleteResponse, type BrowserExecuteResponse, type BrowserListResponse, type BrowserSession, type CategoryOption, type ChangeTrackingFormat, type ClickAction, type ConcurrencyCheck, type CrawlErrorsResponse$1 as CrawlErrorsResponse, type CrawlJob, type CrawlOptions, type CrawlResponse$1 as CrawlResponse, type CreateMonitorRequest, type CreditUsage, type CreditUsageHistoricalPeriod, type CreditUsageHistoricalResponse, type DeveloperSearchLicenseDisclosure, type DeveloperSearchOptions, type DeveloperSearchPassage, type DeveloperSearchRepoStatus, type DeveloperSearchResponse, type DeveloperSearchResult, type DeveloperSearchSourceStatus, type DeveloperSearchType, type DiscoveredTool, type Document, type DocumentMetadata, type EndpointFeedbackEndpoint, type EndpointFeedbackRequest, type ErrorDetails, type ExecuteJavascriptAction, type ExtractResponse$1 as ExtractResponse, type FeedbackMissingContent, type FeedbackRating, type FeedbackResponse, type FeedbackValuableSource, type FindToolsData, type FindToolsOptions, Firecrawl, FirecrawlApp as FirecrawlAppV1, FirecrawlClient, type FirecrawlClientInput, type FirecrawlClientOptions, type Format, type FormatOption, type FormatString, type GetMonitorCheckOptions, type GetPaperOptions, type GitHubScoreBreakdown, type GitHubSearchItem, type GitHubSearchResponse, type HighlightsFormat, type IdMap, type ImageParser, JobTimeoutError, type JsonFormat, type ListMonitorChecksOptions, type ListMonitorsOptions, type LocationConfig$1 as LocationConfig, type MapData, type MapOptions, type MenuAvailability, type MenuImage, type MenuItem, type MenuItemIdentifiers, type MenuMerchant, type MenuPrice, type MenuProfile, type MenuSection, type Monitor, type MonitorCheck, type MonitorCheckDetail, type MonitorCheckPage, type MonitorCrawlTarget, type MonitorCrawlTargetResult, type MonitorEmailNotification, type MonitorEmailRecipientSubscription, type MonitorJsonFieldDiff, type MonitorNotification, type MonitorPageDiff, type MonitorPageJudgment, type MonitorPageSnapshot, type MonitorSchedule, type MonitorScrapeTarget, type MonitorScrapeTargetResult, type MonitorSearchTarget, type MonitorSearchTargetResult, type MonitorSummary, type MonitorTarget, type MonitorTargetResult, type MonitorWebhookConfig, type PDFAction, type PDFParser, type PaginationConfig, type PaperMetadata, type PaperMetadataResponse, type PaperResult, type PaperSignals, type ParseFile, type ParseFileData, type ParseFormat, type ParseFormatOption, type ParseFormatString, type ParseOptions, type Passage, type PdfBlockConfidence, type PdfBlockItem, type PdfPage, type PdfPageBlocks, type PendingApproval, type PressAction, type ProductAvailability, type ProductImage, type ProductPrice, type ProductProfile, type ProductSale, type ProductVariant, type QueryFormat, type QuestionFormat, type QueueStatusResponse$1 as QueueStatusResponse, type ReadPaperResponse, type RedactPIIEntity, type RedactPIIOptions, type RequiresAction, ResearchClient, type ScrapeAction, type ScrapeBrowserDeleteResponse, type ScrapeExecuteRequest, type ScrapeExecuteResponse, type ScrapeOptions, type ScreenshotAction, type ScreenshotFormat, type ScrollAction, SdkError, type SearchData, type SearchFeedbackRequest, type SearchGithubOptions, type SearchPapersOptions, type SearchPapersResponse, type SearchRequest, type SearchResultImages, type SearchResultNews, type SearchResultWeb, type SimilarPapersOptions, type SimilarPapersResponse, type ThreatProtectionOptions, type TokenUsage, type TokenUsageHistoricalPeriod, type TokenUsageHistoricalResponse, type UpdateMonitorRequest, type Viewport, type WaitAction, Watcher, type WatcherOptions, type WebhookConfig, type WriteAction, Firecrawl as default, parseRequiresAction };

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   require_package
-} from "./chunk-OJ4YJQ4J.js";
+} from "./chunk-I2DFXQYR.js";
 
 // src/v2/utils/httpClient.ts
 import axios from "axios";
@@ -647,6 +647,7 @@ function prepareSearchPayload(req) {
   const payload = {
     query: req.query
   };
+  if (req.toolDetail != null) payload.toolDetail = req.toolDetail;
   if (req.domainTools != null) payload.domainTools = req.domainTools;
   if (req.sources) payload.sources = req.sources;
   if (req.categories) payload.categories = req.categories;
@@ -1315,7 +1316,8 @@ function prepareExtractPayload(args) {
     body.threatProtection = args.threatProtection;
   if (args.scrapeOptions) {
     ensureValidScrapeOptions(args.scrapeOptions);
-    body.scrapeOptions = args.scrapeOptions;
+    const { toolDetail, domainTools, ...scrapeOptions } = args.scrapeOptions;
+    body.scrapeOptions = scrapeOptions;
   }
   return body;
 }
@@ -2665,7 +2667,7 @@ var FirecrawlApp = class {
       if (typeof process !== "undefined" && process.env && process.env.npm_package_version) {
         return process.env.npm_package_version;
       }
-      const packageJson = await import("./package-F6O7J2XI.js");
+      const packageJson = await import("./package-V72LKFNW.js");
       return packageJson.default.version;
     } catch (error) {
       const isTest = typeof process !== "undefined" && (process.env.JEST_WORKER_ID != null || false);

package/dist/{package-F6O7J2XI.js → package-V72LKFNW.js}

@@ -1,4 +1,4 @@
 import {
   require_package
-} from "./chunk-OJ4YJQ4J.js";
+} from "./chunk-I2DFXQYR.js";
 export default require_package();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firecrawl",
-  "version": "4.40.0",
+  "version": "4.41.0",
   "description": "JavaScript SDK for the Firecrawl API: web scraping, crawling, web search, and scientific literature search over a research paper index of PubMed, bioRxiv, medRxiv and arXiv abstracts",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/__tests__/unit/v2/extract.unit.test.ts

@@ -3,6 +3,29 @@ import { startExtract } from "../../../v2/methods/extract";
 import type { WebhookConfig } from "../../../v2/types";
 
 describe("v2.extract unit", () => {
+  test("omits discovery options from extract without mutating shared options", async () => {
+    const post = jest
+      .fn()
+      .mockResolvedValue({ status: 200, data: { id: "extract-job" } });
+    const scrapeOptions = {
+      toolDetail: "compact" as const,
+      domainTools: true,
+      onlyMainContent: true,
+    };
+    await startExtract({ post } as any, {
+      urls: ["https://example.com"],
+      scrapeOptions,
+    });
+    expect(post).toHaveBeenCalledWith("/v2/extract", {
+      urls: ["https://example.com"],
+      scrapeOptions: { onlyMainContent: true },
+    });
+    expect(scrapeOptions).toEqual({
+      toolDetail: "compact",
+      domainTools: true,
+      onlyMainContent: true,
+    });
+  });
   test("startExtract forwards string webhook in request payload", async () => {
     const post = jest.fn().mockResolvedValue({
       status: 200,

package/src/__tests__/unit/v2/tools.unit.test.ts

@@ -1,4 +1,12 @@
-import { afterAll, beforeAll, beforeEach, describe, expect, jest, test } from "@jest/globals";
+import {
+  afterAll,
+  beforeAll,
+  beforeEach,
+  describe,
+  expect,
+  jest,
+  test,
+} from "@jest/globals";
 import { createServer, type Server } from "node:http";
 import { FirecrawlClient } from "../../../v2/client";
 
@@ -52,6 +60,13 @@ const next = {
   capability: "find-tools",
   options: { providers: ["particle"], level: "tools" },
 };
+const compactTools = [tool, productionTool].map(
+  ({ provider, capability, description }) => ({
+    provider,
+    capability,
+    description,
+  }),
+);
 let server: Server;
 let client: FirecrawlClient;
 const sent: Array<{ body: any; id: string | undefined }> = [];
@@ -76,10 +91,20 @@ beforeAll(async () => {
           warning: "Example warning",
           data: {
             web: [{ url: "https://podcasts.apple.com" }],
-            tools: [tool, productionTool],
+            tools:
+              body.toolDetail === "compact"
+                ? compactTools
+                : [tool, productionTool],
           },
         }),
       );
+    if (req.url === "/v2/scrape" && body.url)
+      return res.end(
+        JSON.stringify({
+          success: true,
+          data: { markdown: "Example", tools: compactTools },
+        }),
+      );
     if (body.alexandria[0].provider === "retry" && attempts++ === 0) {
       res.statusCode = 502;
       return res.end("{}");
@@ -150,6 +175,26 @@ afterAll(async () => {
 });
 
 describe("Alexandria contracts and execution", () => {
+  test.each(["compact", "summary", "full"] as const)(
+    "forwards %s discovery detail",
+    async (toolDetail) => {
+      const result = await client.search("records", { toolDetail });
+      if (toolDetail === "compact") expect(result.tools).toEqual(compactTools);
+      expect(sent.at(-1)?.body).toMatchObject({ toolDetail });
+    },
+  );
+  test("URL scrape forwards compact detail and preserves tools", async () => {
+    const result = await client.scrape("https://example.com", {
+      domainTools: true,
+      toolDetail: "compact",
+    });
+    expect(sent.at(-1)?.body).toMatchObject({
+      url: "https://example.com",
+      domainTools: true,
+      toolDetail: "compact",
+    });
+    expect(result.tools).toEqual(compactTools);
+  });
   test("returns complete unified tools and warning beside web results", async () => {
     const result = await client.search("podcasts", {
       sources: ["web", { type: "alexandria" }],
@@ -226,15 +271,27 @@ describe("Alexandria contracts and execution", () => {
   });
 });
 
-
-test.each([[undefined, 80000], [1000, 31000], [100000, 80000]])(
+test.each([
+  [undefined, 80000],
+  [1000, 31000],
+  [100000, 80000],
+])(
   "Alexandria timeout %s allows response delivery (%s ms)",
   async (timeout, timeoutMs) => {
-    const http = { post: jest.fn(async () => ({ status: 200, data: {
-      success: true, data: { alexandria: [], creditsCost: 0 },
-    } })) };
+    const http = {
+      post: jest.fn(async () => ({
+        status: 200,
+        data: {
+          success: true,
+          data: { alexandria: [], creditsCost: 0 },
+        },
+      })),
+    };
     await scrapeAlexandria(http as any, [next], { timeout });
-    expect(http.post).toHaveBeenCalledWith("/v2/scrape", expect.anything(),
-      expect.objectContaining({ timeoutMs }));
+    expect(http.post).toHaveBeenCalledWith(
+      "/v2/scrape",
+      expect.anything(),
+      expect.objectContaining({ timeoutMs }),
+    );
   },
 );

package/src/v2/methods/extract.ts

@@ -40,7 +40,8 @@ function prepareExtractPayload(args: {
     body.threatProtection = args.threatProtection;
   if (args.scrapeOptions) {
     ensureValidScrapeOptions(args.scrapeOptions);
-    body.scrapeOptions = args.scrapeOptions;
+    const { toolDetail, domainTools, ...scrapeOptions } = args.scrapeOptions;
+    body.scrapeOptions = scrapeOptions;
   }
   return body;
 }

package/src/v2/methods/search.ts

@@ -27,6 +27,7 @@ function prepareSearchPayload(req: SearchRequest): Record<string, unknown> {
   const payload: Record<string, unknown> = {
     query: req.query,
   };
+  if (req.toolDetail != null) payload.toolDetail = req.toolDetail;
   if (req.domainTools != null) payload.domainTools = req.domainTools;
   if (req.sources) payload.sources = req.sources;
   if (req.categories) payload.categories = req.categories;

package/src/v2/types.ts

@@ -188,6 +188,16 @@ export interface AuditMetadata {
   username: string;
 }
 
+/**
+ * OCR raster images (PNG, JPEG, JPEG 2000, TIFF, GIF, BMP, WebP, AVIF) as
+ * one-page documents. Part of the default parsers list next to "pdf"; takes
+ * no options, so the string "image" is equivalent. Omit it from an explicit
+ * list to keep image URLs failing as unsupported files.
+ */
+export type ImageParser = {
+  type: "image";
+};
+
 export type PDFParser = {
   type: "pdf";
   mode?: "fast" | "auto" | "ocr";
@@ -249,7 +259,7 @@ export interface ScrapeOptions {
   timeout?: number;
   waitFor?: number;
   mobile?: boolean;
-  parsers?: Array<string | PDFParser>;
+  parsers?: Array<string | PDFParser | ImageParser>;
   actions?: ActionOption[];
   location?: LocationConfig;
   skipTlsVerification?: boolean;
@@ -275,8 +285,10 @@ export interface ScrapeOptions {
   };
   integration?: string;
   origin?: string;
-  /** Include domain-matched Alexandria contracts for this URL in `tools`. Default off. */
+  /** Include domain-matched Alexandria tools for this URL in `tools`. Default off. */
   domainTools?: boolean;
+  /** Summary by default; compact returns identity and description, full includes contracts. */
+  toolDetail?: "compact" | "summary" | "full";
 }
 
 export type RedactPIIEntity =
@@ -306,8 +318,14 @@ export interface RedactPIIOptions {
  * fields you provide replace the team policy's values.
  */
 export interface ThreatProtectionOptions {
-  /** "off" disables scanning for this request; "normal" applies the policy. */
-  mode?: "off" | "normal";
+  /**
+   * "off" disables scanning for this request; "manual-only" enforces only the
+   * blacklist / whitelist / blocked TLDs (no provider scan, no scan fee);
+   * "normal" scans with Google Web Risk; "zscaler" classifies through your
+   * organization's Zscaler connection. Enforced teams may raise the mode per
+   * request but never lower it.
+   */
+  mode?: "off" | "manual-only" | "normal" | "zscaler";
   /** Block verdicts at or above this risk score (integer 0-100). */
   riskScoreThreshold?: number;
   /** Exact domains or globs like "*.example.com" to always block (max 1000). */
@@ -342,6 +360,7 @@ export type ParseOptions = Omit<
   | "lockdown"
   | "proxy"
   | "threatProtection"
+  | "toolDetail"
 > & {
   formats?: ParseFormatOption[];
   proxy?: "basic" | "auto";
@@ -810,14 +829,15 @@ export interface SearchData {
 
 /** A complete tool contract returned by semantic or contextual discovery. */
 export interface DiscoveredTool {
+  next?: AlexandriaCall;
   id?: string;
   provider: string;
   capability: string;
-  name: string;
+  name?: string;
   description: string;
-  creditsCost: number;
-  perRecord: boolean;
-  options: Array<{
+  creditsCost?: number;
+  perRecord?: boolean;
+  options?: Array<{
     name: string;
     type: string;
     required?: boolean;
@@ -954,8 +974,10 @@ export interface CategoryOption {
 
 export interface SearchRequest {
   query: string;
-  /** Include domain-matched contracts in tools alongside semantic matches. */
+  /** Include domain-matched tools in tools alongside semantic matches. */
   domainTools?: boolean;
+  /** Compact by default; summary adds metadata, full includes contracts. */
+  toolDetail?: "compact" | "summary" | "full";
   sources?: Array<
     "web" | "news" | "images" | "alexandria"
     | { type: "web" | "news" | "images" | "alexandria" }
@@ -982,7 +1004,7 @@ export interface SearchRequest {
   timeout?: number; // ms
   /** Generate query-relevant highlights for search results. Defaults to true. */
   highlights?: boolean;
-  scrapeOptions?: ScrapeOptions;
+  scrapeOptions?: Omit<ScrapeOptions, "toolDetail">;
   /**
    * Enterprise search options. Use `["zdr"]` for end-to-end Zero Data
    * Retention or `["anon"]` for anonymized search. Must be enabled for
@@ -1011,7 +1033,7 @@ export interface CrawlOptions {
   delay?: number | null;
   maxConcurrency?: number | null;
   webhook?: string | WebhookConfig | null;
-  scrapeOptions?: ScrapeOptions | null;
+  scrapeOptions?: Omit<ScrapeOptions, "toolDetail"> | null;
   regexOnFullURL?: boolean;
   zeroDataRetention?: boolean;
   integration?: string;
@@ -1035,7 +1057,7 @@ export interface CrawlJob {
 }
 
 export interface BatchScrapeOptions {
-  options?: ScrapeOptions;
+  options?: Omit<ScrapeOptions, "toolDetail">;
   webhook?: string | WebhookConfig;
   appendToId?: string;
   ignoreInvalidURLs?: boolean;
@@ -1185,7 +1207,7 @@ export interface MonitorScrapeTarget {
   id?: string;
   type: "scrape";
   urls: string[];
-  scrapeOptions?: ScrapeOptions;
+  scrapeOptions?: Omit<ScrapeOptions, "toolDetail">;
 }
 
 export interface MonitorCrawlTarget {
@@ -1193,7 +1215,7 @@ export interface MonitorCrawlTarget {
   type: "crawl";
   url: string;
   crawlOptions?: CrawlOptions;
-  scrapeOptions?: ScrapeOptions;
+  scrapeOptions?: Omit<ScrapeOptions, "toolDetail">;
 }
 
 export interface MonitorSearchTarget {