context.dev 2.15.0 → 2.16.0

data/lib/context_dev/models/web_screenshot_response.rb

@@ -12,6 +12,13 @@ module ContextDev
       #   @return [ContextDev::Models::WebScreenshotResponse::CacheMetadata]
       required :cache_metadata, -> { ContextDev::Models::WebScreenshotResponse::CacheMetadata }
 
+      # @!attribute request_id
+      #   Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #   it when contacting support about a failed request.
+      #
+      #   @return [String]
+      required :request_id, String
+
       # @!attribute code
       #   HTTP status code
       #
@@ -63,12 +70,14 @@ module ContextDev
       #   @return [Integer, nil]
       optional :width, Integer
 
-      # @!method initialize(cache_metadata:, code: nil, domain: nil, height: nil, key_metadata: nil, screenshot: nil, screenshot_type: nil, status: nil, width: nil)
+      # @!method initialize(cache_metadata:, request_id:, code: nil, domain: nil, height: nil, key_metadata: nil, screenshot: nil, screenshot_type: nil, status: nil, width: nil)
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebScreenshotResponse} for more details.
       #
       #   @param cache_metadata [ContextDev::Models::WebScreenshotResponse::CacheMetadata] Cache outcome for this response. Composite responses are hits only when every ca
       #
+      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #
       #   @param code [Integer] HTTP status code
       #
       #   @param domain [String] The normalized domain that was processed

data/lib/context_dev/models/web_search_response.rb

@@ -18,6 +18,13 @@ module ContextDev
       #   @return [String]
       required :query, String
 
+      # @!attribute request_id
+      #   Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #   it when contacting support about a failed request.
+      #
+      #   @return [String]
+      required :request_id, String
+
       # @!attribute results
       #
       #   @return [Array<ContextDev::Models::WebSearchResponse::Result>]
@@ -30,7 +37,7 @@ module ContextDev
       #   @return [ContextDev::Models::WebSearchResponse::KeyMetadata, nil]
       optional :key_metadata, -> { ContextDev::Models::WebSearchResponse::KeyMetadata }
 
-      # @!method initialize(cache_metadata:, query:, results:, key_metadata: nil)
+      # @!method initialize(cache_metadata:, query:, request_id:, results:, key_metadata: nil)
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebSearchResponse} for more details.
       #
@@ -38,6 +45,8 @@ module ContextDev
       #
       #   @param query [String] Echo of the original query (useful when fanout was enabled).
       #
+      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #
       #   @param results [Array<ContextDev::Models::WebSearchResponse::Result>]
       #
       #   @param key_metadata [ContextDev::Models::WebSearchResponse::KeyMetadata] Credit usage, included whenever a valid API key is provided.

data/lib/context_dev/models/web_web_crawl_md_response.rb

@@ -17,6 +17,13 @@ module ContextDev
       #   @return [ContextDev::Models::WebWebCrawlMdResponse::Metadata]
       required :metadata, -> { ContextDev::Models::WebWebCrawlMdResponse::Metadata }
 
+      # @!attribute request_id
+      #   Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #   it when contacting support about a failed request.
+      #
+      #   @return [String]
+      required :request_id, String
+
       # @!attribute results
       #
       #   @return [Array<ContextDev::Models::WebWebCrawlMdResponse::Result>]
@@ -29,7 +36,7 @@ module ContextDev
       #   @return [ContextDev::Models::WebWebCrawlMdResponse::KeyMetadata, nil]
       optional :key_metadata, -> { ContextDev::Models::WebWebCrawlMdResponse::KeyMetadata }
 
-      # @!method initialize(cache_metadata:, metadata:, results:, key_metadata: nil)
+      # @!method initialize(cache_metadata:, metadata:, request_id:, results:, key_metadata: nil)
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebWebCrawlMdResponse} for more details.
       #
@@ -37,6 +44,8 @@ module ContextDev
       #
       #   @param metadata [ContextDev::Models::WebWebCrawlMdResponse::Metadata]
       #
+      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #
       #   @param results [Array<ContextDev::Models::WebWebCrawlMdResponse::Result>]
       #
       #   @param key_metadata [ContextDev::Models::WebWebCrawlMdResponse::KeyMetadata] Credit usage, included whenever a valid API key is provided.

data/lib/context_dev/models/web_web_scrape_html_params.rb

@@ -107,7 +107,9 @@ module ContextDev
 
       # @!attribute wait_for_ms
       #   Optional browser wait time in milliseconds after initial page load. Min: 0. Max:
