context.dev 2.5.0 → 2.7.0

data/rbi/context_dev/models/web_web_scrape_html_response.rbi

@@ -52,6 +52,36 @@ module ContextDev
       sig { returns(String) }
       attr_accessor :url
 
+      # One verified outcome per requested browser action, in request order.
+      sig do
+        returns(
+          T.nilable(
+            T::Array[
+              ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied
+            ]
+          )
+        )
+      end
+      attr_reader :actions_applied
+
+      sig do
+        params(
+          actions_applied:
+            T::Array[
+              ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied::OrHash
+            ]
+        ).void
+      end
+      attr_writer :actions_applied
+
+      # True when an action was applied but the returned content could not be refreshed
+      # afterward.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :actions_html_stale
+
+      sig { params(actions_html_stale: T::Boolean).void }
+      attr_writer :actions_html_stale
+
       # 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.
       sig do
@@ -78,6 +108,11 @@ module ContextDev
             ContextDev::Models::WebWebScrapeHTMLResponse::Success::OrBoolean,
           type: ContextDev::Models::WebWebScrapeHTMLResponse::Type::OrSymbol,
           url: String,
+          actions_applied:
+            T::Array[
+              ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied::OrHash
+            ],
+          actions_html_stale: T::Boolean,
           key_metadata:
             ContextDev::Models::WebWebScrapeHTMLResponse::KeyMetadata::OrHash
         ).returns(T.attached_class)
@@ -98,6 +133,11 @@ module ContextDev
         type:,
         # The URL that was scraped
         url:,
+        # One verified outcome per requested browser action, in request order.
+        actions_applied: nil,
+        # True when an action was applied but the returned content could not be refreshed
+        # afterward.
+        actions_html_stale: nil,
         # 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.
         key_metadata: nil
@@ -114,6 +154,11 @@ module ContextDev
             type:
               ContextDev::Models::WebWebScrapeHTMLResponse::Type::TaggedSymbol,
             url: String,
+            actions_applied:
+              T::Array[
+                ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied
+              ],
+            actions_html_stale: T::Boolean,
             key_metadata:
               ContextDev::Models::WebWebScrapeHTMLResponse::KeyMetadata
           }
@@ -705,6 +750,143 @@ module ContextDev
         end
       end
 
