context.dev 1.15.0 → 1.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 84cc2c8157b82ddbf49757ced0e0f6bbc55fb1cf67ffe3db1725bdbf7db89c46
-  data.tar.gz: a1783d6a9fb36f14a61d4c201066e25986249ca36d64f4bfa06e3acfb400ab33
+  metadata.gz: 6ba57da748751f653f87b57407326a40a8af9b31dc9c10364c61e536a7eb57a6
+  data.tar.gz: b10761a87783d8544bae6dd0bad6c3f3275af2fd2c39e734e61709d89de8cd9e
 SHA512:
-  metadata.gz: c76dc1a666b1765f26e679707344ef82ffc004850e0fa8d1fa9565571a0784a2cfb408c110c3463f4dcd75a2df86d7036178694cd17c39e1d0c93f41a6db2cfa
-  data.tar.gz: 7babec26bd5a654a9c10e2da55ebf39835c2078c8e06ce0f54fd3d1022adb6f65008b7a007594d8ba8547292dc75597bf184a1d499b175936a6f50df1245db0a
+  metadata.gz: 53f3f7978e24bcac14e388d76f2ba02b1410354b536264a14074306ce6464725d5741ebf6d59b1d280eeb8b2babc1980c35397c45175213645d38fdbcd89a5c5
+  data.tar.gz: 4d9aa2a1af255cd2352c613bfd3fbbef1532d9ab6eb396d8e9e33d1a41f7b4eabd3601c6406a68d3688a338b1f588f3cf76bc7d17b8966ddff0b358dd1cc6d72

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 1.16.0 (2026-05-07)
+
+Full Changelog: [v1.15.0...v1.16.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.15.0...v1.16.0)
+
+### Features
+
+* **api:** api update ([f0b1f3a](https://github.com/context-dot-dev/context-ruby-sdk/commit/f0b1f3afd885c44cb464393b57d944fa27a6c0b5))
+
 ## 1.15.0 (2026-05-06)
 
 Full Changelog: [v1.14.0...v1.15.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.14.0...v1.15.0)

data/README.md

@@ -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.15.0"
+gem "context.dev", "~> 1.16.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/context_dev/models/web_screenshot_params.rb

@@ -31,6 +31,14 @@ module ContextDev
       #   @return [Symbol, ContextDev::Models::WebScreenshotParams::FullScreenshot, nil]
       optional :full_screenshot, enum: -> { ContextDev::WebScreenshotParams::FullScreenshot }
 
+      # @!attribute max_age_ms
+      #   Return a cached screenshot if a prior screenshot for the same parameters exists
+      #   and is younger than this many milliseconds. Defaults to 1 day (86400000 ms) when
+      #   omitted. Max is 30 days (2592000000 ms). Set to 0 to always capture fresh.
+      #
+      #   @return [Integer, nil]
+      optional :max_age_ms, Integer
+
       # @!attribute page
       #   Optional parameter to specify which page type to screenshot. If provided, the
       #   system will scrape the domain's links and use heuristics to find the most
@@ -49,7 +57,13 @@ module ContextDev
       #   @return [Symbol, ContextDev::Models::WebScreenshotParams::Prioritize, nil]
       optional :prioritize, enum: -> { ContextDev::WebScreenshotParams::Prioritize }
 
-      # @!method initialize(direct_url: nil, domain: nil, full_screenshot: nil, page: nil, prioritize: nil, request_options: {})
+      # @!attribute viewport
+      #   Optional browser viewport dimensions for the screenshot. Defaults to 1920x1080.
+      #
+      #   @return [ContextDev::Models::WebScreenshotParams::Viewport, nil]
+      optional :viewport, -> { ContextDev::WebScreenshotParams::Viewport }
+
+      # @!method initialize(direct_url: nil, domain: nil, full_screenshot: nil, max_age_ms: nil, page: nil, prioritize: nil, viewport: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebScreenshotParams} for more details.
       #
@@ -59,10 +73,14 @@ module ContextDev
       #
       #   @param full_screenshot [Symbol, ContextDev::Models::WebScreenshotParams::FullScreenshot] Optional parameter to determine screenshot type. If 'true', takes a full page sc
       #
+      #   @param max_age_ms [Integer] Return a cached screenshot if a prior screenshot for the same parameters exists
+      #
       #   @param page [Symbol, ContextDev::Models::WebScreenshotParams::Page] Optional parameter to specify which page type to screenshot. If provided, the sy
       #
       #   @param prioritize [Symbol, ContextDev::Models::WebScreenshotParams::Prioritize] Optional parameter to prioritize screenshot capture. If 'speed', optimizes for f
       #
+      #   @param viewport [ContextDev::Models::WebScreenshotParams::Viewport] Optional browser viewport dimensions for the screenshot. Defaults to 1920x1080.
+      #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
 
       # Optional parameter to determine screenshot type. If 'true', takes a full page
@@ -111,6 +129,27 @@ module ContextDev
         # @!method self.values
         #   @return [Array<Symbol>]
       end
+
+      class Viewport < ContextDev::Internal::Type::BaseModel
+        # @!attribute height
+        #   Viewport height in pixels.
+        #
+        #   @return [Integer, nil]
+        optional :height, Integer
+
+        # @!attribute width
+        #   Viewport width in pixels.
+        #
+        #   @return [Integer, nil]
+        optional :width, Integer
+
+        # @!method initialize(height: nil, width: nil)
+        #   Optional browser viewport dimensions for the screenshot. Defaults to 1920x1080.
+        #
+        #   @param height [Integer] Viewport height in pixels.
+        #
+        #   @param width [Integer] Viewport width in pixels.
+      end
     end
   end
 end

data/lib/context_dev/models/web_screenshot_response.rb

@@ -16,6 +16,12 @@ module ContextDev
       #   @return [String, nil]
       optional :domain, String
 
+      # @!attribute height
+      #   Height in pixels of the returned screenshot image
+      #
+      #   @return [Integer, nil]
+      optional :height, Integer
+
       # @!attribute screenshot
       #   Public URL of the uploaded screenshot image
       #
@@ -36,16 +42,26 @@ module ContextDev
       #   @return [String, nil]
       optional :status, String
 
-      # @!method initialize(code: nil, domain: nil, screenshot: nil, screenshot_type: nil, status: nil)
+      # @!attribute width
+      #   Width in pixels of the returned screenshot image
+      #
+      #   @return [Integer, nil]
+      optional :width, Integer
+
+      # @!method initialize(code: nil, domain: nil, height: nil, screenshot: nil, screenshot_type: nil, status: nil, width: nil)
       #   @param code [Integer] HTTP status code
       #
       #   @param domain [String] The normalized domain that was processed
       #
+      #   @param height [Integer] Height in pixels of the returned screenshot image
+      #
       #   @param screenshot [String] Public URL of the uploaded screenshot image
       #
       #   @param screenshot_type [Symbol, ContextDev::Models::WebScreenshotResponse::ScreenshotType] Type of screenshot that was captured
       #
       #   @param status [String] Status of the response, e.g., 'ok'
+      #
+      #   @param width [Integer] Width in pixels of the returned screenshot image
 
       # Type of screenshot that was captured
       #

data/lib/context_dev/resources/web.rb

@@ -70,7 +70,7 @@ module ContextDev
       #
       # Capture a screenshot of a website.
       #
-      # @overload screenshot(direct_url: nil, domain: nil, full_screenshot: nil, page: nil, prioritize: nil, request_options: {})
+      # @overload screenshot(direct_url: nil, domain: nil, full_screenshot: nil, max_age_ms: nil, page: nil, prioritize: nil, viewport: nil, request_options: {})
       #
       # @param direct_url [String] A specific URL to screenshot directly, bypassing domain resolution (e.g., 'https
       #
@@ -78,10 +78,14 @@ module ContextDev
       #
       # @param full_screenshot [Symbol, ContextDev::Models::WebScreenshotParams::FullScreenshot] Optional parameter to determine screenshot type. If 'true', takes a full page sc
       #
+      # @param max_age_ms [Integer] Return a cached screenshot if a prior screenshot for the same parameters exists
+      #
       # @param page [Symbol, ContextDev::Models::WebScreenshotParams::Page] Optional parameter to specify which page type to screenshot. If provided, the sy
       #
       # @param prioritize [Symbol, ContextDev::Models::WebScreenshotParams::Prioritize] Optional parameter to prioritize screenshot capture. If 'speed', optimizes for f
       #
+      # @param viewport [ContextDev::Models::WebScreenshotParams::Viewport] Optional browser viewport dimensions for the screenshot. Defaults to 1920x1080.
+      #
       # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [ContextDev::Models::WebScreenshotResponse]
@@ -93,7 +97,11 @@ module ContextDev
         @client.request(
           method: :get,
           path: "web/screenshot",
-          query: query.transform_keys(direct_url: "directUrl", full_screenshot: "fullScreenshot"),
+          query: query.transform_keys(
+            direct_url: "directUrl",
+            full_screenshot: "fullScreenshot",
+            max_age_ms: "maxAgeMs"
+          ),
           model: ContextDev::Models::WebScreenshotResponse,
           options: options
         )

data/lib/context_dev/version.rb

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

data/rbi/context_dev/models/web_screenshot_params.rbi

@@ -47,6 +47,15 @@ module ContextDev
       end
       attr_writer :full_screenshot
 
+      # Return a cached screenshot if a prior screenshot for the same parameters exists
+      # and is younger than this many milliseconds. Defaults to 1 day (86400000 ms) when
+      # omitted. Max is 30 days (2592000000 ms). Set to 0 to always capture fresh.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :max_age_ms
+
+      sig { params(max_age_ms: Integer).void }
+      attr_writer :max_age_ms
+
       # Optional parameter to specify which page type to screenshot. If provided, the
       # system will scrape the domain's links and use heuristics to find the most
       # appropriate URL for the specified page type (30 supported languages). If not
@@ -77,14 +86,25 @@ module ContextDev
       end
       attr_writer :prioritize
 
+      # Optional browser viewport dimensions for the screenshot. Defaults to 1920x1080.
+      sig { returns(T.nilable(ContextDev::WebScreenshotParams::Viewport)) }
+      attr_reader :viewport
+
+      sig do
+        params(viewport: ContextDev::WebScreenshotParams::Viewport::OrHash).void
+      end
+      attr_writer :viewport
+
       sig do
         params(
           direct_url: String,
           domain: String,
           full_screenshot:
             ContextDev::WebScreenshotParams::FullScreenshot::OrSymbol,
+          max_age_ms: Integer,
           page: ContextDev::WebScreenshotParams::Page::OrSymbol,
           prioritize: ContextDev::WebScreenshotParams::Prioritize::OrSymbol,
+          viewport: ContextDev::WebScreenshotParams::Viewport::OrHash,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
@@ -101,6 +121,10 @@ module ContextDev
         # screenshot capturing all content. If 'false' or not provided, takes a viewport
         # screenshot (standard browser view).
         full_screenshot: nil,
+        # Return a cached screenshot if a prior screenshot for the same parameters exists
+        # and is younger than this many milliseconds. Defaults to 1 day (86400000 ms) when
+        # omitted. Max is 30 days (2592000000 ms). Set to 0 to always capture fresh.
+        max_age_ms: nil,
         # Optional parameter to specify which page type to screenshot. If provided, the
         # system will scrape the domain's links and use heuristics to find the most
         # appropriate URL for the specified page type (30 supported languages). If not
@@ -111,6 +135,8 @@ module ContextDev
         # faster capture with basic quality. If 'quality', optimizes for higher quality
         # with longer wait times. Defaults to 'quality' if not provided.
         prioritize: nil,
+        # Optional browser viewport dimensions for the screenshot. Defaults to 1920x1080.
+        viewport: nil,
         request_options: {}
       )
       end
@@ -122,8 +148,10 @@ module ContextDev
             domain: String,
             full_screenshot:
               ContextDev::WebScreenshotParams::FullScreenshot::OrSymbol,
+            max_age_ms: Integer,
             page: ContextDev::WebScreenshotParams::Page::OrSymbol,
             prioritize: ContextDev::WebScreenshotParams::Prioritize::OrSymbol,
+            viewport: ContextDev::WebScreenshotParams::Viewport,
             request_options: ContextDev::RequestOptions
           }
         )