-      #   30000 (30 seconds).
+      #   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.
       #
       #   @return [Integer, nil]
       optional :wait_for_ms, Integer, nil?: true

data/lib/context_dev/models/web_web_scrape_html_response.rb

@@ -26,6 +26,13 @@ module ContextDev
       #   @return [ContextDev::Models::WebWebScrapeHTMLResponse::Metadata]
       required :metadata, -> { ContextDev::Models::WebWebScrapeHTMLResponse::Metadata }
 
+      # @!attribute request_id
+      #   Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #   it when contacting support about a failed request.
+      #
+      #   @return [String]
+      required :request_id, String
+
       # @!attribute success
       #   Indicates success
       #
@@ -68,7 +75,7 @@ module ContextDev
       #   @return [ContextDev::Models::WebWebScrapeHTMLResponse::KeyMetadata, nil]
       optional :key_metadata, -> { ContextDev::Models::WebWebScrapeHTMLResponse::KeyMetadata }
 
-      # @!method initialize(cache_metadata:, html:, metadata:, success:, type:, url:, actions_applied: nil, actions_html_stale: nil, key_metadata: nil)
+      # @!method initialize(cache_metadata:, html:, metadata:, request_id:, success:, type:, url:, actions_applied: nil, actions_html_stale: nil, key_metadata: nil)
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebWebScrapeHTMLResponse} for more details.
       #
@@ -78,6 +85,8 @@ module ContextDev
       #
       #   @param metadata [ContextDev::Models::WebWebScrapeHTMLResponse::Metadata] Metadata extracted from the scraped page HTML.
       #
+      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #
       #   @param success [Boolean, ContextDev::Models::WebWebScrapeHTMLResponse::Success] Indicates success
       #
       #   @param type [Symbol, ContextDev::Models::WebWebScrapeHTMLResponse::Type] Detected content type of the returned `html` field. Sitemaps and feeds are surfa

data/lib/context_dev/models/web_web_scrape_images_params.rb

@@ -73,7 +73,9 @@ module ContextDev
 
       # @!attribute wait_for_ms
       #   Optional browser wait time in milliseconds after initial page load before
-      #   collecting images. Min: 0. Max: 30000 (30 seconds).
+      #   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.
       #
       #   @return [Integer, nil]
       optional :wait_for_ms, Integer, nil?: true

data/lib/context_dev/models/web_web_scrape_images_response.rb

@@ -19,6 +19,13 @@ module ContextDev
       required :images,
                -> { ContextDev::Internal::Type::ArrayOf[ContextDev::Models::WebWebScrapeImagesResponse::Image] }
 
+      # @!attribute request_id
+      #   Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #   it when contacting support about a failed request.
+      #
+      #   @return [String]
+      required :request_id, String
+
       # @!attribute success
       #   Always true on success.
       #
@@ -45,7 +52,7 @@ module ContextDev
       #   @return [ContextDev::Models::WebWebScrapeImagesResponse::KeyMetadata, nil]
       optional :key_metadata, -> { ContextDev::Models::WebWebScrapeImagesResponse::KeyMetadata }
 
-      # @!method initialize(cache_metadata:, images:, success:, url:, actions_applied: nil, key_metadata: nil)
+      # @!method initialize(cache_metadata:, images:, request_id:, success:, url:, actions_applied: nil, key_metadata: nil)
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebWebScrapeImagesResponse} for more details.
       #
@@ -53,6 +60,8 @@ module ContextDev
       #
       #   @param images [Array<ContextDev::Models::WebWebScrapeImagesResponse::Image>] Images found on the page.
       #
+      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #
       #   @param success [Boolean, ContextDev::Models::WebWebScrapeImagesResponse::Success] Always true on success.
       #
       #   @param url [String] Page URL that was scraped.

data/lib/context_dev/models/web_web_scrape_md_params.rb

@@ -134,7 +134,9 @@ module ContextDev
 
       # @!attribute wait_for_ms
       #   Optional browser wait time in milliseconds after initial page load before
-      #   converting the page to Markdown. Min: 0. Max: 30000 (30 seconds).
+      #   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.
       #
       #   @return [Integer, nil]
       optional :wait_for_ms, Integer, nil?: true

data/lib/context_dev/models/web_web_scrape_md_response.rb

@@ -32,6 +32,13 @@ module ContextDev
       #   @return [ContextDev::Models::WebWebScrapeMdResponse::Metadata]
       required :metadata, -> { ContextDev::Models::WebWebScrapeMdResponse::Metadata }
 
