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-171b4c39eb26210aad8afd74d63d620bf45f7e0b7f2de3938c7239741ea3f2f4.yml
-openapi_spec_hash: 752c05fc817dc766061bd4357bd327ba
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-633097a61ae4e029434e5af07efa3017301fe8b391c27ada3eb68b61d798ef33.yml
+openapi_spec_hash: 051b08a4c6530546d520aa7ec18f8123
 config_hash: 7ec4851ee8d93177947e95df5ae897b5

src/ServiceContracts/WebContract.php

@@ -290,6 +290,7 @@ public function webScrapeHTML(
      * @api
      *
      * @param string $url Page URL to inspect. Must include http:// or https://.
+     * @param bool $dedupe When true, visually duplicate images are removed: every image is loaded and perceptually hashed, and only the highest-resolution copy of each duplicate group is kept. Images that cannot be downloaded or hashed are kept. Default: false.
      * @param Enrichment|EnrichmentShape $enrichment optional per-image processing, sent as deep-object query params such as enrichment[resolution]=true
      * @param array<string,string> $headers Optional outbound HTTP headers forwarded only to the target URL, sent as deep-object query params such as headers[X-Custom]=value. When provided, caching is bypassed: the result is neither read from nor written to cache.
      * @param int $maxAgeMs Reuse a cached result this many milliseconds old or newer. Default: 86400000 (1 day). Set to 0 to bypass cache. Maximum: 2592000000 (30 days).
@@ -301,6 +302,7 @@ public function webScrapeHTML(
      */
     public function webScrapeImages(
         string $url,
+        bool $dedupe = false,
         Enrichment|array|null $enrichment = null,
         ?array $headers = null,
         int $maxAgeMs = 86400000,

src/Services/WebRawService.php

@@ -405,6 +405,7 @@ public function webScrapeHTML(
      *
      * @param array{
      *   url: string,
+     *   dedupe?: bool,
      *   enrichment?: Enrichment|EnrichmentShape,
      *   headers?: array<string,string>,
      *   maxAgeMs?: int,

src/Services/WebService.php

@@ -481,6 +481,7 @@ public function webScrapeHTML(
      * Extract image assets from a web page, including standard URLs, inline SVGs, data URIs, responsive image sources, metadata, CSS backgrounds, video posters, and embeds. The base request costs 1 credit. When enrichment is enabled, the entire call costs 5 credits.
      *
      * @param string $url Page URL to inspect. Must include http:// or https://.
+     * @param bool $dedupe When true, visually duplicate images are removed: every image is loaded and perceptually hashed, and only the highest-resolution copy of each duplicate group is kept. Images that cannot be downloaded or hashed are kept. Default: false.
      * @param Enrichment|EnrichmentShape $enrichment optional per-image processing, sent as deep-object query params such as enrichment[resolution]=true
      * @param array<string,string> $headers Optional outbound HTTP headers forwarded only to the target URL, sent as deep-object query params such as headers[X-Custom]=value. When provided, caching is bypassed: the result is neither read from nor written to cache.
      * @param int $maxAgeMs Reuse a cached result this many milliseconds old or newer. Default: 86400000 (1 day). Set to 0 to bypass cache. Maximum: 2592000000 (30 days).
@@ -492,6 +493,7 @@ public function webScrapeHTML(
      */
     public function webScrapeImages(
         string $url,
+        bool $dedupe = false,
         Enrichment|array|null $enrichment = null,
         ?array $headers = null,
         int $maxAgeMs = 86400000,
@@ -502,6 +504,7 @@ public function webScrapeImages(
         $params = Util::removeNulls(
             [
                 'url' => $url,
+                'dedupe' => $dedupe,
                 'enrichment' => $enrichment,
                 'headers' => $headers,
                 'maxAgeMs' => $maxAgeMs,

src/Web/WebWebScrapeImagesParams.php

@@ -20,6 +20,7 @@
  *
  * @phpstan-type WebWebScrapeImagesParamsShape = array{
  *   url: string,
+ *   dedupe?: bool|null,
  *   enrichment?: null|Enrichment|EnrichmentShape,
  *   headers?: array<string,string>|null,
  *   maxAgeMs?: int|null,
@@ -39,6 +40,12 @@ final class WebWebScrapeImagesParams implements BaseModel
     #[Required]
     public string $url;
 
+    /**
+     * When true, visually duplicate images are removed: every image is loaded and perceptually hashed, and only the highest-resolution copy of each duplicate group is kept. Images that cannot be downloaded or hashed are kept. Default: false.
+     */
+    #[Optional]
+    public ?bool $dedupe;
+
     /**
      * Optional per-image processing, sent as deep-object query params such as enrichment[resolution]=true.
      */
@@ -100,6 +107,7 @@ public function __construct()
      */
     public static function with(
         string $url,
+        ?bool $dedupe = null,
         Enrichment|array|null $enrichment = null,
         ?array $headers = null,
         ?int $maxAgeMs = null,
@@ -110,6 +118,7 @@ public static function with(
 
         $self['url'] = $url;
 
+        null !== $dedupe && $self['dedupe'] = $dedupe;
         null !== $enrichment && $self['enrichment'] = $enrichment;
         null !== $headers && $self['headers'] = $headers;
         null !== $maxAgeMs && $self['maxAgeMs'] = $maxAgeMs;
@@ -130,6 +139,17 @@ public function withURL(string $url): self
         return $self;
     }
 
+    /**
+     * When true, visually duplicate images are removed: every image is loaded and perceptually hashed, and only the highest-resolution copy of each duplicate group is kept. Images that cannot be downloaded or hashed are kept. Default: false.
+     */
+    public function withDedupe(bool $dedupe): self
+    {
+        $self = clone $this;
+        $self['dedupe'] = $dedupe;
+
+        return $self;
+    }
+
     /**
      * Optional per-image processing, sent as deep-object query params such as enrichment[resolution]=true.
      *

tests/Services/WebTest.php

@@ -314,6 +314,7 @@ public function testWebScrapeImagesWithOptionalParams(): void
 
         $result = $this->client->web->webScrapeImages(
             url: 'https://example.com',
+            dedupe: true,
             enrichment: [
                 'classification' => true,
                 'hostedURL' => true,