@@ -233,6 +261,46 @@ module ContextDev
         def self.values
         end
       end
+
+      class Viewport < ContextDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              ContextDev::WebScreenshotParams::Viewport,
+              ContextDev::Internal::AnyHash
+            )
+          end
+
+        # Viewport height in pixels.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :height
+
+        sig { params(height: Integer).void }
+        attr_writer :height
+
+        # Viewport width in pixels.
+        sig { returns(T.nilable(Integer)) }
+        attr_reader :width
+
+        sig { params(width: Integer).void }
+        attr_writer :width
+
+        # Optional browser viewport dimensions for the screenshot. Defaults to 1920x1080.
+        sig do
+          params(height: Integer, width: Integer).returns(T.attached_class)
+        end
+        def self.new(
+          # Viewport height in pixels.
+          height: nil,
+          # Viewport width in pixels.
+          width: nil
+        )
+        end
+
+        sig { override.returns({ height: Integer, width: Integer }) }
+        def to_hash
+        end
+      end
     end
   end
 end

data/rbi/context_dev/models/web_screenshot_response.rbi

@@ -25,6 +25,13 @@ module ContextDev
       sig { params(domain: String).void }
       attr_writer :domain
 
+      # Height in pixels of the returned screenshot image
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :height
+
+      sig { params(height: Integer).void }
+      attr_writer :height
+
       # Public URL of the uploaded screenshot image
       sig { returns(T.nilable(String)) }
       attr_reader :screenshot
