context.dev 2.5.0 → 2.7.0

data/lib/context_dev/models/monitor_list_response.rb

@@ -187,7 +187,7 @@ module ContextDev
           # Detect exact changes. For page targets, this means visible text diffs. For sitemap targets, this means URL additions and removals.
           variant :exact, -> { ContextDev::Models::MonitorListResponse::Data::ChangeDetection::Exact }
 
-          # Detect meaning-level changes to tracked page content, ignoring cosmetic or paraphrase-only differences. Which changes are meaningful is judged against the extract target's `instructions` (and `schema`, when provided).
+          # Detect meaning-level changes to page content, ignoring cosmetic or instruction-irrelevant differences. Which changes are meaningful is judged against the page or extract target's `instructions` (and an extract target's `schema`, when provided).
           variant :semantic, -> { ContextDev::Models::MonitorListResponse::Data::ChangeDetection::Semantic }
 
           class Exact < ContextDev::Internal::Type::BaseModel
@@ -215,9 +215,10 @@ module ContextDev
             optional :confidence_threshold, Float
 
             # @!method initialize(confidence_threshold: nil, type: :semantic)
-            #   Detect meaning-level changes to tracked page content, ignoring cosmetic or
-            #   paraphrase-only differences. Which changes are meaningful is judged against the
-            #   extract target's `instructions` (and `schema`, when provided).
+            #   Detect meaning-level changes to page content, ignoring cosmetic or
+            #   instruction-irrelevant differences. Which changes are meaningful is judged
+            #   against the page or extract target's `instructions` (and an extract target's
+            #   `schema`, when provided).
             #
             #   @param confidence_threshold [Float]
             #   @param type [Symbol, :semantic]
@@ -323,7 +324,7 @@ module ContextDev
 
           discriminator :type
 
-          # Watch a single web page.
+          # Watch a single web page. Exact detection reports visible-text diffs; semantic detection judges confirmed stable diffs against `instructions`.
           variant :page, -> { ContextDev::Models::MonitorListResponse::Data::Target::Page }
 
           # Watch a sitemap for URL additions and removals. Crawled URLs are normalized (lowercased host, no trailing slash/fragment) and scoped to the monitored site and its subdomains before comparison. On a detected difference the sitemap is re-fetched within the same run and only URLs both observations agree on are reported, suppressing transient crawl flaps.
@@ -343,17 +344,30 @@ module ContextDev
             #   @return [String]
             required :url, String
 
+            # @!attribute instructions
+            #   Plain-language goal describing which page changes matter. When provided without
+            #   change_detection, semantic detection is inferred.
+            #
+            #   @return [String, nil]
+            optional :instructions, String
+
             # @!attribute normalize_whitespace
             #   Normalize whitespace before comparing or analyzing text.
             #
             #   @return [Boolean, nil]
             optional :normalize_whitespace, ContextDev::Internal::Type::Boolean
 
-            # @!method initialize(url:, normalize_whitespace: nil, type: :page)
-            #   Watch a single web page.
+            # @!method initialize(url:, instructions: nil, normalize_whitespace: nil, type: :page)
+            #   Some parameter documentations has been truncated, see
+            #   {ContextDev::Models::MonitorListResponse::Data::Target::Page} for more details.
+            #
+            #   Watch a single web page. Exact detection reports visible-text diffs; semantic
+            #   detection judges confirmed stable diffs against `instructions`.
             #
             #   @param url [String]
             #
+            #   @param instructions [String] Plain-language goal describing which page changes matter. When provided without
+            #
             #   @param normalize_whitespace [Boolean] Normalize whitespace before comparing or analyzing text.
             #
             #   @param type [Symbol, :page]

data/lib/context_dev/models/monitor_retrieve_response.rb

@@ -164,7 +164,7 @@ module ContextDev
         # Detect exact changes. For page targets, this means visible text diffs. For sitemap targets, this means URL additions and removals.
         variant :exact, -> { ContextDev::Models::MonitorRetrieveResponse::ChangeDetection::Exact }
 
-        # Detect meaning-level changes to tracked page content, ignoring cosmetic or paraphrase-only differences. Which changes are meaningful is judged against the extract target's `instructions` (and `schema`, when provided).
+        # Detect meaning-level changes to page content, ignoring cosmetic or instruction-irrelevant differences. Which changes are meaningful is judged against the page or extract target's `instructions` (and an extract target's `schema`, when provided).
         variant :semantic, -> { ContextDev::Models::MonitorRetrieveResponse::ChangeDetection::Semantic }
 
         class Exact < ContextDev::Internal::Type::BaseModel