+      # @!attribute request_id
+      #   Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #   it when contacting support about a failed request.
+      #
+      #   @return [String]
+      required :request_id, String
+
       # @!attribute success
       #   Indicates success
       #
@@ -73,7 +80,7 @@ module ContextDev
       #   @return [ContextDev::Models::WebWebScrapeMdResponse::KeyMetadata, nil]
       optional :key_metadata, -> { ContextDev::Models::WebWebScrapeMdResponse::KeyMetadata }
 
-      # @!method initialize(cache_metadata:, content_length:, markdown:, metadata:, success:, url:, actions_applied: nil, actions_html_stale: nil, html: nil, key_metadata: nil)
+      # @!method initialize(cache_metadata:, content_length:, markdown:, metadata:, request_id:, success:, url:, actions_applied: nil, actions_html_stale: nil, html: nil, key_metadata: nil)
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebWebScrapeMdResponse} for more details.
       #
@@ -85,6 +92,8 @@ module ContextDev
       #
       #   @param metadata [ContextDev::Models::WebWebScrapeMdResponse::Metadata] Metadata extracted from the scraped page HTML.
       #
+      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #
       #   @param success [Boolean, ContextDev::Models::WebWebScrapeMdResponse::Success] Indicates success
       #
       #   @param url [String] The URL that was scraped

data/lib/context_dev/models/web_web_scrape_sitemap_response.rb

@@ -16,6 +16,13 @@ module ContextDev
       #   @return [ContextDev::Models::WebWebScrapeSitemapResponse::Meta]
       required :meta, -> { ContextDev::Models::WebWebScrapeSitemapResponse::Meta }
 
+      # @!attribute request_id
+      #   Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #   it when contacting support about a failed request.
+      #
+      #   @return [String]
+      required :request_id, String
+
       # @!attribute success
       #   Indicates success
       #
@@ -35,7 +42,7 @@ module ContextDev
       #   @return [ContextDev::Models::WebWebScrapeSitemapResponse::KeyMetadata, nil]
       optional :key_metadata, -> { ContextDev::Models::WebWebScrapeSitemapResponse::KeyMetadata }
 
-      # @!method initialize(domain:, meta:, success:, urls:, key_metadata: nil)
+      # @!method initialize(domain:, meta:, request_id:, success:, urls:, key_metadata: nil)
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebWebScrapeSitemapResponse} for more details.
       #
@@ -43,6 +50,8 @@ module ContextDev
       #
       #   @param meta [ContextDev::Models::WebWebScrapeSitemapResponse::Meta] Metadata about the sitemap crawl operation
       #
+      #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      #
       #   @param success [Boolean, ContextDev::Models::WebWebScrapeSitemapResponse::Success] Indicates success
       #
       #   @param urls [Array<String>] Discovered page URLs from the sitemap, up to `maxLinks`. When `search` is set th

data/lib/context_dev/models/webhooks/delivery_list_attempts_response.rb

@@ -23,19 +23,31 @@ module ContextDev
         #   @return [String, nil]
         required :next_cursor, String, nil?: true
 
+        # @!attribute request_id
+        #   Unique id of this API call, also sent in the X-Request-Id response header. Quote
+        #   it when contacting support about a failed request.
+        #
+        #   @return [String]
+        required :request_id, String
+
         # @!attribute key_metadata
         #   Credit usage, included whenever a valid API key is provided.
         #
         #   @return [ContextDev::Models::Webhooks::DeliveryListAttemptsResponse::KeyMetadata, nil]
         optional :key_metadata, -> { ContextDev::Models::Webhooks::DeliveryListAttemptsResponse::KeyMetadata }
 
-        # @!method initialize(data:, has_more:, next_cursor:, key_metadata: nil)
+        # @!method initialize(data:, has_more:, next_cursor:, request_id:, key_metadata: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {ContextDev::Models::Webhooks::DeliveryListAttemptsResponse} for more details.
+        #
         #   @param data [Array<ContextDev::Models::Webhooks::Attempt>] Delivery attempts.
         #
         #   @param has_more [Boolean] Whether more attempts are available.
         #
         #   @param next_cursor [String, nil] Next page cursor, or null on the last page.
         #
+        #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+        #
         #   @param key_metadata [ContextDev::Models::Webhooks::DeliveryListAttemptsResponse::KeyMetadata] Credit usage, included whenever a valid API key is provided.
 
         # @see ContextDev::Models::Webhooks::DeliveryListAttemptsResponse#key_metadata

data/lib/context_dev/models/webhooks/delivery_list_response.rb

@@ -23,19 +23,31 @@ module ContextDev
         #   @return [String, nil]
         required :next_cursor, String, nil?: true
 
+        # @!attribute request_id
+        #   Unique id of this API call, also sent in the X-Request-Id response header. Quote
+        #   it when contacting support about a failed request.
+        #
+        #   @return [String]
+        required :request_id, String
+
         # @!attribute key_metadata
         #   Credit usage, included whenever a valid API key is provided.
         #
         #   @return [ContextDev::Models::Webhooks::DeliveryListResponse::KeyMetadata, nil]
         optional :key_metadata, -> { ContextDev::Models::Webhooks::DeliveryListResponse::KeyMetadata }
 
-        # @!method initialize(data:, has_more:, next_cursor:, key_metadata: nil)
+        # @!method initialize(data:, has_more:, next_cursor:, request_id:, key_metadata: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {ContextDev::Models::Webhooks::DeliveryListResponse} for more details.
+        #
         #   @param data [Array<ContextDev::Models::Webhooks::DeliverySummary>] Webhook deliveries.
         #
         #   @param has_more [Boolean] Whether more deliveries are available.
         #
         #   @param next_cursor [String, nil] Next page cursor, or null on the last page.
         #
+        #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+        #
         #   @param key_metadata [ContextDev::Models::Webhooks::DeliveryListResponse::KeyMetadata] Credit usage, included whenever a valid API key is provided.
 
         # @see ContextDev::Models::Webhooks::DeliveryListResponse#key_metadata

data/lib/context_dev/models/webhooks/delivery_retrieve_response.rb

@@ -5,13 +5,25 @@ module ContextDev
     module Webhooks
       # @see ContextDev::Resources::Webhooks::Deliveries#retrieve
       class DeliveryRetrieveResponse < ContextDev::Models::Webhooks::Delivery
+        # @!attribute request_id
+        #   Unique id of this API call, also sent in the X-Request-Id response header. Quote
+        #   it when contacting support about a failed request.
+        #
+        #   @return [String]
+        required :request_id, String
+
         # @!attribute key_metadata
         #   Credit usage, included whenever a valid API key is provided.
         #
         #   @return [ContextDev::Models::Webhooks::DeliveryRetrieveResponse::KeyMetadata, nil]
         optional :key_metadata, -> { ContextDev::Models::Webhooks::DeliveryRetrieveResponse::KeyMetadata }
 
-        # @!method initialize(key_metadata: nil)
+        # @!method initialize(request_id:, key_metadata: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {ContextDev::Models::Webhooks::DeliveryRetrieveResponse} for more details.
+        #
+        #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+        #
         #   @param key_metadata [ContextDev::Models::Webhooks::DeliveryRetrieveResponse::KeyMetadata] Credit usage, included whenever a valid API key is provided.
 
         class KeyMetadata < ContextDev::Internal::Type::BaseModel

data/lib/context_dev/models/webhooks/delivery_retry_response.rb

@@ -11,15 +11,27 @@ module ContextDev
         #   @return [String]
         required :id, String
 
+        # @!attribute request_id
+        #   Unique id of this API call, also sent in the X-Request-Id response header. Quote
+        #   it when contacting support about a failed request.
+        #
+        #   @return [String]
+        required :request_id, String
+
         # @!attribute key_metadata
         #   Credit usage, included whenever a valid API key is provided.
         #
         #   @return [ContextDev::Models::Webhooks::DeliveryRetryResponse::KeyMetadata, nil]
         optional :key_metadata, -> { ContextDev::Models::Webhooks::DeliveryRetryResponse::KeyMetadata }
 
-        # @!method initialize(id:, key_metadata: nil)
+        # @!method initialize(id:, request_id:, key_metadata: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {ContextDev::Models::Webhooks::DeliveryRetryResponse} for more details.
+        #
         #   @param id [String] Delivery ID.
         #
+        #   @param request_id [String] Unique id of this API call, also sent in the X-Request-Id response header. Quote
+        #
         #   @param key_metadata [ContextDev::Models::Webhooks::DeliveryRetryResponse::KeyMetadata] Credit usage, included whenever a valid API key is provided.
 
         # @see ContextDev::Models::Webhooks::DeliveryRetryResponse#key_metadata

data/lib/context_dev/models.rb

@@ -71,6 +71,10 @@ module ContextDev
 
   Intake = ContextDev::Models::Intake
 
