context.dev 2.16.0 → 2.17.0

data/rbi/context_dev/resources/web.rbi

@@ -3,6 +3,45 @@
 module ContextDev
   module Resources
     class Web
+      # Researches the live web and returns a sourced answer in your requested JSON
+      # shape. Select fast for a smaller research budget at 10 credits or ultra for
+      # deeper reasoning at 100 credits. Defaults to ultra. Fast research is limited to
+      # 30 seconds and ultra to 50 seconds; timeoutOpts.milliseconds can shorten either
+      # deadline.
+      sig do
+        params(
+          task: String,
+          json_format: T::Hash[Symbol, T.anything],
+          mode: ContextDev::WebAnswersParams::Mode::OrSymbol,
+          tags: T::Array[String],
+          timeout_opts: ContextDev::WebAnswersParams::TimeoutOpts::OrHash,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(ContextDev::Models::WebAnswersResponse)
+      end
+      def answers(
+        # What to research and answer, in plain language. Naming a domain in the task (for
+        # example "pricing on context.dev") makes the agent read that site before it
+        # searches.
+        task:,
+        # An example object with placeholder values (for example {"pricing_page_url": "",
+        # "plans": [{"name": "", "price": 0}]}). Object keys and value types are
+        # preserved; unknown values may be null. Empty arrays accept any JSON items.
+        # Defaults to {"result": ""}. Maximum 8 levels, 500 values, and 16000 characters.
+        json_format: nil,
+        # Research level: fast uses a smaller model and research budget for 10 credits;
+        # ultra uses deeper reasoning and research for 100 credits. Defaults to ultra.
+        # Only successful requests consume credits.
+        mode: nil,
+        # Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.
+        tags: nil,
+        # Optional request deadline and behavior on timeout. For GET requests, use
+        # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+        # timeoutOpts object.
+        timeout_opts: nil,
+        request_options: {}
+      )
+      end
+
       # Crawl a website, use the provided JSON Schema and instructions to prioritize
       # relevant internal links, and extract structured data from the selected pages.
       sig do
@@ -28,7 +67,7 @@ module ContextDev
           settle_animations: T::Boolean,
           stop_after_ms: Integer,
           tags: T::Array[String],
-          timeout_ms: Integer,
+          timeout_opts: ContextDev::WebExtractParams::TimeoutOpts::OrHash,
           wait_for_ms: Integer,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(ContextDev::Models::WebExtractResponse)
@@ -81,10 +120,10 @@ module ContextDev
         stop_after_ms: nil,
         # Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.
         tags: nil,
-        # Optional timeout in milliseconds for the request. If the request takes longer
-        # than this value, it will be aborted with a 408 status code. Maximum allowed
-        # value is 300000ms (5 minutes).
-        timeout_ms: nil,
+        # Optional request deadline and behavior on timeout. For GET requests, use
+        # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+        # timeoutOpts object.
+        timeout_opts: nil,
         # Optional browser wait time in milliseconds after initial page load for each
         # crawled page.
         wait_for_ms: nil,
@@ -99,7 +138,8 @@ module ContextDev
           domain: String,
           num_competitors: Integer,
           tags: T::Array[String],
-          timeout_ms: Integer,
+          timeout_opts:
+            ContextDev::WebExtractCompetitorsParams::TimeoutOpts::OrHash,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(ContextDev::Models::WebExtractCompetitorsResponse)
       end
@@ -112,10 +152,10 @@ module ContextDev
         # Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50
         # characters.
         tags: nil,
-        # Optional timeout in milliseconds for the request. If the request takes longer
-        # than this value, it will be aborted with a 408 status code. Maximum allowed
-        # value is 300000ms (5 minutes).
-        timeout_ms: nil,
+        # Optional request deadline and behavior on timeout. For GET requests, use
+        # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+        # timeoutOpts object.
+        timeout_opts: nil,
         request_options: {}
       )
       end
@@ -128,7 +168,7 @@ module ContextDev
           domain: String,
           max_age_ms: T.nilable(Integer),
           tags: T::Array[String],
-          timeout_ms: Integer,
+          timeout_opts: ContextDev::WebExtractFontsParams::TimeoutOpts::OrHash,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(ContextDev::Models::WebExtractFontsResponse)
       end
@@ -142,17 +182,17 @@ module ContextDev
         # 'domain' or 'directUrl', but not both.
         domain: nil,
         # Maximum age in milliseconds for cached brand data before the API performs a hard