@@ -192,9 +192,10 @@ module ContextDev
           optional :confidence_threshold, Float
 
           # @!method initialize(confidence_threshold: nil, type: :semantic)
-          #   Detect meaning-level changes to tracked page content, ignoring cosmetic or
-          #   paraphrase-only differences. Which changes are meaningful is judged against the
-          #   extract target's `instructions` (and `schema`, when provided).
+          #   Detect meaning-level changes to page content, ignoring cosmetic or
+          #   instruction-irrelevant differences. Which changes are meaningful is judged
+          #   against the page or extract target's `instructions` (and an extract target's
+          #   `schema`, when provided).
           #
           #   @param confidence_threshold [Float]
           #   @param type [Symbol, :semantic]
@@ -300,7 +301,7 @@ module ContextDev
 
         discriminator :type
 
-        # Watch a single web page.
+        # Watch a single web page. Exact detection reports visible-text diffs; semantic detection judges confirmed stable diffs against `instructions`.
         variant :page, -> { ContextDev::Models::MonitorRetrieveResponse::Target::Page }
 
         # Watch a sitemap for URL additions and removals. Crawled URLs are normalized (lowercased host, no trailing slash/fragment) and scoped to the monitored site and its subdomains before comparison. On a detected difference the sitemap is re-fetched within the same run and only URLs both observations agree on are reported, suppressing transient crawl flaps.
@@ -320,17 +321,30 @@ module ContextDev
           #   @return [String]
           required :url, String
 
+          # @!attribute instructions
+          #   Plain-language goal describing which page changes matter. When provided without
+          #   change_detection, semantic detection is inferred.
+          #
+          #   @return [String, nil]
+          optional :instructions, String
+
           # @!attribute normalize_whitespace
           #   Normalize whitespace before comparing or analyzing text.
           #
           #   @return [Boolean, nil]
           optional :normalize_whitespace, ContextDev::Internal::Type::Boolean
 
-          # @!method initialize(url:, normalize_whitespace: nil, type: :page)
-          #   Watch a single web page.
+          # @!method initialize(url:, instructions: nil, normalize_whitespace: nil, type: :page)
+          #   Some parameter documentations has been truncated, see
+          #   {ContextDev::Models::MonitorRetrieveResponse::Target::Page} for more details.
+          #
+          #   Watch a single web page. Exact detection reports visible-text diffs; semantic
+          #   detection judges confirmed stable diffs against `instructions`.
           #
           #   @param url [String]
           #
+          #   @param instructions [String] Plain-language goal describing which page changes matter. When provided without
+          #
           #   @param normalize_whitespace [Boolean] Normalize whitespace before comparing or analyzing text.
           #
           #   @param type [Symbol, :page]

data/lib/context_dev/models/monitor_update_params.rb

@@ -86,7 +86,7 @@ module ContextDev
         # Detect exact changes. For page targets, this means visible text diffs. For sitemap targets, this means URL additions and removals.
         variant :exact, -> { ContextDev::MonitorUpdateParams::ChangeDetection::Exact }
 
-        # Detect meaning-level changes to tracked page content, ignoring cosmetic or paraphrase-only differences. Which changes are meaningful is judged against the extract target's `instructions` (and `schema`, when provided).
+        # Detect meaning-level changes to page content, ignoring cosmetic or instruction-irrelevant differences. Which changes are meaningful is judged against the page or extract target's `instructions` (and an extract target's `schema`, when provided).
         variant :semantic, -> { ContextDev::MonitorUpdateParams::ChangeDetection::Semantic }
 
         class Exact < ContextDev::Internal::Type::BaseModel
@@ -114,9 +114,10 @@ module ContextDev
           optional :confidence_threshold, Float
 
           # @!method initialize(confidence_threshold: nil, type: :semantic)
-          #   Detect meaning-level changes to tracked page content, ignoring cosmetic or
-          #   paraphrase-only differences. Which changes are meaningful is judged against the
-          #   extract target's `instructions` (and `schema`, when provided).
+          #   Detect meaning-level changes to page content, ignoring cosmetic or
+          #   instruction-irrelevant differences. Which changes are meaningful is judged
+          #   against the page or extract target's `instructions` (and an extract target's
+          #   `schema`, when provided).
           #
           #   @param confidence_threshold [Float]
           #   @param type [Symbol, :semantic]
