firecrawl 4.1.0__tar.gz → 4.2.0__tar.gz

{firecrawl-4.1.0 → firecrawl-4.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firecrawl
-Version: 4.1.0
+Version: 4.2.0
 Summary: Python SDK for Firecrawl API
 Home-page: https://github.com/firecrawl/firecrawl
 Author: Mendable.ai

{firecrawl-4.1.0 → firecrawl-4.2.0}/firecrawl/__init__.py

@@ -17,7 +17,7 @@ from .v1 import (
     V1ChangeTrackingOptions,
 )
 
-__version__ = "4.1.0"
+__version__ = "4.2.0"
 
 # Define the logger for the Firecrawl project
 logger: logging.Logger = logging.getLogger("firecrawl")

{firecrawl-4.1.0 → firecrawl-4.2.0}/firecrawl/v2/client.py

@@ -727,6 +727,10 @@ class FirecrawlClient:
         """Get recent token usage metrics (v2)."""
         return usage_methods.get_token_usage(self.http_client)
 
+    def get_queue_status(self):
+        """Get metrics about the team's scrape queue."""
+        return usage_methods.get_queue_status(self.http_client)
+
     def watcher(
         self,
         job_id: str,

{firecrawl-4.1.0 → firecrawl-4.2.0}/firecrawl/v2/methods/usage.py

@@ -1,5 +1,5 @@
 from ..utils import HttpClient, handle_response_error
-from ..types import ConcurrencyCheck, CreditUsage, TokenUsage
+from ..types import ConcurrencyCheck, CreditUsage, QueueStatusResponse, TokenUsage
 
 
 def get_concurrency(client: HttpClient) -> ConcurrencyCheck:
@@ -39,3 +39,18 @@ def get_token_usage(client: HttpClient) -> TokenUsage:
         remaining_tokens=data.get("remainingTokens", 0)
     )
 
+def get_queue_status(client: HttpClient) -> QueueStatusResponse:
+    resp = client.get("/v2/team/queue-status")
+    if not resp.ok:
+        handle_response_error(resp, "get queue status")
+    body = resp.json()
+    if not body.get("success"):
+        raise Exception(body.get("error", "Unknown error"))
+    data = body.get("data", body)
+    return QueueStatusResponse(
+        jobs_in_queue=data.get("jobsInQueue", 0),
+        active_jobs_in_queue=data.get("activeJobsInQueue", 0),
+        waiting_jobs_in_queue=data.get("waitingJobsInQueue", 0),
+        max_concurrency=data.get("maxConcurrency", 0),
+        most_recent_success=data.get("mostRecentSuccess", None),
+    )

{firecrawl-4.1.0 → firecrawl-4.2.0}/firecrawl/v2/types.py

@@ -485,6 +485,14 @@ class TokenUsage(BaseModel):
     """Recent token usage metrics (if available)."""
     remaining_tokens: int
 
+class QueueStatusResponse(BaseModel):
+    """Metrics about the team's scrape queue."""
+    jobs_in_queue: int
+    active_jobs_in_queue: int
+    waiting_jobs_in_queue: int
+    max_concurrency: int
+    most_recent_success: Optional[datetime] = None
+
 # Action types
 class WaitAction(BaseModel):
     """Wait action to perform during scraping."""
@@ -599,25 +607,7 @@ class SearchRequest(BaseModel):
         
         return normalized_categories
 
-    @field_validator('parsers')
-    @classmethod
-    def validate_parsers(cls, v):
-        """Validate and normalize parsers input."""
-        if v is None:
-            return v
-        
-        normalized_parsers = []
-        for parser in v:
-            if isinstance(parser, str):
-                normalized_parsers.append(parser)
-            elif isinstance(parser, dict):
-                normalized_parsers.append(PDFParser(**parser))
-            elif isinstance(parser, PDFParser):
-                normalized_parsers.append(parser)
-            else:
-                raise ValueError(f"Invalid parser format: {parser}")
-        
-        return normalized_parsers
+    # NOTE: parsers validation does not belong on SearchRequest; it is part of ScrapeOptions.
 
 class LinkResult(BaseModel):
     """A generic link result with optional metadata (used by search and map)."""

{firecrawl-4.1.0 → firecrawl-4.2.0}/firecrawl.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firecrawl
-Version: 4.1.0
+Version: 4.2.0
 Summary: Python SDK for Firecrawl API
 Home-page: https://github.com/firecrawl/firecrawl
 Author: Mendable.ai