-        # refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms)
-        # are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1
-        # year.
+        # refresh. Defaults to 3 months (7776000000 ms). Set to 0 to always perform a hard
+        # refresh. Negative values are clamped to 0; values above 1 year (31536000000 ms)
+        # are clamped to 1 year.
         max_age_ms: nil,
         # Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50
         # characters.
         tags: nil,
-        # Optional timeout in milliseconds for the request. If the request takes longer
-        # than this value, it will be aborted with a 408 status code. Maximum allowed
-        # value is 300000ms (5 minutes).
-        timeout_ms: nil,
+        # Optional request deadline and behavior on timeout. For GET requests, use
+        # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+        # timeoutOpts object.
+        timeout_opts: nil,
         request_options: {}
       )
       end
@@ -167,7 +207,8 @@ module ContextDev
           domain: String,
           max_age_ms: T.nilable(Integer),
           tags: T::Array[String],
-          timeout_ms: Integer,
+          timeout_opts:
+            ContextDev::WebExtractStyleguideParams::TimeoutOpts::OrHash,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(ContextDev::Models::WebExtractStyleguideResponse)
       end
@@ -185,17 +226,17 @@ module ContextDev
         # 'domain' or 'directUrl', but not both.
         domain: nil,
         # Maximum age in milliseconds for cached brand data before the API performs a hard
-        # refresh. Defaults to 3 months (7776000000 ms). Values below 1 day (86400000 ms)
-        # are clamped to 1 day; values above 1 year (31536000000 ms) are clamped to 1
-        # year.
+        # refresh. Defaults to 3 months (7776000000 ms). Set to 0 to always perform a hard
+        # refresh. Negative values are clamped to 0; values above 1 year (31536000000 ms)
+        # are clamped to 1 year.
         max_age_ms: nil,
         # Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50
         # characters.
         tags: nil,
-        # Optional timeout in milliseconds for the request. If the request takes longer
-        # than this value, it will be aborted with a 408 status code. Maximum allowed
-        # value is 300000ms (5 minutes).
-        timeout_ms: nil,
+        # Optional request deadline and behavior on timeout. For GET requests, use
+        # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+        # timeoutOpts object.
+        timeout_opts: nil,
         request_options: {}
       )
       end
@@ -215,7 +256,7 @@ module ContextDev
           page: ContextDev::WebScreenshotParams::Page::OrSymbol,
           scroll_offset: T.nilable(Integer),
           tags: T::Array[String],
-          timeout_ms: Integer,
+          timeout_opts: ContextDev::WebScreenshotParams::TimeoutOpts::OrHash,
           viewport: ContextDev::WebScreenshotParams::Viewport::OrHash,
           wait_for_ms: T.nilable(Integer),
           zdr: ContextDev::WebScreenshotParams::Zdr::OrSymbol,
@@ -271,16 +312,17 @@ module ContextDev
         # Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50
         # characters.
         tags: nil,
-        # Optional timeout in milliseconds for the request. If the request takes longer
-        # than this value, it will be aborted with a 408 status code. Maximum allowed
-        # value is 300000ms (5 minutes).
-        timeout_ms: nil,
+        # Optional request deadline and behavior on timeout. For GET requests, use
+        # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+        # timeoutOpts object.
+        timeout_opts: nil,
         # Optional browser viewport dimensions for the screenshot. Defaults to 1920x1080.
         viewport: nil,
         # Optional browser wait time in milliseconds after initial page load before taking
         # the screenshot. Min: 0. Max: 30000 (30 seconds). Defaults to 3000 ms when
-        # omitted. When combined with timeoutMS, timeoutMS must be at least waitForMs +
-        # 10000 ms; a shorter deadline is rejected with 400 TIMEOUT_TOO_SHORT_FOR_WAIT.
+        # omitted. When combined with timeoutOpts, timeoutOpts.milliseconds must be at
+        # least waitForMs + 10000 ms; a shorter deadline is rejected with 400
+        # TIMEOUT_TOO_SHORT_FOR_WAIT.
         wait_for_ms: nil,
         # Set to enabled to bypass shared caches and omit request and response content
         # from retained usage logs. Requires zero data retention to be enabled for your
@@ -304,7 +346,7 @@ module ContextDev
           num_results: Integer,
           query_fanout: T::Boolean,
           tags: T::Array[String],