@@ -198,7 +199,7 @@ module ContextDev
 
         discriminator :type
 
-        # Watch a single web page.
+        # Watch a single web page. Exact detection reports visible-text diffs; semantic detection judges confirmed stable diffs against `instructions`.
         variant :page, -> { ContextDev::MonitorUpdateParams::Target::Page }
 
         # Watch a sitemap for URL additions and removals. Crawled URLs are normalized (lowercased host, no trailing slash/fragment) and scoped to the monitored site and its subdomains before comparison. On a detected difference the sitemap is re-fetched within the same run and only URLs both observations agree on are reported, suppressing transient crawl flaps.
@@ -218,17 +219,30 @@ module ContextDev
           #   @return [String]
           required :url, String
 
+          # @!attribute instructions
+          #   Plain-language goal describing which page changes matter. When provided without
+          #   change_detection, semantic detection is inferred.
+          #
+          #   @return [String, nil]
+          optional :instructions, String
+
           # @!attribute normalize_whitespace
           #   Normalize whitespace before comparing or analyzing text.
           #
           #   @return [Boolean, nil]
           optional :normalize_whitespace, ContextDev::Internal::Type::Boolean
 
-          # @!method initialize(url:, normalize_whitespace: nil, type: :page)
-          #   Watch a single web page.
+          # @!method initialize(url:, instructions: nil, normalize_whitespace: nil, type: :page)
+          #   Some parameter documentations has been truncated, see
+          #   {ContextDev::Models::MonitorUpdateParams::Target::Page} for more details.
+          #
+          #   Watch a single web page. Exact detection reports visible-text diffs; semantic
+          #   detection judges confirmed stable diffs against `instructions`.
           #
           #   @param url [String]
           #
+          #   @param instructions [String] Plain-language goal describing which page changes matter. When provided without
+          #
           #   @param normalize_whitespace [Boolean] Normalize whitespace before comparing or analyzing text.
           #
           #   @param type [Symbol, :page]

data/lib/context_dev/models/monitor_update_response.rb

@@ -164,7 +164,7 @@ module ContextDev
         # Detect exact changes. For page targets, this means visible text diffs. For sitemap targets, this means URL additions and removals.
         variant :exact, -> { ContextDev::Models::MonitorUpdateResponse::ChangeDetection::Exact }
 
-        # Detect meaning-level changes to tracked page content, ignoring cosmetic or paraphrase-only differences. Which changes are meaningful is judged against the extract target's `instructions` (and `schema`, when provided).
+        # Detect meaning-level changes to page content, ignoring cosmetic or instruction-irrelevant differences. Which changes are meaningful is judged against the page or extract target's `instructions` (and an extract target's `schema`, when provided).
         variant :semantic, -> { ContextDev::Models::MonitorUpdateResponse::ChangeDetection::Semantic }
 
         class Exact < ContextDev::Internal::Type::BaseModel
@@ -192,9 +192,10 @@ module ContextDev
           optional :confidence_threshold, Float
 
           # @!method initialize(confidence_threshold: nil, type: :semantic)
-          #   Detect meaning-level changes to tracked page content, ignoring cosmetic or
-          #   paraphrase-only differences. Which changes are meaningful is judged against the
-          #   extract target's `instructions` (and `schema`, when provided).
+          #   Detect meaning-level changes to page content, ignoring cosmetic or
+          #   instruction-irrelevant differences. Which changes are meaningful is judged
+          #   against the page or extract target's `instructions` (and an extract target's
+          #   `schema`, when provided).
           #
           #   @param confidence_threshold [Float]
           #   @param type [Symbol, :semantic]
@@ -300,7 +301,7 @@ module ContextDev
 
         discriminator :type
 
-        # Watch a single web page.
+        # Watch a single web page. Exact detection reports visible-text diffs; semantic detection judges confirmed stable diffs against `instructions`.
         variant :page, -> { ContextDev::Models::MonitorUpdateResponse::Target::Page }
 
         # Watch a sitemap for URL additions and removals. Crawled URLs are normalized (lowercased host, no trailing slash/fragment) and scoped to the monitored site and its subdomains before comparison. On a detected difference the sitemap is re-fetched within the same run and only URLs both observations agree on are reported, suppressing transient crawl flaps.
@@ -320,17 +321,30 @@ module ContextDev
           #   @return [String]
           required :url, String
 