@@ -57,14 +64,23 @@ module ContextDev
       sig { params(status: String).void }
       attr_writer :status
 
+      # Width in pixels of the returned screenshot image
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :width
+
+      sig { params(width: Integer).void }
+      attr_writer :width
+
       sig do
         params(
           code: Integer,
           domain: String,
+          height: Integer,
           screenshot: String,
           screenshot_type:
             ContextDev::Models::WebScreenshotResponse::ScreenshotType::OrSymbol,
-          status: String
+          status: String,
+          width: Integer
         ).returns(T.attached_class)
       end
       def self.new(
@@ -72,12 +88,16 @@ module ContextDev
         code: nil,
         # The normalized domain that was processed
         domain: nil,
+        # Height in pixels of the returned screenshot image
+        height: nil,
         # Public URL of the uploaded screenshot image
         screenshot: nil,
         # Type of screenshot that was captured
         screenshot_type: nil,
         # Status of the response, e.g., 'ok'
-        status: nil
+        status: nil,
+        # Width in pixels of the returned screenshot image
+        width: nil
       )
       end
 
@@ -86,10 +106,12 @@ module ContextDev
           {
             code: Integer,
             domain: String,
+            height: Integer,
             screenshot: String,
             screenshot_type:
               ContextDev::Models::WebScreenshotResponse::ScreenshotType::TaggedSymbol,
-            status: String
+            status: String,
+            width: Integer
           }
         )
       end