-          timeout_ms: Integer,
+          timeout_opts: ContextDev::WebSearchParams::TimeoutOpts::OrHash,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(ContextDev::Models::WebSearchResponse)
       end
@@ -331,10 +373,10 @@ module ContextDev
         query_fanout: nil,
         # Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.
         tags: nil,
-        # Optional timeout in milliseconds for the request. If the request takes longer
-        # than this value, it will be aborted with a 408 status code. Maximum allowed
-        # value is 300000ms (5 minutes).
-        timeout_ms: nil,
+        # Optional request deadline and behavior on timeout. For GET requests, use
+        # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+        # timeoutOpts object.
+        timeout_opts: nil,
         request_options: {}
       )
       end
@@ -359,7 +401,7 @@ module ContextDev
           shorten_base64_images: T::Boolean,
           stop_after_ms: Integer,
           tags: T::Array[String],
-          timeout_ms: Integer,
+          timeout_opts: ContextDev::WebWebCrawlMdParams::TimeoutOpts::OrHash,
           url_regex: String,
           use_main_content_only: T::Boolean,
           wait_for_ms: Integer,
@@ -417,10 +459,10 @@ module ContextDev
         stop_after_ms: nil,
         # Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.
         tags: nil,
-        # Optional timeout in milliseconds for the request. If the request takes longer
-        # than this value, it will be aborted with a 408 status code. Maximum allowed
-        # value is 300000ms (5 minutes).
-        timeout_ms: nil,
+        # Optional request deadline and behavior on timeout. For GET requests, use
+        # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+        # timeoutOpts object.
+        timeout_opts: nil,
         # Regex pattern. Only URLs matching this pattern will be followed and scraped. An
         # automatic prefix scope in the form ^<starting URL> follows a redirect of the
         # starting page.
@@ -440,8 +482,62 @@ module ContextDev
       )
       end
 
+      # Downloads a resource and returns its bytes as base64. Supports images, PDFs,
+      # HTML pages, and any other content type without image conversion, text
+      # extraction, or character-encoding changes. HTTP compression is decoded before
+      # base64 encoding. HTML is the original HTTP response; JavaScript is not rendered.
+      # Follows public redirects and retries failed downloads through ISP and
+      # residential proxies, with a direct fallback. When country is specified, only a
+      # residential proxy in that country is used. Supply headers such as Referer for
+      # images that require a referring page. Downloads are not cached. Maximum decoded
+      # resource size: 20 MiB (20971520 bytes), before base64 encoding. Successful
+      # requests cost 1 credit; errors are not billed.
+      sig do
+        params(
+          url: String,
+          country: ContextDev::WebWebScrapeBytesParams::Country::OrSymbol,
+          headers: T::Hash[Symbol, String],
+          tags: T::Array[String],
+          timeout_opts:
+            ContextDev::WebWebScrapeBytesParams::TimeoutOpts::OrHash,
+          zdr: ContextDev::WebWebScrapeBytesParams::Zdr::OrSymbol,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(ContextDev::Models::WebWebScrapeBytesResponse)
+      end
+      def web_scrape_bytes(
+        # Full HTTP(S) URL of the resource to download, such as an image, PDF, or page.
+        url:,
+        # Fetch the target page through a residential proxy in this country (ISO 3166-1
+        # alpha-2).
+        country: nil,
+        # Optional outbound HTTP headers, such as Referer, Cookie, or Authorization. Send
+        # as a JSON object or deep-object query params such as
+        # headers[Referer]=https://example.com/. Host, Content-Length, and hop-by-hop
+        # transport headers are rejected. Authorization and cookies are removed when a
+        # redirect changes origin.
+        headers: nil,
+        # Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50
+        # characters.
+        tags: nil,
+        # Optional request deadline and behavior on timeout. For GET requests, use
+        # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+        # timeoutOpts object.
+        timeout_opts: nil,
+        # Set to enabled to bypass shared caches and omit request and response content
+        # from retained usage logs. Requires zero data retention to be enabled for your
+        # organization (contact support@context.dev), otherwise the request fails with
+        # ZDR_NOT_ENABLED. Successful ZDR responses include X-Context-ZDR: true.
+        zdr: nil,
+        request_options: {}
+      )
+      end
+
       # Scrapes the given URL and returns the raw HTML content of the page. The base
-      # request costs 1 credit; requests with browser actions cost 2 credits.
+      # request costs 1 credit; requests with browser actions cost 2 credits. A request
+      # that hits its timeoutOpts.milliseconds deadline fails with 408 and is not
+      # billed, unless timeoutOpts.behavior=return-partial is set — then the page as
+      # rendered so far is returned with `finalDOMState: "still-loading"` and billed at
+      # the base cost of 1 credit.
       sig do
         params(
           url: String,
@@ -464,7 +560,7 @@ module ContextDev
           pdf: ContextDev::WebWebScrapeHTMLParams::Pdf::OrHash,
           settle_animations: T::Boolean,
           tags: T::Array[String],
-          timeout_ms: Integer,
+          timeout_opts: ContextDev::WebWebScrapeHTMLParams::TimeoutOpts::OrHash,
           use_main_content_only: T::Boolean,
           wait_for_ms: T.nilable(Integer),
           zdr: ContextDev::WebWebScrapeHTMLParams::Zdr::OrSymbol,
@@ -509,16 +605,16 @@ module ContextDev
         # Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50
         # characters.
         tags: nil,
-        # Optional timeout in milliseconds for the request. If the request takes longer
-        # than this value, it will be aborted with a 408 status code. Maximum allowed
-        # value is 300000ms (5 minutes).
-        timeout_ms: nil,
+        # Optional request deadline and behavior on timeout. For GET requests, use
+        # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+        # timeoutOpts object.
+        timeout_opts: nil,
         # When true, return only the page's main content in the HTML response, excluding
         # headers, footers, sidebars, and navigation when detectable.
         use_main_content_only: nil,
         # Optional browser wait time in milliseconds after initial page load. Min: 0. Max:
-        # 30000 (30 seconds). When combined with timeoutMS, timeoutMS must be at least
-        # waitForMs + 10000 ms; a shorter deadline is rejected with 400
+        # 30000 (30 seconds). When combined with timeoutOpts, timeoutOpts.milliseconds
+        # must be at least waitForMs + 10000 ms; a shorter deadline is rejected with 400
         # TIMEOUT_TOO_SHORT_FOR_WAIT.
         wait_for_ms: nil,
         # Set to enabled to bypass shared caches and omit request and response content
@@ -554,7 +650,8 @@ module ContextDev
           headers: T::Hash[Symbol, String],
           max_age_ms: T.nilable(Integer),
           tags: T::Array[String],
-          timeout_ms: Integer,
+          timeout_opts:
+            ContextDev::WebWebScrapeImagesParams::TimeoutOpts::OrHash,
           wait_for_ms: T.nilable(Integer),
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(ContextDev::Models::WebWebScrapeImagesResponse)
@@ -584,14 +681,14 @@ module ContextDev
         # Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50
         # characters.
         tags: nil,
-        # Optional timeout in milliseconds for the request. If the request takes longer
-        # than this value, it will be aborted with a 408 status code. Maximum allowed
-        # value is 300000ms (5 minutes).
-        timeout_ms: nil,
+        # Optional request deadline and behavior on timeout. For GET requests, use
+        # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+        # timeoutOpts object.
+        timeout_opts: nil,
         # Optional browser wait time in milliseconds after initial page load before
         # collecting images. Min: 0. Max: 30000 (30 seconds). When combined with
-        # timeoutMS, timeoutMS must be at least waitForMs + 10000 ms; a shorter deadline
-        # is rejected with 400 TIMEOUT_TOO_SHORT_FOR_WAIT.
+        # timeoutOpts, timeoutOpts.milliseconds must be at least waitForMs + 10000 ms; a
+        # shorter deadline is rejected with 400 TIMEOUT_TOO_SHORT_FOR_WAIT.
         wait_for_ms: nil,
         request_options: {}
       )
@@ -617,11 +714,11 @@ module ContextDev
       #
       # | HTTP status | Billed?                                   | Meaning                                                                                                                                                                                                                                                                                                       |
       # | ----------- | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-      # | 200         | Yes — 1 credit, or 2 credits with actions | Successful scrape, including a zero-length result when includeSelectors matched nothing                                                                                                                                                                                                                       |
+      # | 200         | Yes — 1 credit, or 2 credits with actions | Successful scrape, including a zero-length result when includeSelectors matched nothing. A partial result (`finalDOMState: "still-loading"`, only with timeoutOpts.behavior=return-partial) is billed at the base 1 credit with no OCR or actions surcharge                                                   |
       # | 400         | No                                        | Invalid input, skipped PDF, or the page could not be scraped. error_code WEBSITE_BLOCKED specifically means the site answered with an anti-bot challenge, CAPTCHA wall, or login shell instead of the page (even when the site returned HTTP 200) — retrying later or from another country sometimes succeeds |
       # | 401 / 403   | No                                        | Invalid/disabled key, insufficient permissions, or credits exhausted; inspect error_code                                                                                                                                                                                                                      |
       # | 404         | No                                        | Target page returned or fingerprinted as not found                                                                                                                                                                                                                                                            |
-      # | 408         | No                                        | Request timed out                                                                                                                                                                                                                                                                                             |
+      # | 408         | No                                        | Request timed out. With timeoutOpts.behavior=return-partial this only happens when nothing usable had rendered by the deadline                                                                                                                                                                                |
       # | 413         | No                                        | Target content exceeds the maximum supported size (20 MB)                                                                                                                                                                                                                                                     |
       # | 415         | No                                        | Unsupported content type                                                                                                                                                                                                                                                                                      |
       # | 429         | No                                        | Per-minute rate limit exceeded; honor Retry-After                                                                                                                                                                                                                                                             |
@@ -652,7 +749,7 @@ module ContextDev
           settle_animations: T::Boolean,
           shorten_base64_images: T::Boolean,
           tags: T::Array[String],
-          timeout_ms: Integer,
+          timeout_opts: ContextDev::WebWebScrapeMdParams::TimeoutOpts::OrHash,
           use_main_content_only: T::Boolean,
           wait_for_ms: T.nilable(Integer),
           zdr: ContextDev::WebWebScrapeMdParams::Zdr::OrSymbol,
@@ -708,17 +805,17 @@ module ContextDev
         # Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50
         # characters.
         tags: nil,
-        # Optional timeout in milliseconds for the request. If the request takes longer
-        # than this value, it will be aborted with a 408 status code. Maximum allowed
-        # value is 300000ms (5 minutes).
-        timeout_ms: nil,
+        # Optional request deadline and behavior on timeout. For GET requests, use
+        # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+        # timeoutOpts object.
+        timeout_opts: nil,
         # Extract only the main content of the page, excluding headers, footers, sidebars,
         # and navigation
         use_main_content_only: nil,
         # Optional browser wait time in milliseconds after initial page load before
         # converting the page to Markdown. Min: 0. Max: 30000 (30 seconds). When combined
-        # with timeoutMS, timeoutMS must be at least waitForMs + 10000 ms; a shorter
-        # deadline is rejected with 400 TIMEOUT_TOO_SHORT_FOR_WAIT.
+        # with timeoutOpts, timeoutOpts.milliseconds must be at least waitForMs + 10000
+        # ms; a shorter deadline is rejected with 400 TIMEOUT_TOO_SHORT_FOR_WAIT.
         wait_for_ms: nil,
         # Set to enabled to bypass shared caches and omit request and response content
         # from retained usage logs. Requires zero data retention to be enabled for your
@@ -744,7 +841,8 @@ module ContextDev
           search: String,
           sitemap_url: String,
           tags: T::Array[String],
-          timeout_ms: Integer,
+          timeout_opts:
+            ContextDev::WebWebScrapeSitemapParams::TimeoutOpts::OrHash,
           url_regex: String,
           zdr: ContextDev::WebWebScrapeSitemapParams::Zdr::OrSymbol,
           request_options: ContextDev::RequestOptions::OrHash
@@ -773,10 +871,10 @@ module ContextDev
         # Comma-separated tags for tracking request usage. Up to 20 tags, each 1-50
         # characters.
         tags: nil,
-        # Optional timeout in milliseconds for the request. If the request takes longer
-        # than this value, it will be aborted with a 408 status code. Maximum allowed
-        # value is 300000ms (5 minutes).
-        timeout_ms: nil,
+        # Optional request deadline and behavior on timeout. For GET requests, use
+        # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+        # timeoutOpts object.
+        timeout_opts: nil,
         # Optional RE2-compatible regex pattern. Only URLs matching this pattern are
         # returned and counted against maxLinks.
         url_regex: nil,

data/sig/context_dev/models/ai_extract_product_params.rbs

@@ -5,7 +5,7 @@ module ContextDev
         url: String,
         max_age_ms: Integer,
         tags: ::Array[String],
-        timeout_ms: Integer
+        timeout_opts: ContextDev::AIExtractProductParams::TimeoutOpts
       }
       & ContextDev::Internal::Type::request_parameters
 
