context.dev 1.12.0 → 1.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eca40d9a8e0ee6b1b327d64f6f6c87c3a8afe437e8e6a2043697d9331e6d5da1
-  data.tar.gz: 58e54fecfb39594e74ec0a0cbfd719afbefd1faf6cc389b8e5e8d30ff77e60bc
+  metadata.gz: 836fab0c1e0cb715edaeaf7f7206d4a0be107d9a8971ff6afba657ba13e8bf49
+  data.tar.gz: 9ece48b1e97a2d806adb38a9c16df4d94cba3448f892435b8096904fd27f513d
 SHA512:
-  metadata.gz: e22c565c16b51903bccd960e241b810c80a841c0b2033746f5ed135e4d5ad7a85ea4ed1925e28bd2012ffb31c8c1504b78b24bb40480e0578a3f515feda8484b
-  data.tar.gz: 933ef990401d164b31596333372e7093e89eed80659f8ea1be7483467db03757d2daa03dac8061ce7b7961059472ef1298d50f6b407ae0f217677e0297dad9f4
+  metadata.gz: 0d5018e385aa2664e995f451b8e020894d98af98ec9f06a8962d11da56e43c448cbe5c184a24d5a9310d5cd0b8f6c43009829809a75de0770749388fbd06a012
+  data.tar.gz: 01ab4b2ef6367f3d5c5a5e71d98a42f6d4db0fc17eb850c061e16355056c53dcca45b58ee836fadacd9ac2033e95ef0875aaaedea715d58c5d66cdae35956eba

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 1.14.0 (2026-05-06)
+
+Full Changelog: [v1.13.0...v1.14.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.13.0...v1.14.0)
+
+### Features
+
+* **api:** api update ([58cb73a](https://github.com/context-dot-dev/context-ruby-sdk/commit/58cb73a109e20f296f6a5f256a94d690b1203f70))
+
+## 1.13.0 (2026-05-05)
+
+Full Changelog: [v1.12.0...v1.13.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.12.0...v1.13.0)
+
+### Features
+
+* **api:** manual updates ([1017ae4](https://github.com/context-dot-dev/context-ruby-sdk/commit/1017ae4d595beb2e5b466326a4db19c78ce6db51))
+
 ## 1.12.0 (2026-05-01)
 
 Full Changelog: [v1.11.0...v1.12.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.11.0...v1.12.0)

data/README.md

@@ -8,8 +8,8 @@ It is generated with [Stainless](https://www.stainless.com/).
 
 Use the Context Dev MCP Server to enable AI assistants to interact with this API, allowing them to explore endpoints, make test requests, and use documentation to help integrate this SDK into your application.
 
-[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=context-dev-mcp&config=eyJuYW1lIjoiY29udGV4dC1kZXYtbWNwIiwidHJhbnNwb3J0IjoiaHR0cCIsInVybCI6Imh0dHBzOi8vY29udGV4dC1kZXYuc3RsbWNwLmNvbSIsImhlYWRlcnMiOnsieC1jb250ZXh0LWRldi1hcGkta2V5IjoiTXkgQVBJIEtleSJ9fQ)
-[![Install in VS Code](https://img.shields.io/badge/_-Add_to_VS_Code-blue?style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCA0MCA0MCI+PHBhdGggZmlsbD0iI0VFRSIgZmlsbC1ydWxlPSJldmVub2RkIiBkPSJNMzAuMjM1IDM5Ljg4NGEyLjQ5MSAyLjQ5MSAwIDAgMS0xLjc4MS0uNzNMMTIuNyAyNC43OGwtMy40NiAyLjYyNC0zLjQwNiAyLjU4MmExLjY2NSAxLjY2NSAwIDAgMS0xLjA4Mi4zMzggMS42NjQgMS42NjQgMCAwIDEtMS4wNDYtLjQzMWwtMi4yLTJhMS42NjYgMS42NjYgMCAwIDEgMC0yLjQ2M0w3LjQ1OCAyMCA0LjY3IDE3LjQ1MyAxLjUwNyAxNC41N2ExLjY2NSAxLjY2NSAwIDAgMSAwLTIuNDYzbDIuMi0yYTEuNjY1IDEuNjY1IDAgMCAxIDIuMTMtLjA5N2w2Ljg2MyA1LjIwOUwyOC40NTIuODQ0YTIuNDg4IDIuNDg4IDAgMCAxIDEuODQxLS43MjljLjM1MS4wMDkuNjk5LjA5MSAxLjAxOS4yNDVsOC4yMzYgMy45NjFhMi41IDIuNSAwIDAgMSAxLjQxNSAyLjI1M3YuMDk5LS4wNDVWMzMuMzd2LS4wNDUuMDk1YTIuNTAxIDIuNTAxIDAgMCAxLTEuNDE2IDIuMjU3bC04LjIzNSAzLjk2MWEyLjQ5MiAyLjQ5MiAwIDAgMS0xLjA3Ny4yNDZabS43MTYtMjguOTQ3LTExLjk0OCA5LjA2MiAxMS45NTIgOS4wNjUtLjAwNC0xOC4xMjdaIi8+PC9zdmc+)](https://vscode.stainless.com/mcp/%7B%22name%22%3A%22context-dev-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fcontext-dev.stlmcp.com%22%2C%22headers%22%3A%7B%22x-context-dev-api-key%22%3A%22My%20API%20Key%22%7D%7D)
+[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=context.dev-mcp&config=eyJuYW1lIjoiY29udGV4dC5kZXYtbWNwIiwidHJhbnNwb3J0IjoiaHR0cCIsInVybCI6Imh0dHBzOi8vY29udGV4dC1kZXYuc3RsbWNwLmNvbSIsImhlYWRlcnMiOnsieC1jb250ZXh0LWRldi1hcGkta2V5IjoiTXkgQVBJIEtleSJ9fQ)
+[![Install in VS Code](https://img.shields.io/badge/_-Add_to_VS_Code-blue?style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCA0MCA0MCI+PHBhdGggZmlsbD0iI0VFRSIgZmlsbC1ydWxlPSJldmVub2RkIiBkPSJNMzAuMjM1IDM5Ljg4NGEyLjQ5MSAyLjQ5MSAwIDAgMS0xLjc4MS0uNzNMMTIuNyAyNC43OGwtMy40NiAyLjYyNC0zLjQwNiAyLjU4MmExLjY2NSAxLjY2NSAwIDAgMS0xLjA4Mi4zMzggMS42NjQgMS42NjQgMCAwIDEtMS4wNDYtLjQzMWwtMi4yLTJhMS42NjYgMS42NjYgMCAwIDEgMC0yLjQ2M0w3LjQ1OCAyMCA0LjY3IDE3LjQ1MyAxLjUwNyAxNC41N2ExLjY2NSAxLjY2NSAwIDAgMSAwLTIuNDYzbDIuMi0yYTEuNjY1IDEuNjY1IDAgMCAxIDIuMTMtLjA5N2w2Ljg2MyA1LjIwOUwyOC40NTIuODQ0YTIuNDg4IDIuNDg4IDAgMCAxIDEuODQxLS43MjljLjM1MS4wMDkuNjk5LjA5MSAxLjAxOS4yNDVsOC4yMzYgMy45NjFhMi41IDIuNSAwIDAgMSAxLjQxNSAyLjI1M3YuMDk5LS4wNDVWMzMuMzd2LS4wNDUuMDk1YTIuNTAxIDIuNTAxIDAgMCAxLTEuNDE2IDIuMjU3bC04LjIzNSAzLjk2MWEyLjQ5MiAyLjQ5MiAwIDAgMS0xLjA3Ny4yNDZabS43MTYtMjguOTQ3LTExLjk0OCA5LjA2MiAxMS45NTIgOS4wNjUtLjAwNC0xOC4xMjdaIi8+PC9zdmc+)](https://vscode.stainless.com/mcp/%7B%22name%22%3A%22context.dev-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fcontext-dev.stlmcp.com%22%2C%22headers%22%3A%7B%22x-context-dev-api-key%22%3A%22My%20API%20Key%22%7D%7D)
 
 > Note: You may need to set environment variables in your MCP client.
 
@@ -26,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "context.dev", "~> 1.12.0"
+gem "context.dev", "~> 1.14.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/context_dev/models/web_web_scrape_images_params.rb

@@ -8,15 +8,78 @@ module ContextDev
       include ContextDev::Internal::Type::RequestParameters
 
       # @!attribute url
-      #   Full URL to scrape images from (must include http:// or https:// protocol)
+      #   Page URL to inspect. Must include http:// or https://.
       #
       #   @return [String]
       required :url, String
 
-      # @!method initialize(url:, request_options: {})
-      #   @param url [String] Full URL to scrape images from (must include http:// or https:// protocol)
+      # @!attribute enrichment
+      #   Optional per-image processing, sent as deep-object query params such as
+      #   enrichment[resolution]=true.
+      #
+      #   @return [ContextDev::Models::WebWebScrapeImagesParams::Enrichment, nil]
+      optional :enrichment, -> { ContextDev::WebWebScrapeImagesParams::Enrichment }
+
+      # @!attribute max_age_ms
+      #   Reuse a cached result this many milliseconds old or newer. Default: 86400000 (1
+      #   day). Set to 0 to bypass cache. Maximum: 2592000000 (30 days).
+      #
+      #   @return [Integer, nil]
+      optional :max_age_ms, Integer
+
+      # @!method initialize(url:, enrichment: nil, max_age_ms: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::WebWebScrapeImagesParams} for more details.
+      #
+      #   @param url [String] Page URL to inspect. Must include http:// or https://.
+      #
+      #   @param enrichment [ContextDev::Models::WebWebScrapeImagesParams::Enrichment] Optional per-image processing, sent as deep-object query params such as enrichme
+      #
+      #   @param max_age_ms [Integer] Reuse a cached result this many milliseconds old or newer. Default: 86400000 (1
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
+
+      class Enrichment < ContextDev::Internal::Type::BaseModel
+        # @!attribute classification
+        #   Classify each image by visual asset type.
+        #
+        #   @return [Boolean, nil]
+        optional :classification, ContextDev::Internal::Type::Boolean
+
+        # @!attribute hosted_url
+        #   Host materializable images on the Brand.dev CDN and return their URL and MIME
+        #   type.
+        #
+        #   @return [Boolean, nil]
+        optional :hosted_url, ContextDev::Internal::Type::Boolean, api_name: :hostedUrl
+
+        # @!attribute max_time_per_ms
+        #   Per-image enrichment timeout in milliseconds. Default: 6000. Maximum: 60000.
+        #
+        #   @return [Integer, nil]
+        optional :max_time_per_ms, Integer, api_name: :maxTimePerMs
+
+        # @!attribute resolution
+        #   Measure image width and height when possible.
+        #
+        #   @return [Boolean, nil]
+        optional :resolution, ContextDev::Internal::Type::Boolean
+
+        # @!method initialize(classification: nil, hosted_url: nil, max_time_per_ms: nil, resolution: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {ContextDev::Models::WebWebScrapeImagesParams::Enrichment} for more details.
+        #
+        #   Optional per-image processing, sent as deep-object query params such as
+        #   enrichment[resolution]=true.
+        #
+        #   @param classification [Boolean] Classify each image by visual asset type.
+        #
+        #   @param hosted_url [Boolean] Host materializable images on the Brand.dev CDN and return their URL and MIME ty
+        #
+        #   @param max_time_per_ms [Integer] Per-image enrichment timeout in milliseconds. Default: 6000. Maximum: 60000.
+        #
+        #   @param resolution [Boolean] Measure image width and height when possible.
+      end
     end
   end
 end

data/lib/context_dev/models/web_web_scrape_images_response.rb

@@ -5,66 +5,74 @@ module ContextDev
     # @see ContextDev::Resources::Web#web_scrape_images
     class WebWebScrapeImagesResponse < ContextDev::Internal::Type::BaseModel
       # @!attribute images
-      #   Array of scraped images
+      #   Images found on the page.
       #
       #   @return [Array<ContextDev::Models::WebWebScrapeImagesResponse::Image>]
       required :images,
                -> { ContextDev::Internal::Type::ArrayOf[ContextDev::Models::WebWebScrapeImagesResponse::Image] }
 
       # @!attribute success
-      #   Indicates success
+      #   Always true on success.
       #
       #   @return [Boolean, ContextDev::Models::WebWebScrapeImagesResponse::Success]
       required :success, enum: -> { ContextDev::Models::WebWebScrapeImagesResponse::Success }
 
       # @!attribute url
-      #   The URL that was scraped
+      #   Page URL that was scraped.
       #
       #   @return [String]
       required :url, String
 
       # @!method initialize(images:, success:, url:)
-      #   @param images [Array<ContextDev::Models::WebWebScrapeImagesResponse::Image>] Array of scraped images
+      #   @param images [Array<ContextDev::Models::WebWebScrapeImagesResponse::Image>] Images found on the page.
       #
-      #   @param success [Boolean, ContextDev::Models::WebWebScrapeImagesResponse::Success] Indicates success
+      #   @param success [Boolean, ContextDev::Models::WebWebScrapeImagesResponse::Success] Always true on success.
       #
-      #   @param url [String] The URL that was scraped
+      #   @param url [String] Page URL that was scraped.
 
       class Image < ContextDev::Internal::Type::BaseModel
         # @!attribute alt
-        #   Alt text of the image, or null if not present
+        #   Image alt text, or null when unavailable.
         #
         #   @return [String, nil]
         required :alt, String, nil?: true
 
         # @!attribute element
-        #   The HTML element the image was found in
+        #   Where the image was found.
         #
         #   @return [Symbol, ContextDev::Models::WebWebScrapeImagesResponse::Image::Element]
         required :element, enum: -> { ContextDev::Models::WebWebScrapeImagesResponse::Image::Element }
 
         # @!attribute src
-        #   The image source - can be a URL, inline HTML (for SVGs), or a base64 data URI
+        #   Original image value: URL, inline SVG or HTML, or base64 data URI.
         #
         #   @return [String]
         required :src, String
 
         # @!attribute type
-        #   The type/format of the src value
+        #   Format of src.
         #
         #   @return [Symbol, ContextDev::Models::WebWebScrapeImagesResponse::Image::Type]
         required :type, enum: -> { ContextDev::Models::WebWebScrapeImagesResponse::Image::Type }
 
-        # @!method initialize(alt:, element:, src:, type:)
-        #   @param alt [String, nil] Alt text of the image, or null if not present
+        # @!attribute enrichment
+        #   Requested metadata for images that could be processed.
         #
-        #   @param element [Symbol, ContextDev::Models::WebWebScrapeImagesResponse::Image::Element] The HTML element the image was found in
+        #   @return [ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment, nil]
+        optional :enrichment, -> { ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment }
+
+        # @!method initialize(alt:, element:, src:, type:, enrichment: nil)
+        #   @param alt [String, nil] Image alt text, or null when unavailable.
+        #
+        #   @param element [Symbol, ContextDev::Models::WebWebScrapeImagesResponse::Image::Element] Where the image was found.
+        #
+        #   @param src [String] Original image value: URL, inline SVG or HTML, or base64 data URI.
         #
-        #   @param src [String] The image source - can be a URL, inline HTML (for SVGs), or a base64 data URI
+        #   @param type [Symbol, ContextDev::Models::WebWebScrapeImagesResponse::Image::Type] Format of src.
         #
-        #   @param type [Symbol, ContextDev::Models::WebWebScrapeImagesResponse::Image::Type] The type/format of the src value
+        #   @param enrichment [ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment] Requested metadata for images that could be processed.
 
-        # The HTML element the image was found in
+        # Where the image was found.
         #
         # @see ContextDev::Models::WebWebScrapeImagesResponse::Image#element
         module Element
@@ -84,7 +92,7 @@ module ContextDev
           #   @return [Array<Symbol>]
         end
 
-        # The type/format of the src value
+        # Format of src.
         #
         # @see ContextDev::Models::WebWebScrapeImagesResponse::Image#type
         module Type
@@ -97,9 +105,74 @@ module ContextDev
           # @!method self.values
           #   @return [Array<Symbol>]
         end
+
+        # @see ContextDev::Models::WebWebScrapeImagesResponse::Image#enrichment
+        class Enrichment < ContextDev::Internal::Type::BaseModel
+          # @!attribute height
+          #   Image height in pixels, when measured.
+          #
+          #   @return [Integer, nil]
+          optional :height, Integer
+
+          # @!attribute mimetype
+          #   Detected MIME type, when hosted.
+          #
+          #   @return [String, nil]
+          optional :mimetype, String
+
+          # @!attribute type
+          #   Visual asset category, when classified.
+          #
+          #   @return [Symbol, ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment::Type, nil]
+          optional :type, enum: -> { ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment::Type }
+
+          # @!attribute url
+          #   Brand.dev CDN URL, when hosted.
+          #
+          #   @return [String, nil]
+          optional :url, String
+
+          # @!attribute width
+          #   Image width in pixels, when measured.
+          #
+          #   @return [Integer, nil]
+          optional :width, Integer
+
+          # @!method initialize(height: nil, mimetype: nil, type: nil, url: nil, width: nil)
+          #   Requested metadata for images that could be processed.
+          #
+          #   @param height [Integer] Image height in pixels, when measured.
+          #
+          #   @param mimetype [String] Detected MIME type, when hosted.
+          #
+          #   @param type [Symbol, ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment::Type] Visual asset category, when classified.
+          #
+          #   @param url [String] Brand.dev CDN URL, when hosted.
+          #
+          #   @param width [Integer] Image width in pixels, when measured.
+
+          # Visual asset category, when classified.
+          #
+          # @see ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment#type
+          module Type
+            extend ContextDev::Internal::Type::Enum
+
+            PHOTOGRAPHY = :photography
+            ILLUSTRATION = :illustration
+            LOGO = :logo
+            WORDMARK = :wordmark
+            ICON = :icon
+            PATTERN = :pattern
+            GRAPHIC = :graphic
+            OTHER = :other
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
       end
 
-      # Indicates success
+      # Always true on success.
       #
       # @see ContextDev::Models::WebWebScrapeImagesResponse#success
       module Success

data/lib/context_dev/resources/web.rb

@@ -183,13 +183,21 @@ module ContextDev
         )
       end
 
-      # Scrapes all images from the given URL. Extracts images from img, svg,
-      # picture/source, link, and video elements including inline SVGs, base64 data
-      # URIs, and standard URLs.
+      # Some parameter documentations has been truncated, see
+      # {ContextDev::Models::WebWebScrapeImagesParams} for more details.
+      #
+      # 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; enrichment costs 1 credit per returned
+      # image.
+      #
+      # @overload web_scrape_images(url:, enrichment: nil, max_age_ms: nil, request_options: {})
+      #
+      # @param url [String] Page URL to inspect. Must include http:// or https://.
       #
-      # @overload web_scrape_images(url:, request_options: {})
+      # @param enrichment [ContextDev::Models::WebWebScrapeImagesParams::Enrichment] Optional per-image processing, sent as deep-object query params such as enrichme
       #
-      # @param url [String] Full URL to scrape images from (must include http:// or https:// protocol)
+      # @param max_age_ms [Integer] Reuse a cached result this many milliseconds old or newer. Default: 86400000 (1
       #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -202,7 +210,7 @@ module ContextDev
         @client.request(
           method: :get,
           path: "web/scrape/images",
-          query: query,
+          query: query.transform_keys(max_age_ms: "maxAgeMs"),
           model: ContextDev::Models::WebWebScrapeImagesResponse,
           options: options
         )

data/lib/context_dev/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ContextDev
-  VERSION = "1.12.0"
+  VERSION = "1.14.0"
 end

data/rbi/context_dev/models/web_web_scrape_images_params.rbi

@@ -14,30 +14,140 @@ module ContextDev
           )
         end
 
-      # Full URL to scrape images from (must include http:// or https:// protocol)
+      # Page URL to inspect. Must include http:// or https://.
       sig { returns(String) }
       attr_accessor :url
 
+      # Optional per-image processing, sent as deep-object query params such as
+      # enrichment[resolution]=true.
+      sig do
+        returns(T.nilable(ContextDev::WebWebScrapeImagesParams::Enrichment))
+      end
+      attr_reader :enrichment
+
+      sig do
+        params(
+          enrichment: ContextDev::WebWebScrapeImagesParams::Enrichment::OrHash
+        ).void
+      end
+      attr_writer :enrichment
+
+      # Reuse a cached result this many milliseconds old or newer. Default: 86400000 (1
+      # day). Set to 0 to bypass cache. Maximum: 2592000000 (30 days).
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :max_age_ms
+
+      sig { params(max_age_ms: Integer).void }
+      attr_writer :max_age_ms
+
       sig do
         params(
           url: String,
+          enrichment: ContextDev::WebWebScrapeImagesParams::Enrichment::OrHash,
+          max_age_ms: Integer,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
       def self.new(
-        # Full URL to scrape images from (must include http:// or https:// protocol)
+        # Page URL to inspect. Must include http:// or https://.
         url:,
+        # Optional per-image processing, sent as deep-object query params such as
+        # enrichment[resolution]=true.
+        enrichment: nil,
+        # Reuse a cached result this many milliseconds old or newer. Default: 86400000 (1
+        # day). Set to 0 to bypass cache. Maximum: 2592000000 (30 days).
+        max_age_ms: nil,
         request_options: {}
       )
       end
 
       sig do
         override.returns(
-          { url: String, request_options: ContextDev::RequestOptions }
+          {
+            url: String,
+            enrichment: ContextDev::WebWebScrapeImagesParams::Enrichment,
+            max_age_ms: Integer,
+            request_options: ContextDev::RequestOptions
+          }
         )
       end
       def to_hash
       end
+
+      class Enrichment < ContextDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              ContextDev::WebWebScrapeImagesParams::Enrichment,
+              ContextDev::Internal::AnyHash
+            )
+          end
+
+        # Classify each image by visual asset type.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :classification
+
+        sig { params(classification: T::Boolean).void }
+        attr_writer :classification
+
+        # Host materializable images on the Brand.dev CDN and return their URL and MIME
+        # type.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :hosted_url
+
+        sig { params(hosted_url: T::Boolean).void }
+        attr_writer :hosted_url
+
+        # Per-image enrichment timeout in milliseconds. Default: 6000. Maximum: 60000.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :max_time_per_ms
+
+        sig { params(max_time_per_ms: Integer).void }
+        attr_writer :max_time_per_ms
+
+        # Measure image width and height when possible.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :resolution
+
+        sig { params(resolution: T::Boolean).void }
+        attr_writer :resolution
+
+        # Optional per-image processing, sent as deep-object query params such as
+        # enrichment[resolution]=true.
+        sig do
+          params(
+            classification: T::Boolean,
+            hosted_url: T::Boolean,
+            max_time_per_ms: Integer,
+            resolution: T::Boolean
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Classify each image by visual asset type.
+          classification: nil,
+          # Host materializable images on the Brand.dev CDN and return their URL and MIME
+          # type.
+          hosted_url: nil,
+          # Per-image enrichment timeout in milliseconds. Default: 6000. Maximum: 60000.
+          max_time_per_ms: nil,
+          # Measure image width and height when possible.
+          resolution: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              classification: T::Boolean,
+              hosted_url: T::Boolean,
+              max_time_per_ms: Integer,
+              resolution: T::Boolean
+            }
+          )
+        end
+        def to_hash
+        end
+      end
     end
   end
 end

data/rbi/context_dev/models/web_web_scrape_images_response.rbi

@@ -11,13 +11,13 @@ module ContextDev
           )
         end
 
-      # Array of scraped images
+      # Images found on the page.
       sig do
         returns(T::Array[ContextDev::Models::WebWebScrapeImagesResponse::Image])
       end
       attr_accessor :images
 
-      # Indicates success
+      # Always true on success.
       sig do
         returns(
           ContextDev::Models::WebWebScrapeImagesResponse::Success::TaggedBoolean
@@ -25,7 +25,7 @@ module ContextDev
       end
       attr_accessor :success
 
-      # The URL that was scraped
+      # Page URL that was scraped.
       sig { returns(String) }
       attr_accessor :url
 
@@ -41,11 +41,11 @@ module ContextDev
         ).returns(T.attached_class)
       end
       def self.new(
-        # Array of scraped images
+        # Images found on the page.
         images:,
-        # Indicates success
+        # Always true on success.
         success:,
-        # The URL that was scraped
+        # Page URL that was scraped.
         url:
       )
       end
@@ -73,11 +73,11 @@ module ContextDev
             )
           end
 
-        # Alt text of the image, or null if not present
+        # Image alt text, or null when unavailable.
         sig { returns(T.nilable(String)) }
         attr_accessor :alt
 
-        # The HTML element the image was found in
+        # Where the image was found.
         sig do
           returns(
             ContextDev::Models::WebWebScrapeImagesResponse::Image::Element::TaggedSymbol
@@ -85,11 +85,11 @@ module ContextDev
         end
         attr_accessor :element
 
-        # The image source - can be a URL, inline HTML (for SVGs), or a base64 data URI
+        # Original image value: URL, inline SVG or HTML, or base64 data URI.
         sig { returns(String) }
         attr_accessor :src
 
-        # The type/format of the src value
+        # Format of src.
         sig do
           returns(
             ContextDev::Models::WebWebScrapeImagesResponse::Image::Type::TaggedSymbol
@@ -97,6 +97,24 @@ module ContextDev
         end
         attr_accessor :type
 
+        # Requested metadata for images that could be processed.
+        sig do
+          returns(
+            T.nilable(
+              ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment
+            )
+          )
+        end
+        attr_reader :enrichment
+
+        sig do
+          params(
+            enrichment:
+              ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment::OrHash
+          ).void
+        end
+        attr_writer :enrichment
+
         sig do
           params(
             alt: T.nilable(String),
@@ -104,18 +122,22 @@ module ContextDev
               ContextDev::Models::WebWebScrapeImagesResponse::Image::Element::OrSymbol,
             src: String,
             type:
-              ContextDev::Models::WebWebScrapeImagesResponse::Image::Type::OrSymbol
+              ContextDev::Models::WebWebScrapeImagesResponse::Image::Type::OrSymbol,
+            enrichment:
+              ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment::OrHash
           ).returns(T.attached_class)
         end
         def self.new(
-          # Alt text of the image, or null if not present
+          # Image alt text, or null when unavailable.
           alt:,
-          # The HTML element the image was found in
+          # Where the image was found.
           element:,
-          # The image source - can be a URL, inline HTML (for SVGs), or a base64 data URI
+          # Original image value: URL, inline SVG or HTML, or base64 data URI.
           src:,
-          # The type/format of the src value
-          type:
+          # Format of src.
+          type:,
+          # Requested metadata for images that could be processed.
+          enrichment: nil
         )
         end
 
@@ -127,14 +149,16 @@ module ContextDev
                 ContextDev::Models::WebWebScrapeImagesResponse::Image::Element::TaggedSymbol,
               src: String,
               type:
-                ContextDev::Models::WebWebScrapeImagesResponse::Image::Type::TaggedSymbol
+                ContextDev::Models::WebWebScrapeImagesResponse::Image::Type::TaggedSymbol,
+              enrichment:
+                ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment
             }
           )
         end
         def to_hash
         end
 
-        # The HTML element the image was found in
+        # Where the image was found.
         module Element
           extend ContextDev::Internal::Type::Enum
 
@@ -204,7 +228,7 @@ module ContextDev
           end
         end
 
-        # The type/format of the src value
+        # Format of src.
         module Type
           extend ContextDev::Internal::Type::Enum
 
@@ -243,9 +267,170 @@ module ContextDev
           def self.values
           end
         end
+
+        class Enrichment < ContextDev::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment,
+                ContextDev::Internal::AnyHash
+              )
+            end
+
+          # Image height in pixels, when measured.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :height
+
+          sig { params(height: Integer).void }
+          attr_writer :height
+
+          # Detected MIME type, when hosted.
+          sig { returns(T.nilable(String)) }
+          attr_reader :mimetype
+
+          sig { params(mimetype: String).void }
+          attr_writer :mimetype
+
+          # Visual asset category, when classified.
+          sig do
+            returns(
+              T.nilable(
+                ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment::Type::TaggedSymbol
+              )
+            )
+          end
+          attr_reader :type
+
+          sig do
+            params(
+              type:
+                ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment::Type::OrSymbol
+            ).void
+          end
+          attr_writer :type
+
+          # Brand.dev CDN URL, when hosted.
+          sig { returns(T.nilable(String)) }
+          attr_reader :url
+
+          sig { params(url: String).void }
+          attr_writer :url
+
+          # Image width in pixels, when measured.
+          sig { returns(T.nilable(Integer)) }
+          attr_reader :width
+
+          sig { params(width: Integer).void }
+          attr_writer :width
+
+          # Requested metadata for images that could be processed.
+          sig do
+            params(
+              height: Integer,
+              mimetype: String,
+              type:
+                ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment::Type::OrSymbol,
+              url: String,
+              width: Integer
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # Image height in pixels, when measured.
+            height: nil,
+            # Detected MIME type, when hosted.
+            mimetype: nil,
+            # Visual asset category, when classified.
+            type: nil,
+            # Brand.dev CDN URL, when hosted.
+            url: nil,
+            # Image width in pixels, when measured.
+            width: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                height: Integer,
+                mimetype: String,
+                type:
+                  ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment::Type::TaggedSymbol,
+                url: String,
+                width: Integer
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # Visual asset category, when classified.
+          module Type
+            extend ContextDev::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment::Type
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            PHOTOGRAPHY =
+              T.let(
+                :photography,
+                ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment::Type::TaggedSymbol
+              )
+            ILLUSTRATION =
+              T.let(
+                :illustration,
+                ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment::Type::TaggedSymbol
+              )
+            LOGO =
+              T.let(
+                :logo,
+                ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment::Type::TaggedSymbol
+              )
+            WORDMARK =
+              T.let(
+                :wordmark,
+                ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment::Type::TaggedSymbol
+              )
+            ICON =
+              T.let(
+                :icon,
+                ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment::Type::TaggedSymbol
+              )
+            PATTERN =
+              T.let(
+                :pattern,
+                ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment::Type::TaggedSymbol
+              )
+            GRAPHIC =
+              T.let(
+                :graphic,
+                ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment::Type::TaggedSymbol
+              )
+            OTHER =
+              T.let(
+                :other,
+                ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment::Type::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment::Type::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
       end
 
-      # Indicates success
+      # Always true on success.
       module Success
         extend ContextDev::Internal::Type::Enum
 

data/rbi/context_dev/resources/web.rbi

@@ -180,18 +180,27 @@ module ContextDev
       )
       end
 
-      # Scrapes all images from the given URL. Extracts images from img, svg,
-      # picture/source, link, and video elements including inline SVGs, base64 data
-      # URIs, and standard URLs.
+      # 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; enrichment costs 1 credit per returned
+      # image.
       sig do
         params(
           url: String,
+          enrichment: ContextDev::WebWebScrapeImagesParams::Enrichment::OrHash,
+          max_age_ms: Integer,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(ContextDev::Models::WebWebScrapeImagesResponse)
       end
       def web_scrape_images(
-        # Full URL to scrape images from (must include http:// or https:// protocol)
+        # Page URL to inspect. Must include http:// or https://.
         url:,
+        # Optional per-image processing, sent as deep-object query params such as
+        # enrichment[resolution]=true.
+        enrichment: nil,
+        # Reuse a cached result this many milliseconds old or newer. Default: 86400000 (1
+        # day). Set to 0 to bypass cache. Maximum: 2592000000 (30 days).
+        max_age_ms: nil,
         request_options: {}
       )
       end

data/sig/context_dev/models/web_web_scrape_images_params.rbs

@@ -1,7 +1,12 @@
 module ContextDev
   module Models
     type web_web_scrape_images_params =
-      { url: String } & ContextDev::Internal::Type::request_parameters
+      {
+        url: String,
+        enrichment: ContextDev::WebWebScrapeImagesParams::Enrichment,
+        max_age_ms: Integer
+      }
+      & ContextDev::Internal::Type::request_parameters
 
     class WebWebScrapeImagesParams < ContextDev::Internal::Type::BaseModel
       extend ContextDev::Internal::Type::RequestParameters::Converter
@@ -9,15 +14,69 @@ module ContextDev
 
       attr_accessor url: String
 
+      attr_reader enrichment: ContextDev::WebWebScrapeImagesParams::Enrichment?
+
+      def enrichment=: (
+        ContextDev::WebWebScrapeImagesParams::Enrichment
+      ) -> ContextDev::WebWebScrapeImagesParams::Enrichment
+
+      attr_reader max_age_ms: Integer?
+
+      def max_age_ms=: (Integer) -> Integer
+
       def initialize: (
         url: String,
+        ?enrichment: ContextDev::WebWebScrapeImagesParams::Enrichment,
+        ?max_age_ms: Integer,
         ?request_options: ContextDev::request_opts
       ) -> void
 
       def to_hash: -> {
         url: String,
+        enrichment: ContextDev::WebWebScrapeImagesParams::Enrichment,
+        max_age_ms: Integer,
         request_options: ContextDev::RequestOptions
       }
+
+      type enrichment =
+        {
+          classification: bool,
+          hosted_url: bool,
+          max_time_per_ms: Integer,
+          resolution: bool
+        }
+
+      class Enrichment < ContextDev::Internal::Type::BaseModel
+        attr_reader classification: bool?
+
+        def classification=: (bool) -> bool
+
+        attr_reader hosted_url: bool?
+
+        def hosted_url=: (bool) -> bool
+
+        attr_reader max_time_per_ms: Integer?
+
+        def max_time_per_ms=: (Integer) -> Integer
+
+        attr_reader resolution: bool?
+
+        def resolution=: (bool) -> bool
+
+        def initialize: (
+          ?classification: bool,
+          ?hosted_url: bool,
+          ?max_time_per_ms: Integer,
+          ?resolution: bool
+        ) -> void
+
+        def to_hash: -> {
+          classification: bool,
+          hosted_url: bool,
+          max_time_per_ms: Integer,
+          resolution: bool
+        }
+      end
     end
   end
 end

data/sig/context_dev/models/web_web_scrape_images_response.rbs

@@ -31,7 +31,8 @@ module ContextDev
           alt: String?,
           element: ContextDev::Models::WebWebScrapeImagesResponse::Image::element,
           src: String,
-          type: ContextDev::Models::WebWebScrapeImagesResponse::Image::type_
+          type: ContextDev::Models::WebWebScrapeImagesResponse::Image::type_,
+          enrichment: ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment
         }
 
       class Image < ContextDev::Internal::Type::BaseModel
@@ -43,18 +44,26 @@ module ContextDev
 
         attr_accessor type: ContextDev::Models::WebWebScrapeImagesResponse::Image::type_
 
+        attr_reader enrichment: ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment?
+
+        def enrichment=: (
+          ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment
+        ) -> ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment
+
         def initialize: (
           alt: String?,
           element: ContextDev::Models::WebWebScrapeImagesResponse::Image::element,
           src: String,
-          type: ContextDev::Models::WebWebScrapeImagesResponse::Image::type_
+          type: ContextDev::Models::WebWebScrapeImagesResponse::Image::type_,
+          ?enrichment: ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment
         ) -> void
 
         def to_hash: -> {
           alt: String?,
           element: ContextDev::Models::WebWebScrapeImagesResponse::Image::element,
           src: String,
-          type: ContextDev::Models::WebWebScrapeImagesResponse::Image::type_
+          type: ContextDev::Models::WebWebScrapeImagesResponse::Image::type_,
+          enrichment: ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment
         }
 
         type element =
@@ -95,6 +104,80 @@ module ContextDev
 
           def self?.values: -> ::Array[ContextDev::Models::WebWebScrapeImagesResponse::Image::type_]
         end
+
+        type enrichment =
+          {
+            height: Integer,
+            mimetype: String,
+            type: ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment::type_,
+            url: String,
+            width: Integer
+          }
+
+        class Enrichment < ContextDev::Internal::Type::BaseModel
+          attr_reader height: Integer?
+
+          def height=: (Integer) -> Integer
+
+          attr_reader mimetype: String?
+
+          def mimetype=: (String) -> String
+
+          attr_reader type: ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment::type_?
+
+          def type=: (
+            ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment::type_
+          ) -> ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment::type_
+
+          attr_reader url: String?
+
+          def url=: (String) -> String
+
+          attr_reader width: Integer?
+
+          def width=: (Integer) -> Integer
+
+          def initialize: (
+            ?height: Integer,
+            ?mimetype: String,
+            ?type: ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment::type_,
+            ?url: String,
+            ?width: Integer
+          ) -> void
+
+          def to_hash: -> {
+            height: Integer,
+            mimetype: String,
+            type: ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment::type_,
+            url: String,
+            width: Integer
+          }
+
+          type type_ =
+            :photography
+            | :illustration
+            | :logo
+            | :wordmark
+            | :icon
+            | :pattern
+            | :graphic
+            | :other
+
+          module Type
+            extend ContextDev::Internal::Type::Enum
+
+            PHOTOGRAPHY: :photography
+            ILLUSTRATION: :illustration
+            LOGO: :logo
+            WORDMARK: :wordmark
+            ICON: :icon
+            PATTERN: :pattern
+            GRAPHIC: :graphic
+            OTHER: :other
+
+            def self?.values: -> ::Array[ContextDev::Models::WebWebScrapeImagesResponse::Image::Enrichment::type_]
+          end
+        end
       end
 
       type success = true

data/sig/context_dev/resources/web.rbs

@@ -50,6 +50,8 @@ module ContextDev
 
       def web_scrape_images: (
         url: String,
+        ?enrichment: ContextDev::WebWebScrapeImagesParams::Enrichment,
+        ?max_age_ms: Integer,
         ?request_options: ContextDev::request_opts
       ) -> ContextDev::Models::WebWebScrapeImagesResponse
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: context.dev
 version: !ruby/object:Gem::Version
-  version: 1.12.0
+  version: 1.14.0
 platform: ruby
 authors:
 - Context Dev
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-01 00:00:00.000000000 Z
+date: 2026-05-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi