feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 36
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-d71b08e421ccdda9a2754c307e97df0ee7444926306a00624dca2bc7d56548ac.yml
-openapi_spec_hash: ebfbed20b5837ccf8db8bb40ab23baac
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-c7625b4a7beb9e7d9827f3b836e6539cbc5f26b6754891d4352716e38cdecd73.yml
+openapi_spec_hash: cbee9cf164cc6704a6febb4d9737e83e
 config_hash: 7ec4851ee8d93177947e95df5ae897b5

src/Web/WebExtractResponse/Metadata.php

@@ -11,6 +11,7 @@
 /**
  * @phpstan-type MetadataShape = array{
  *   maxCrawlDepth: int,
+ *   numBlocked: int,
  *   numFailed: int,
  *   numSkipped: int,
  *   numSucceeded: int,
@@ -25,6 +26,12 @@ final class Metadata implements BaseModel
     #[Required]
     public int $maxCrawlDepth;
 
+    /**
+     * Number of crawled pages excluded because they were anti-bot challenges, error pages, or parked-domain placeholders.
+     */
+    #[Required]
+    public int $numBlocked;
+
     #[Required]
     public int $numFailed;
 
@@ -44,6 +51,7 @@ final class Metadata implements BaseModel
      * ```
      * Metadata::with(
      *   maxCrawlDepth: ...,
+     *   numBlocked: ...,
      *   numFailed: ...,
      *   numSkipped: ...,
      *   numSucceeded: ...,
@@ -56,6 +64,7 @@ final class Metadata implements BaseModel
      * ```
      * (new Metadata)
      *   ->withMaxCrawlDepth(...)
+     *   ->withNumBlocked(...)
      *   ->withNumFailed(...)
      *   ->withNumSkipped(...)
      *   ->withNumSucceeded(...)
@@ -74,6 +83,7 @@ public function __construct()
      */
     public static function with(
         int $maxCrawlDepth,
+        int $numBlocked,
         int $numFailed,
         int $numSkipped,
         int $numSucceeded,
@@ -82,6 +92,7 @@ public static function with(
         $self = new self;
 
         $self['maxCrawlDepth'] = $maxCrawlDepth;
+        $self['numBlocked'] = $numBlocked;
         $self['numFailed'] = $numFailed;
         $self['numSkipped'] = $numSkipped;
         $self['numSucceeded'] = $numSucceeded;
@@ -98,6 +109,17 @@ public function withMaxCrawlDepth(int $maxCrawlDepth): self
         return $self;
     }
 
+    /**
+     * Number of crawled pages excluded because they were anti-bot challenges, error pages, or parked-domain placeholders.
+     */
+    public function withNumBlocked(int $numBlocked): self
+    {
+        $self = clone $this;
+        $self['numBlocked'] = $numBlocked;
+
+        return $self;
+    }
+
     public function withNumFailed(int $numFailed): self
     {
         $self = clone $this;