@@ -23,15 +23,17 @@ module ContextDev
 
       def tags=: (::Array[String]) -> ::Array[String]
 
-      attr_reader timeout_ms: Integer?
+      attr_reader timeout_opts: ContextDev::AIExtractProductParams::TimeoutOpts?
 
-      def timeout_ms=: (Integer) -> Integer
+      def timeout_opts=: (
+        ContextDev::AIExtractProductParams::TimeoutOpts
+      ) -> ContextDev::AIExtractProductParams::TimeoutOpts
 
       def initialize: (
         url: String,
         ?max_age_ms: Integer,
         ?tags: ::Array[String],
-        ?timeout_ms: Integer,
+        ?timeout_opts: ContextDev::AIExtractProductParams::TimeoutOpts,
         ?request_options: ContextDev::request_opts
       ) -> void
 
@@ -39,9 +41,46 @@ module ContextDev
         url: String,
         max_age_ms: Integer,
         tags: ::Array[String],
-        timeout_ms: Integer,
+        timeout_opts: ContextDev::AIExtractProductParams::TimeoutOpts,
         request_options: ContextDev::RequestOptions
       }
+
+      type timeout_opts =
+        {
+          milliseconds: Integer,
+          behavior: ContextDev::Models::AIExtractProductParams::TimeoutOpts::behavior
+        }
+
+      class TimeoutOpts < ContextDev::Internal::Type::BaseModel
+        attr_accessor milliseconds: Integer
+
+        attr_reader behavior: ContextDev::Models::AIExtractProductParams::TimeoutOpts::behavior?
+
+        def behavior=: (
+          ContextDev::Models::AIExtractProductParams::TimeoutOpts::behavior
+        ) -> ContextDev::Models::AIExtractProductParams::TimeoutOpts::behavior
+
+        def initialize: (
+          milliseconds: Integer,
+          ?behavior: ContextDev::Models::AIExtractProductParams::TimeoutOpts::behavior
+        ) -> void
+
+        def to_hash: -> {
+          milliseconds: Integer,
+          behavior: ContextDev::Models::AIExtractProductParams::TimeoutOpts::behavior
+        }
+
+        type behavior = :fail | :"return-partial"
+
+        module Behavior
+          extend ContextDev::Internal::Type::Enum
+
+          FAIL: :fail
+          RETURN_PARTIAL: :"return-partial"
+
+          def self?.values: -> ::Array[ContextDev::Models::AIExtractProductParams::TimeoutOpts::behavior]
+        end
+      end
     end
   end
 end