+          # @!attribute instructions
+          #   Plain-language goal describing which page changes matter. When provided without
+          #   change_detection, semantic detection is inferred.
+          #
+          #   @return [String, nil]
+          optional :instructions, String
+
           # @!attribute normalize_whitespace
           #   Normalize whitespace before comparing or analyzing text.
           #
           #   @return [Boolean, nil]
           optional :normalize_whitespace, ContextDev::Internal::Type::Boolean
 
-          # @!method initialize(url:, normalize_whitespace: nil, type: :page)
-          #   Watch a single web page.
+          # @!method initialize(url:, instructions: nil, normalize_whitespace: nil, type: :page)
+          #   Some parameter documentations has been truncated, see
+          #   {ContextDev::Models::MonitorUpdateResponse::Target::Page} for more details.
+          #
+          #   Watch a single web page. Exact detection reports visible-text diffs; semantic
+          #   detection judges confirmed stable diffs against `instructions`.
           #
           #   @param url [String]
           #
+          #   @param instructions [String] Plain-language goal describing which page changes matter. When provided without
+          #
           #   @param normalize_whitespace [Boolean] Normalize whitespace before comparing or analyzing text.
           #
           #   @param type [Symbol, :page]

data/lib/context_dev/models/page_error_count.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Models
+    class PageErrorCount < ContextDev::Internal::Type::BaseModel
+      # @!attribute code
+      #   Error code for these failures.
+      #
+      #   @return [String]
+      required :code, String
+
+      # @!attribute count
+      #   Pages that failed with this code.
+      #
+      #   @return [Integer]
+      required :count, Integer
+
+      # @!method initialize(code:, count:)
+      #   Page failures sharing one error code.
+      #
+      #   @param code [String] Error code for these failures.
+      #
+      #   @param count [Integer] Pages that failed with this code.
+    end
+  end
+end

data/lib/context_dev/models/web_screenshot_params.rb

@@ -15,9 +15,8 @@ module ContextDev
       optional :color_scheme, enum: -> { ContextDev::WebScreenshotParams::ColorScheme }
 
       # @!attribute country
-      #   Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev
-      #   residential proxy exit location. Must be one of Context.dev's supported
-      #   countries. When provided, Context.dev fetches the target page from that country.
+      #   Fetch the target page through a residential proxy in this country (ISO 3166-1
+      #   alpha-2).
       #
       #   @return [Symbol, ContextDev::Models::WebScreenshotParams::Country, nil]
       optional :country, enum: -> { ContextDev::WebScreenshotParams::Country }
@@ -128,7 +127,7 @@ module ContextDev
       #
       #   @param color_scheme [Symbol, ContextDev::Models::WebScreenshotParams::ColorScheme] Optional parameter to choose the site's visual theme in the screenshot. Use 'lig
       #
-      #   @param country [Symbol, ContextDev::Models::WebScreenshotParams::Country] Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev r
+      #   @param country [Symbol, ContextDev::Models::WebScreenshotParams::Country] Fetch the target page through a residential proxy in this country (ISO 3166-1 al
       #
       #   @param direct_url [String] A specific URL to screenshot directly, bypassing domain resolution (e.g., 'https
       #
@@ -168,9 +167,8 @@ module ContextDev
         #   @return [Array<Symbol>]
       end
 
-      # Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev
-      # residential proxy exit location. Must be one of Context.dev's supported
-      # countries. When provided, Context.dev fetches the target page from that country.
+      # Fetch the target page through a residential proxy in this country (ISO 3166-1
+      # alpha-2).
       module Country
         extend ContextDev::Internal::Type::Enum
 

data/lib/context_dev/models/web_web_crawl_md_params.rb

@@ -14,9 +14,8 @@ module ContextDev
       required :url, String
 
       # @!attribute country
-      #   Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev
-      #   residential proxy exit location. Must be one of Context.dev's supported
-      #   countries. When provided, Context.dev fetches the target page from that country.
+      #   Fetch the target page through a residential proxy in this country (ISO 3166-1
+      #   alpha-2).
       #
       #   @return [Symbol, ContextDev::Models::WebWebCrawlMdParams::Country, nil]
       optional :country, enum: -> { ContextDev::WebWebCrawlMdParams::Country }
@@ -164,7 +163,7 @@ module ContextDev
       #
       #   @param url [String] The starting URL for the crawl (must include http:// or https:// protocol)
       #