+      class ActionsApplied < ContextDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied,
+              ContextDev::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :instruction
+
+        # Applied means the requested page state was visibly verified. Failed means it was
+        # not verified. Skipped means it was not attempted.
+        sig do
+          returns(
+            ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied::Status::TaggedSymbol
+          )
+        end
+        attr_accessor :status
+
+        # Visible page evidence used to verify an applied action.
+        sig { returns(T.nilable(String)) }
+        attr_reader :completion_evidence
+
+        sig { params(completion_evidence: String).void }
+        attr_writer :completion_evidence
+
+        sig { returns(T.nilable(Float)) }
+        attr_reader :duration_ms
+
+        sig { params(duration_ms: Float).void }
+        attr_writer :duration_ms
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :error
+
+        sig { params(error: String).void }
+        attr_writer :error
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :method_
+
+        sig { params(method_: String).void }
+        attr_writer :method_
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :target_description
+
+        sig { params(target_description: String).void }
+        attr_writer :target_description
+
+        sig do
+          params(
+            instruction: String,
+            status:
+              ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied::Status::OrSymbol,
+            completion_evidence: String,
+            duration_ms: Float,
+            error: String,
+            method_: String,
+            target_description: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          instruction:,
+          # Applied means the requested page state was visibly verified. Failed means it was
+          # not verified. Skipped means it was not attempted.
+          status:,
+          # Visible page evidence used to verify an applied action.
+          completion_evidence: nil,
+          duration_ms: nil,
+          error: nil,
+          method_: nil,
+          target_description: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              instruction: String,
+              status:
+                ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied::Status::TaggedSymbol,
+              completion_evidence: String,
+              duration_ms: Float,
+              error: String,
+              method_: String,
+              target_description: String
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Applied means the requested page state was visibly verified. Failed means it was
+        # not verified. Skipped means it was not attempted.
+        module Status
+          extend ContextDev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied::Status
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          APPLIED =
+            T.let(
+              :applied,
+              ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied::Status::TaggedSymbol
+            )
+          FAILED =
+            T.let(
+              :failed,
+              ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied::Status::TaggedSymbol
+            )
+          SKIPPED =
+            T.let(
+              :skipped,
+              ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied::Status::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                ContextDev::Models::WebWebScrapeHTMLResponse::ActionsApplied::Status::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+
       class KeyMetadata < ContextDev::Internal::Type::BaseModel
         OrHash =
           T.type_alias do

data/rbi/context_dev/models/web_web_scrape_md_params.rbi

@@ -33,9 +33,8 @@ module ContextDev
       end
       attr_accessor :actions
 
-      # 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).
       sig do
         returns(T.nilable(ContextDev::WebWebScrapeMdParams::Country::OrSymbol))
       end
@@ -328,9 +327,8 @@ module ContextDev
         # content is captured. Requires a paid plan. Send a JSON array in the query
         # parameter. Maximum: 5 actions.
         actions: nil,
-        # 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).
         country: nil,
         # CSS selectors to remove before conversion to Markdown. Applied after
         # includeSelectors. Exclusion takes precedence: an element matching both is
@@ -520,9 +518,8 @@ module ContextDev
         end
       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/rbi/context_dev/models/web_web_scrape_md_response.rbi

@@ -44,6 +44,34 @@ module ContextDev
       sig { returns(String) }
       attr_accessor :url
 
+      # One verified outcome per requested browser action, in request order.
+      sig do
+        returns(
+          T.nilable(
+            T::Array[ContextDev::Models::WebWebScrapeMdResponse::ActionsApplied]
+          )
+        )
+      end
+      attr_reader :actions_applied
+
+      sig do
+        params(
+          actions_applied:
+            T::Array[
+              ContextDev::Models::WebWebScrapeMdResponse::ActionsApplied::OrHash
+            ]
+        ).void
+      end
+      attr_writer :actions_applied
+
+      # True when an action was applied but the returned content could not be refreshed
+      # afterward.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :actions_html_stale
+
+      sig { params(actions_html_stale: T::Boolean).void }
+      attr_writer :actions_html_stale
+
       # 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.
       sig do
@@ -70,6 +98,11 @@ module ContextDev
           success:
             ContextDev::Models::WebWebScrapeMdResponse::Success::OrBoolean,
           url: String,
+          actions_applied:
+            T::Array[
+              ContextDev::Models::WebWebScrapeMdResponse::ActionsApplied::OrHash
+            ],
+          actions_html_stale: T::Boolean,
           key_metadata:
             ContextDev::Models::WebWebScrapeMdResponse::KeyMetadata::OrHash
         ).returns(T.attached_class)
@@ -87,6 +120,11 @@ module ContextDev
         success:,
         # The URL that was scraped
         url:,
+        # One verified outcome per requested browser action, in request order.
+        actions_applied: nil,
+        # True when an action was applied but the returned content could not be refreshed
+        # afterward.
+        actions_html_stale: nil,
         # 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.
         key_metadata: nil
@@ -102,6 +140,11 @@ module ContextDev
             success:
               ContextDev::Models::WebWebScrapeMdResponse::Success::TaggedBoolean,
             url: String,
+            actions_applied:
+              T::Array[
+                ContextDev::Models::WebWebScrapeMdResponse::ActionsApplied
+              ],
+            actions_html_stale: T::Boolean,
             key_metadata:
               ContextDev::Models::WebWebScrapeMdResponse::KeyMetadata
           }
@@ -598,6 +641,143 @@ module ContextDev
         end
       end
 