data/sig/context_dev/models/ai_extract_product_response.rbs

@@ -6,6 +6,7 @@ module ContextDev
         request_id: String,
         is_product_page: bool,
         key_metadata: ContextDev::Models::AIExtractProductResponse::KeyMetadata,
+        partial: bool,
         platform: ContextDev::Models::AIExtractProductResponse::platform?,
         product: ContextDev::Models::AIExtractProductResponse::Product?
       }
@@ -25,6 +26,10 @@ module ContextDev
         ContextDev::Models::AIExtractProductResponse::KeyMetadata
       ) -> ContextDev::Models::AIExtractProductResponse::KeyMetadata
 
+      attr_reader partial: bool?
+
+      def partial=: (bool) -> bool
+
       attr_accessor platform: ContextDev::Models::AIExtractProductResponse::platform?
 
       attr_accessor product: ContextDev::Models::AIExtractProductResponse::Product?
@@ -34,6 +39,7 @@ module ContextDev
         request_id: String,
         ?is_product_page: bool,
         ?key_metadata: ContextDev::Models::AIExtractProductResponse::KeyMetadata,
+        ?partial: bool,
         ?platform: ContextDev::Models::AIExtractProductResponse::platform?,
         ?product: ContextDev::Models::AIExtractProductResponse::Product?
       ) -> void
@@ -43,6 +49,7 @@ module ContextDev
         request_id: String,
         is_product_page: bool,
         key_metadata: ContextDev::Models::AIExtractProductResponse::KeyMetadata,
+        partial: bool,
         platform: ContextDev::Models::AIExtractProductResponse::platform?,
         product: ContextDev::Models::AIExtractProductResponse::Product?
       }