-      #   @param country [Symbol, ContextDev::Models::WebWebCrawlMdParams::Country] Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev r
+      #   @param country [Symbol, ContextDev::Models::WebWebCrawlMdParams::Country] Fetch the target page through a residential proxy in this country (ISO 3166-1 al
       #
       #   @param exclude_selectors [Array<String>] CSS selectors to remove before each crawled page is converted to Markdown. Appli
       #
@@ -206,9 +205,8 @@ module ContextDev
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
 
-      # Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev
-      # residential proxy exit location. Must be one of Context.dev's supported
-      # countries. When provided, Context.dev fetches the target page from that country.
+      # Fetch the target page through a residential proxy in this country (ISO 3166-1
+      # alpha-2).
       module Country
         extend ContextDev::Internal::Type::Enum
 

data/lib/context_dev/models/web_web_scrape_html_params.rb

@@ -24,9 +24,8 @@ module ContextDev
                nil?: true
 
       # @!attribute country
-      #   Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev
-      #   residential proxy exit location. Must be one of Context.dev's supported
-      #   countries. When provided, Context.dev fetches the target page from that country.
+      #   Fetch the target page through a residential proxy in this country (ISO 3166-1
+      #   alpha-2).
       #
       #   @return [Symbol, ContextDev::Models::WebWebScrapeHTMLParams::Country, nil]
       optional :country, enum: -> { ContextDev::WebWebScrapeHTMLParams::Country }
@@ -131,7 +130,7 @@ module ContextDev
       #
       #   @param actions [Array<ContextDev::Models::WebWebScrapeHTMLParams::Action::Wait, ContextDev::Models::WebWebScrapeHTMLParams::Action::Perform>, nil] Optional browser actions executed in array order after the page loads and before
       #
-      #   @param country [Symbol, ContextDev::Models::WebWebScrapeHTMLParams::Country] Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev r
+      #   @param country [Symbol, ContextDev::Models::WebWebScrapeHTMLParams::Country] Fetch the target page through a residential proxy in this country (ISO 3166-1 al
       #
       #   @param exclude_selectors [Array<String>, nil] CSS selectors to remove from the result. Applied after includeSelectors. Exclusi
       #
@@ -212,9 +211,8 @@ module ContextDev
         #   @return [Array(ContextDev::Models::WebWebScrapeHTMLParams::Action::Wait, ContextDev::Models::WebWebScrapeHTMLParams::Action::Perform)]
       end
 
-      # Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev
-      # residential proxy exit location. Must be one of Context.dev's supported
-      # countries. When provided, Context.dev fetches the target page from that country.
+      # Fetch the target page through a residential proxy in this country (ISO 3166-1
+      # alpha-2).
       module Country
         extend ContextDev::Internal::Type::Enum
 

data/lib/context_dev/models/web_web_scrape_html_response.rb

@@ -39,6 +39,21 @@ module ContextDev
       #   @return [String]
       required :url, String
 
+      # @!attribute actions_applied
+      #   One verified outcome per requested browser action, in request order.
+      #
+      #   @return [Array<ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied>, nil]
+      optional :actions_applied,
+               -> { ContextDev::Internal::Type::ArrayOf[ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied] },
+               api_name: :actionsApplied
+
+      # @!attribute actions_html_stale
+      #   True when an action was applied but the returned content could not be refreshed
+      #   afterward.
+      #
+      #   @return [Boolean, nil]
+      optional :actions_html_stale, ContextDev::Internal::Type::Boolean, api_name: :actionsHtmlStale
+
       # @!attribute key_metadata
       #   Metadata about the API key used for the request. Included in every response
       #   whenever a valid API key is provided, even when the response status is not 200.
@@ -46,7 +61,7 @@ module ContextDev
       #   @return [ContextDev::Models::WebWebScrapeHTMLResponse::KeyMetadata, nil]
       optional :key_metadata, -> { ContextDev::Models::WebWebScrapeHTMLResponse::KeyMetadata }
 
-      # @!method initialize(html:, metadata:, success:, type:, url:, key_metadata: nil)
+      # @!method initialize(html:, metadata:, 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.
       #
@@ -60,6 +75,10 @@ module ContextDev
       #
       #   @param url [String] The URL that was scraped
       #
+      #   @param actions_applied [Array<ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied>] One verified outcome per requested browser action, in request order.
+      #
+      #   @param actions_html_stale [Boolean] True when an action was applied but the returned content could not be refreshed
+      #
       #   @param key_metadata [ContextDev::Models::WebWebScrapeHTMLResponse::KeyMetadata] Metadata about the API key used for the request. Included in every response when
 
       # @see ContextDev::Models::WebWebScrapeHTMLResponse#metadata