data/rbi/context_dev/resources/web.rbi

@@ -65,8 +65,10 @@ module ContextDev
           domain: String,
           full_screenshot:
             ContextDev::WebScreenshotParams::FullScreenshot::OrSymbol,
+          max_age_ms: Integer,
           page: ContextDev::WebScreenshotParams::Page::OrSymbol,
           prioritize: ContextDev::WebScreenshotParams::Prioritize::OrSymbol,
+          viewport: ContextDev::WebScreenshotParams::Viewport::OrHash,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(ContextDev::Models::WebScreenshotResponse)
       end
@@ -83,6 +85,10 @@ module ContextDev
         # screenshot capturing all content. If 'false' or not provided, takes a viewport
         # screenshot (standard browser view).
         full_screenshot: nil,
+        # Return a cached screenshot if a prior screenshot for the same parameters exists
+        # and is younger than this many milliseconds. Defaults to 1 day (86400000 ms) when
+        # omitted. Max is 30 days (2592000000 ms). Set to 0 to always capture fresh.
+        max_age_ms: nil,
         # Optional parameter to specify which page type to screenshot. If provided, the
         # system will scrape the domain's links and use heuristics to find the most
         # appropriate URL for the specified page type (30 supported languages). If not
@@ -93,6 +99,8 @@ module ContextDev
         # faster capture with basic quality. If 'quality', optimizes for higher quality
         # with longer wait times. Defaults to 'quality' if not provided.
         prioritize: nil,
+        # Optional browser viewport dimensions for the screenshot. Defaults to 1920x1080.
+        viewport: nil,
         request_options: {}
       )
       end

data/sig/context_dev/models/web_screenshot_params.rbs

@@ -5,8 +5,10 @@ module ContextDev
         direct_url: String,
         domain: String,
         full_screenshot: ContextDev::Models::WebScreenshotParams::full_screenshot,
+        max_age_ms: Integer,
         page: ContextDev::Models::WebScreenshotParams::page,
-        prioritize: ContextDev::Models::WebScreenshotParams::prioritize
+        prioritize: ContextDev::Models::WebScreenshotParams::prioritize,
+        viewport: ContextDev::WebScreenshotParams::Viewport
       }
       & ContextDev::Internal::Type::request_parameters
 
@@ -28,6 +30,10 @@ module ContextDev
         ContextDev::Models::WebScreenshotParams::full_screenshot
       ) -> ContextDev::Models::WebScreenshotParams::full_screenshot
 