+  LogListParams = ContextDev::Models::LogListParams
+
+  LogRetrieveParams = ContextDev::Models::LogRetrieveParams
+
   MonitorCreateParams = ContextDev::Models::MonitorCreateParams
 
   MonitorDeleteParams = ContextDev::Models::MonitorDeleteParams

data/lib/context_dev/resources/logs.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Resources
+    # Read your organization's API request logs to debug failed calls. These endpoints
+    # cost no credits and use a separate rate limit.
+    class Logs
+      # Get one logged API call, including its request input and response body.
+      #
+      # @overload retrieve(request_id, request_options: {})
+      #
+      # @param request_id [String] The request ID of the logged API call.
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::LogRetrieveResponse]
+      #
+      # @see ContextDev::Models::LogRetrieveParams
+      def retrieve(request_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["logs/%1$s", request_id],
+          model: ContextDev::Models::LogRetrieveResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {ContextDev::Models::LogListParams} for more details.
+      #
+      # List your organization's API requests, newest first. Defaults to the last 24
+      # hours.
+      #
+      # @overload list(error_code: nil, errors_only: nil, from: nil, key_id: nil, limit: nil, page: nil, path: nil, search: nil, status_code: nil, tags: nil, to: nil, request_options: {})
+      #
+      # @param error_code [String] Filter by the `error_code` returned in the response.
+      #
+      # @param errors_only [Boolean] Only include requests that returned a 4xx or 5xx status.
+      #
+      # @param from [Time] Only include requests at or after this ISO 8601 timestamp. Defaults to 24 hours
+      #
+      # @param key_id [String] Filter by the API key that made the request.
+      #
+      # @param limit [Integer] Number of log entries per page.
+      #
+      # @param page [Integer] Page number, starting at 1.
+      #
+      # @param path [String] Filter by endpoint path, with or without the /v1 prefix.
+      #
+      # @param search [String] Case-insensitive substring match against the request query and body, e.g. a doma
+      #
+      # @param status_code [Integer] Filter by exact HTTP status code.
+      #
+      # @param tags [String] Comma-separated request tags. Matches requests carrying any of them. Up to 20 ta
+      #
+      # @param to [Time] Only include requests at or before this ISO 8601 timestamp. Defaults to now.
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::LogListResponse]
+      #
+      # @see ContextDev::Models::LogListParams
+      def list(params = {})
+        parsed, options = ContextDev::LogListParams.dump_request(params)
+        query = ContextDev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "logs",
+          query: query,
+          model: ContextDev::Models::LogListResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [ContextDev::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/context_dev/version.rb

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

data/lib/context_dev.rb

@@ -82,6 +82,10 @@ require_relative "context_dev/models/industry_retrieve_naics_response"
 require_relative "context_dev/models/industry_retrieve_sic_params"
 require_relative "context_dev/models/industry_retrieve_sic_response"
 require_relative "context_dev/models/intake"
+require_relative "context_dev/models/log_list_params"
+require_relative "context_dev/models/log_list_response"
+require_relative "context_dev/models/log_retrieve_params"
+require_relative "context_dev/models/log_retrieve_response"
 require_relative "context_dev/models/monitor_create_params"
 require_relative "context_dev/models/monitor_create_response"
 require_relative "context_dev/models/monitor_delete_params"
@@ -156,6 +160,7 @@ require_relative "context_dev/resources/ai"
 require_relative "context_dev/resources/batch"
 require_relative "context_dev/resources/brand"
 require_relative "context_dev/resources/industry"
+require_relative "context_dev/resources/logs"
 require_relative "context_dev/resources/monitors"
 require_relative "context_dev/resources/news"
 require_relative "context_dev/resources/parse"

data/rbi/context_dev/client.rbi

@@ -52,6 +52,11 @@ module ContextDev
     sig { returns(ContextDev::Resources::News) }
     attr_reader :news
 
+    # Read your organization's API request logs to debug failed calls. These endpoints
+    # cost no credits and use a separate rate limit.
+    sig { returns(ContextDev::Resources::Logs) }
+    attr_reader :logs
+
     # @api private
     sig { override.returns(T::Hash[String, String]) }
     private def auth_headers

data/rbi/context_dev/models/ai_extract_product_response.rbi

@@ -27,6 +27,11 @@ module ContextDev
       end
       attr_writer :cache_metadata
 
+      # Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      # it when contacting support about a failed request.
+      sig { returns(String) }
+      attr_accessor :request_id
+
       # Whether the given URL is a product detail page
       sig { returns(T.nilable(T::Boolean)) }
       attr_reader :is_product_page
@@ -82,6 +87,7 @@ module ContextDev
         params(
           cache_metadata:
             ContextDev::Models::AIExtractProductResponse::CacheMetadata::OrHash,
+          request_id: String,
           is_product_page: T::Boolean,
           key_metadata:
             ContextDev::Models::AIExtractProductResponse::KeyMetadata::OrHash,
@@ -100,6 +106,9 @@ module ContextDev
         # cache-controlled fetch contributing to the output was a hit; age_ms is the
         # oldest contributing hit.
         cache_metadata:,
+        # Unique id of this API call, also sent in the X-Request-Id response header. Quote
+        # it when contacting support about a failed request.
+        request_id:,
         # Whether the given URL is a product detail page
         is_product_page: nil,
         # Credit usage, included whenever a valid API key is provided.
@@ -116,6 +125,7 @@ module ContextDev
           {
             cache_metadata:
               ContextDev::Models::AIExtractProductResponse::CacheMetadata,
+            request_id: String,
             is_product_page: T::Boolean,
             key_metadata:
               ContextDev::Models::AIExtractProductResponse::KeyMetadata,

data/rbi/context_dev/models/ai_extract_products_response.rbi

@@ -27,6 +27,11 @@ module ContextDev
       end
       attr_writer :cache_metadata
 
+      # Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      # it when contacting support about a failed request.
+      sig { returns(String) }
+      attr_accessor :request_id
+
       # Credit usage, included whenever a valid API key is provided.
       sig do
         returns(
@@ -67,6 +72,7 @@ module ContextDev
         params(
           cache_metadata:
             ContextDev::Models::AIExtractProductsResponse::CacheMetadata::OrHash,
+          request_id: String,
           key_metadata:
             ContextDev::Models::AIExtractProductsResponse::KeyMetadata::OrHash,
           products:
@@ -80,6 +86,9 @@ module ContextDev
         # cache-controlled fetch contributing to the output was a hit; age_ms is the
         # oldest contributing hit.
         cache_metadata:,
+        # Unique id of this API call, also sent in the X-Request-Id response header. Quote
+        # it when contacting support about a failed request.
+        request_id:,
         # Credit usage, included whenever a valid API key is provided.
         key_metadata: nil,
         # Array of products extracted from the website
@@ -92,6 +101,7 @@ module ContextDev
           {
             cache_metadata:
               ContextDev::Models::AIExtractProductsResponse::CacheMetadata,
+            request_id: String,
             key_metadata:
               ContextDev::Models::AIExtractProductsResponse::KeyMetadata,
             products:

data/rbi/context_dev/models/batch_cancel_response.rbi

@@ -68,6 +68,11 @@ module ContextDev
       end
       attr_writer :progress
 
+      # Unique id of this API call, also sent in the X-Request-Id response header. Quote
+      # it when contacting support about a failed request.
+      sig { returns(String) }
+      attr_accessor :request_id
+
       # Always `cancelling`. Work already in flight finishes; the batch reaches
       # `cancelled` shortly after.
       sig do
@@ -114,6 +119,7 @@ module ContextDev
           mode: ContextDev::Models::BatchCancelResponse::Mode::OrSymbol,
           page_errors: T::Array[ContextDev::PageErrorCount::OrHash],
           progress: ContextDev::Models::BatchCancelResponse::Progress::OrHash,
+          request_id: String,
           status: ContextDev::Models::BatchCancelResponse::Status::OrSymbol,
           tags: T::Array[String],
           timing: ContextDev::Models::BatchCancelResponse::Timing::OrHash,
@@ -139,6 +145,9 @@ module ContextDev
         page_errors:,
         # How far the batch got before cancellation.
         progress:,
+        # Unique id of this API call, also sent in the X-Request-Id response header. Quote
+        # it when contacting support about a failed request.
+        request_id:,
         # Always `cancelling`. Work already in flight finishes; the batch reaches
         # `cancelled` shortly after.
         status:,
@@ -163,6 +172,7 @@ module ContextDev
             mode: ContextDev::Models::BatchCancelResponse::Mode::TaggedSymbol,
             page_errors: T::Array[ContextDev::PageErrorCount],
             progress: ContextDev::Models::BatchCancelResponse::Progress,
+            request_id: String,
             status:
               ContextDev::Models::BatchCancelResponse::Status::TaggedSymbol,
             tags: T::Array[String],