@@ -349,6 +368,79 @@ module ContextDev
         #   @return [Array<Symbol>]
       end
 
+      class ActionsApplied < ContextDev::Internal::Type::BaseModel
+        # @!attribute instruction
+        #
+        #   @return [String]
+        required :instruction, String
+
+        # @!attribute status
+        #   Applied means the requested page state was visibly verified. Failed means it was
+        #   not verified. Skipped means it was not attempted.
+        #
+        #   @return [Symbol, ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied::Status]
+        required :status, enum: -> { ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied::Status }
+
+        # @!attribute completion_evidence
+        #   Visible page evidence used to verify an applied action.
+        #
+        #   @return [String, nil]
+        optional :completion_evidence, String, api_name: :completionEvidence
+
+        # @!attribute duration_ms
+        #
+        #   @return [Float, nil]
+        optional :duration_ms, Float, api_name: :durationMs
+
+        # @!attribute error
+        #
+        #   @return [String, nil]
+        optional :error, String
+
+        # @!attribute method_
+        #
+        #   @return [String, nil]
+        optional :method_, String, api_name: :method
+
+        # @!attribute target_description
+        #
+        #   @return [String, nil]
+        optional :target_description, String, api_name: :targetDescription
+
+        # @!method initialize(instruction:, status:, completion_evidence: nil, duration_ms: nil, error: nil, method_: nil, target_description: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied} for more details.
+        #
+        #   @param instruction [String]
+        #
+        #   @param status [Symbol, ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied::Status] Applied means the requested page state was visibly verified. Failed means it was
+        #
+        #   @param completion_evidence [String] Visible page evidence used to verify an applied action.
+        #
+        #   @param duration_ms [Float]
+        #
+        #   @param error [String]
+        #
+        #   @param method_ [String]
+        #
+        #   @param target_description [String]
+
+        # Applied means the requested page state was visibly verified. Failed means it was
+        # not verified. Skipped means it was not attempted.
+        #
+        # @see ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied#status
+        module Status
+          extend ContextDev::Internal::Type::Enum
+
+          APPLIED = :applied
+          FAILED = :failed
+          SKIPPED = :skipped
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
       # @see ContextDev::Models::WebWebScrapeHTMLResponse#key_metadata
       class KeyMetadata < ContextDev::Internal::Type::BaseModel
         # @!attribute credits_consumed

data/lib/context_dev/models/web_web_scrape_md_params.rb

@@ -25,9 +25,8 @@ module ContextDev
                nil?: true
 
       # @!attribute country
-      #   Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev
-      #   residential proxy exit location. Must be one of Context.dev's supported
-      #   countries. When provided, Context.dev fetches the target page from that country.
+      #   Fetch the target page through a residential proxy in this country (ISO 3166-1
+      #   alpha-2).
       #
       #   @return [Symbol, ContextDev::Models::WebWebScrapeMdParams::Country, nil]
       optional :country, enum: -> { ContextDev::WebWebScrapeMdParams::Country }
@@ -150,7 +149,7 @@ module ContextDev
       #
       #   @param actions [Array<ContextDev::Models::WebWebScrapeMdParams::Action::Wait, ContextDev::Models::WebWebScrapeMdParams::Action::Perform>, nil] Optional browser actions executed in array order after the page loads and before
       #
-      #   @param country [Symbol, ContextDev::Models::WebWebScrapeMdParams::Country] Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev r
+      #   @param country [Symbol, ContextDev::Models::WebWebScrapeMdParams::Country] Fetch the target page through a residential proxy in this country (ISO 3166-1 al
       #
       #   @param exclude_selectors [Array<String>, nil] CSS selectors to remove before conversion to Markdown. Applied after includeSele
       #
@@ -237,9 +236,8 @@ module ContextDev
         #   @return [Array(ContextDev::Models::WebWebScrapeMdParams::Action::Wait, ContextDev::Models::WebWebScrapeMdParams::Action::Perform)]
       end
 
-      # Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev
-      # residential proxy exit location. Must be one of Context.dev's supported
-      # countries. When provided, Context.dev fetches the target page from that country.
+      # Fetch the target page through a residential proxy in this country (ISO 3166-1
+      # alpha-2).
       module Country
         extend ContextDev::Internal::Type::Enum