+      attr_reader max_age_ms: Integer?
+
+      def max_age_ms=: (Integer) -> Integer
+
       attr_reader page: ContextDev::Models::WebScreenshotParams::page?
 
       def page=: (
@@ -40,12 +46,20 @@ module ContextDev
         ContextDev::Models::WebScreenshotParams::prioritize
       ) -> ContextDev::Models::WebScreenshotParams::prioritize
 
+      attr_reader viewport: ContextDev::WebScreenshotParams::Viewport?
+
+      def viewport=: (
+        ContextDev::WebScreenshotParams::Viewport
+      ) -> ContextDev::WebScreenshotParams::Viewport
+
       def initialize: (
         ?direct_url: String,
         ?domain: String,
         ?full_screenshot: ContextDev::Models::WebScreenshotParams::full_screenshot,
+        ?max_age_ms: Integer,
         ?page: ContextDev::Models::WebScreenshotParams::page,
         ?prioritize: ContextDev::Models::WebScreenshotParams::prioritize,
+        ?viewport: ContextDev::WebScreenshotParams::Viewport,
         ?request_options: ContextDev::request_opts
       ) -> void
 
@@ -53,8 +67,10 @@ module ContextDev
         direct_url: String,
         domain: String,
         full_screenshot: ContextDev::Models::WebScreenshotParams::full_screenshot,
+        max_age_ms: Integer,
         page: ContextDev::Models::WebScreenshotParams::page,
         prioritize: ContextDev::Models::WebScreenshotParams::prioritize,
+        viewport: ContextDev::WebScreenshotParams::Viewport,
         request_options: ContextDev::RequestOptions
       }
 
@@ -104,6 +120,22 @@ module ContextDev
 
         def self?.values: -> ::Array[ContextDev::Models::WebScreenshotParams::prioritize]
       end
+
+      type viewport = { height: Integer, width: Integer }
+
+      class Viewport < ContextDev::Internal::Type::BaseModel
+        attr_reader height: Integer?
+
+        def height=: (Integer) -> Integer
+
+        attr_reader width: Integer?
+
+        def width=: (Integer) -> Integer
+
+        def initialize: (?height: Integer, ?width: Integer) -> void
+
+        def to_hash: -> { height: Integer, width: Integer }
+      end
     end
   end
 end

data/sig/context_dev/models/web_screenshot_response.rbs

@@ -4,9 +4,11 @@ module ContextDev
       {
         code: Integer,
         domain: String,
+        height: Integer,
         screenshot: String,
         screenshot_type: ContextDev::Models::WebScreenshotResponse::screenshot_type,
-        status: String
+        status: String,
+        width: Integer
       }
 
     class WebScreenshotResponse < ContextDev::Internal::Type::BaseModel
@@ -18,6 +20,10 @@ module ContextDev
 
       def domain=: (String) -> String
 
+      attr_reader height: Integer?
+
+      def height=: (Integer) -> Integer
+
       attr_reader screenshot: String?
 
       def screenshot=: (String) -> String
@@ -32,20 +38,28 @@ module ContextDev
 
       def status=: (String) -> String
 
+      attr_reader width: Integer?
+
+      def width=: (Integer) -> Integer
+
       def initialize: (
         ?code: Integer,
         ?domain: String,
+        ?height: Integer,
         ?screenshot: String,
         ?screenshot_type: ContextDev::Models::WebScreenshotResponse::screenshot_type,
-        ?status: String
+        ?status: String,
+        ?width: Integer
       ) -> void
 
       def to_hash: -> {
         code: Integer,
         domain: String,
+        height: Integer,
         screenshot: String,
         screenshot_type: ContextDev::Models::WebScreenshotResponse::screenshot_type,
-        status: String
+        status: String,
+        width: Integer
       }
 
       type screenshot_type = :viewport | :fullPage

data/sig/context_dev/resources/web.rbs

@@ -19,8 +19,10 @@ module ContextDev
         ?direct_url: String,
         ?domain: String,
         ?full_screenshot: ContextDev::Models::WebScreenshotParams::full_screenshot,
+        ?max_age_ms: Integer,
         ?page: ContextDev::Models::WebScreenshotParams::page,
         ?prioritize: ContextDev::Models::WebScreenshotParams::prioritize,
+        ?viewport: ContextDev::WebScreenshotParams::Viewport,
         ?request_options: ContextDev::request_opts
       ) -> ContextDev::Models::WebScreenshotResponse
 

metadata

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