+      class ActionsApplied < ContextDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              ContextDev::Models::WebWebScrapeMdResponse::ActionsApplied,
+              ContextDev::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :instruction
+
+        # Applied means the requested page state was visibly verified. Failed means it was
+        # not verified. Skipped means it was not attempted.
+        sig do
+          returns(
+            ContextDev::Models::WebWebScrapeMdResponse::ActionsApplied::Status::TaggedSymbol
+          )
+        end
+        attr_accessor :status
+
+        # Visible page evidence used to verify an applied action.
+        sig { returns(T.nilable(String)) }
+        attr_reader :completion_evidence
+
+        sig { params(completion_evidence: String).void }
+        attr_writer :completion_evidence
+
+        sig { returns(T.nilable(Float)) }
+        attr_reader :duration_ms
+
+        sig { params(duration_ms: Float).void }
+        attr_writer :duration_ms
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :error
+
+        sig { params(error: String).void }
+        attr_writer :error
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :method_
+
+        sig { params(method_: String).void }
+        attr_writer :method_
+
+        sig { returns(T.nilable(String)) }
+        attr_reader :target_description
+
+        sig { params(target_description: String).void }
+        attr_writer :target_description
+
+        sig do
+          params(
+            instruction: String,
+            status:
+              ContextDev::Models::WebWebScrapeMdResponse::ActionsApplied::Status::OrSymbol,
+            completion_evidence: String,
+            duration_ms: Float,
+            error: String,
+            method_: String,
+            target_description: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          instruction:,
+          # Applied means the requested page state was visibly verified. Failed means it was
+          # not verified. Skipped means it was not attempted.
+          status:,
+          # Visible page evidence used to verify an applied action.
+          completion_evidence: nil,
+          duration_ms: nil,
+          error: nil,
+          method_: nil,
+          target_description: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              instruction: String,
+              status:
+                ContextDev::Models::WebWebScrapeMdResponse::ActionsApplied::Status::TaggedSymbol,
+              completion_evidence: String,
+              duration_ms: Float,
+              error: String,
+              method_: String,
+              target_description: String
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Applied means the requested page state was visibly verified. Failed means it was
+        # not verified. Skipped means it was not attempted.
+        module Status
+          extend ContextDev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                ContextDev::Models::WebWebScrapeMdResponse::ActionsApplied::Status
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          APPLIED =
+            T.let(
+              :applied,
+              ContextDev::Models::WebWebScrapeMdResponse::ActionsApplied::Status::TaggedSymbol
+            )
+          FAILED =
+            T.let(
+              :failed,
+              ContextDev::Models::WebWebScrapeMdResponse::ActionsApplied::Status::TaggedSymbol
+            )
+          SKIPPED =
+            T.let(
+              :skipped,
+              ContextDev::Models::WebWebScrapeMdResponse::ActionsApplied::Status::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                ContextDev::Models::WebWebScrapeMdResponse::ActionsApplied::Status::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+
       class KeyMetadata < ContextDev::Internal::Type::BaseModel
         OrHash =
           T.type_alias do

data/rbi/context_dev/models.rbi

@@ -5,15 +5,31 @@ module ContextDev
 
   AIExtractProductsParams = ContextDev::Models::AIExtractProductsParams
 
+  BatchCancelParams = ContextDev::Models::BatchCancelParams
+
+  BatchGetResultsParams = ContextDev::Models::BatchGetResultsParams
+
+  BatchListParams = ContextDev::Models::BatchListParams
+
+  BatchRetrieveParams = ContextDev::Models::BatchRetrieveParams
+
+  BatchSubmitParams = ContextDev::Models::BatchSubmitParams
+
   BrandRetrieveParams = ContextDev::Models::BrandRetrieveParams
 
   BrandRetrieveSimplifiedParams =
     ContextDev::Models::BrandRetrieveSimplifiedParams
 
+  CrawlControls = ContextDev::Models::CrawlControls
+
+  Failure = ContextDev::Models::Failure
+
   IndustryRetrieveNaicsParams = ContextDev::Models::IndustryRetrieveNaicsParams
 
   IndustryRetrieveSicParams = ContextDev::Models::IndustryRetrieveSicParams
 
+  Intake = ContextDev::Models::Intake
+
   MonitorCreateParams = ContextDev::Models::MonitorCreateParams
 
   MonitorDeleteParams = ContextDev::Models::MonitorDeleteParams
@@ -42,6 +58,8 @@ module ContextDev
 
   MonitorUpdateParams = ContextDev::Models::MonitorUpdateParams
 
+  PageErrorCount = ContextDev::Models::PageErrorCount
+
   ParseHandleParams = ContextDev::Models::ParseHandleParams
 
   UtilityPrefetchParams = ContextDev::Models::UtilityPrefetchParams

data/rbi/context_dev/resources/batch.rbi

@@ -0,0 +1,117 @@
+# typed: strong
+
+module ContextDev
+  module Resources
+    class Batch
+      # Check progress, and get download links once the batch finishes.
+      sig do
+        params(
+          batch_id: String,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(ContextDev::Models::BatchRetrieveResponse)
+      end
+      def retrieve(
+        # ID of the batch to retrieve or cancel.
+        batch_id,
+        request_options: {}
+      )
+      end
+
+      # List your batches from newest to oldest. Filter by status or continue with a
+      # cursor.
+      sig do
+        params(
+          cursor: String,
+          limit: Integer,
+          q: String,
+          search_type: ContextDev::BatchListParams::SearchType::OrSymbol,
+          status: ContextDev::BatchListParams::Status::OrSymbol,
+          tags: String,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(ContextDev::Models::BatchListResponse)
+      end
+      def list(
+        # Cursor from the previous page.
+        cursor: nil,
+        # Batches per page. Defaults to 25.
+        limit: nil,
+        # Free-text search term, matched against the batch id, crawl source (start URL or
+        # sitemap domain), and tags.
+        q: nil,
+        # `prefix` for as-you-type prefix matching (default), `exact` for full-token
+        # matching.
+        search_type: nil,
+        # Filter by status.
+        status: nil,
+        # Comma-separated list of tags to filter by (matches batches having any of them).
+        tags: nil,
+        request_options: {}
+      )
+      end
+
+      # Stop a batch from starting new pages. In-progress pages finish, and unused
+      # credits are refunded.
+      sig do
+        params(
+          batch_id: String,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(ContextDev::Models::BatchCancelResponse)
+      end
+      def cancel(
+        # ID of the batch to retrieve or cancel.
+        batch_id,
+        request_options: {}
+      )
+      end
+
+      # Page through a finished batch's results as JSON instead of downloading the
+      # NDJSON files.
+      sig do
+        params(
+          batch_id: String,
+          cursor: String,
+          limit: Integer,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(ContextDev::Models::BatchGetResultsResponse)
+      end
+      def get_results(
+        # ID of the batch to retrieve or cancel.
+        batch_id,
+        # next_cursor from the previous page.
+        cursor: nil,
+        # Records per page. Defaults to 25. A page can close early so its payload stays
+        # under ~8 MB; rely on next_cursor rather than counting records.
+        limit: nil,
+        request_options: {}
+      )
+      end
+
+      # Retrieve and normalize a person profile from identifiers.
+      sig do
+        params(
+          identifiers: ContextDev::BatchSubmitParams::Identifiers::OrHash,
+          tags: T::Array[String],
+          timeout_ms: Integer,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(ContextDev::Models::BatchSubmitResponse)
+      end
+      def submit(
+        # Known identifiers for the person. At least one identifier is required.
+        identifiers:,
+        # 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,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: ContextDev::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/context_dev/resources/monitors.rbi

@@ -12,38 +12,38 @@ module ContextDev
       # its initial baseline.
       sig do
         params(
-          change_detection:
-            T.any(
-              ContextDev::MonitorCreateParams::ChangeDetection::Exact::OrHash,
-              ContextDev::MonitorCreateParams::ChangeDetection::Semantic::OrHash
-            ),
           name: String,
-          schedule: ContextDev::MonitorCreateParams::Schedule::OrHash,
           target:
             T.any(
               ContextDev::MonitorCreateParams::Target::Page::OrHash,
               ContextDev::MonitorCreateParams::Target::Sitemap::OrHash,
               ContextDev::MonitorCreateParams::Target::Extract::OrHash
             ),
+          change_detection:
+            T.any(
+              ContextDev::MonitorCreateParams::ChangeDetection::Exact::OrHash,
+              ContextDev::MonitorCreateParams::ChangeDetection::Semantic::OrHash
+            ),
           mode: ContextDev::MonitorCreateParams::Mode::OrSymbol,
+          schedule: ContextDev::MonitorCreateParams::Schedule::OrHash,
           tags: T::Array[String],
           webhook: T.nilable(ContextDev::MonitorCreateParams::Webhook::OrHash),
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(ContextDev::Models::MonitorCreateResponse)
       end
       def create(
-        # Discriminated union describing how changes are detected.
-        change_detection:,
         name:,
-        # Run the monitor on a fixed interval defined by a frequency and a unit, e.g.
-        # every 6 hours or every 2 days. The total interval (frequency × unit) must be
-        # between 10 minutes and 1 year.
-        schedule:,
         # Discriminated union describing what the monitor watches.
         target:,
+        # Discriminated union describing how changes are detected.
+        change_detection: nil,
         # Top-level monitor category. Always `web` today; the concrete behavior is
         # described by `target` and `change_detection`.
         mode: nil,
+        # Run the monitor on a fixed interval defined by a frequency and a unit, e.g.
+        # every 6 hours or every 2 days. The total interval (frequency × unit) must be
+        # between 10 minutes and 1 year.
+        schedule: nil,
         # User-defined tags for grouping and filtering monitors and their changes.
         # Duplicates are removed.
         tags: nil,