context.dev 1.26.0 → 1.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bb1eb49bd2c33309910f98a48b129a07a32707a85e5a832277226ee555d22780
-  data.tar.gz: 4c7410af11f9f6f69145a70f37e1c613fe9a90d6b2ea99acc061c10ae9119716
+  metadata.gz: 8f2f6c8c373d61ab07f5969d5f7f9bb52539093279b41b09a5e7bbefc6d4bd9e
+  data.tar.gz: d4afbf2bb5144a50a0b9930321c3ab8b3d193fd1a01da993ae2285a226a32597
 SHA512:
-  metadata.gz: 13e5b25d98899a354e90fdf559ea5b3ed8d1140a543f538a7909691a92ecb49917e87398f2da8b3759aad2751487c02e4b89e4738f15febe9bc10995825c4660
-  data.tar.gz: b82dee66dd6c01d5a4edb347097a978708714164cbe4460b7da394f0440b297afcc602bf52cc3cf597e3fe8638559b953bafe0288512e883f1d3b2957fc62cea
+  metadata.gz: 6e38d8989d26cecb219a1dcbb39d29c4f7bc92d9dda81de355959267ceeaa1c1587ea778163a1ce5267afcff70d36ac666b6b442226ba359ca0c82465b8bb05a
+  data.tar.gz: b9a94c13fc5cc8bf84c84bfbd46277e519d878bfc74f6d82f4e941bf01adf4bb9b9197f2eb32f06d722624a410ee703b351beb7f1d0ff51f7228f7addd5ea75d

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 1.27.0 (2026-06-01)
+
+Full Changelog: [v1.26.0...v1.27.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.26.0...v1.27.0)
+
+### Features
+
+* **api:** manual updates ([e3971dc](https://github.com/context-dot-dev/context-ruby-sdk/commit/e3971dcc3b94f5b998562f8ecb82a292cc8f00bd))
+
 ## 1.26.0 (2026-06-01)
 
 Full Changelog: [v1.25.0...v1.26.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.25.0...v1.26.0)

data/README.md

@@ -26,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "context.dev", "~> 1.26.0"
+gem "context.dev", "~> 1.27.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/context_dev/models/web_extract_competitors_params.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Models
+    # @see ContextDev::Resources::Web#extract_competitors
+    class WebExtractCompetitorsParams < ContextDev::Internal::Type::BaseModel
+      extend ContextDev::Internal::Type::RequestParameters::Converter
+      include ContextDev::Internal::Type::RequestParameters
+
+      # @!attribute domain
+      #   Company domain to analyze, such as `stripe.com`. Full http(s) URLs are accepted
+      #   and normalized to their domain.
+      #
+      #   @return [String]
+      required :domain, String
+
+      # @!attribute num_competitors
+      #   Exact number of direct competitors to return. Defaults to 5.
+      #
+      #   @return [Integer, nil]
+      optional :num_competitors, Integer
+
+      # @!attribute timeout_ms
+      #   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).
+      #
+      #   @return [Integer, nil]
+      optional :timeout_ms, Integer
+
+      # @!method initialize(domain:, num_competitors: nil, timeout_ms: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::WebExtractCompetitorsParams} for more details.
+      #
+      #   @param domain [String] Company domain to analyze, such as `stripe.com`. Full http(s) URLs are accepted
+      #
+      #   @param num_competitors [Integer] Exact number of direct competitors to return. Defaults to 5.
+      #
+      #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      #
+      #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/context_dev/models/web_extract_competitors_response.rb

@@ -0,0 +1,157 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Models
+    # @see ContextDev::Resources::Web#extract_competitors
+    class WebExtractCompetitorsResponse < ContextDev::Internal::Type::BaseModel
+      # @!attribute competitors
+      #   Direct competitors ordered by relevance and confidence.
+      #
+      #   @return [Array<ContextDev::Models::WebExtractCompetitorsResponse::Competitor>]
+      required :competitors,
+               -> { ContextDev::Internal::Type::ArrayOf[ContextDev::Models::WebExtractCompetitorsResponse::Competitor] }
+
+      # @!attribute domain
+      #   Normalized input domain.
+      #
+      #   @return [String]
+      required :domain, String
+
+      # @!attribute status
+      #   Status of the response.
+      #
+      #   @return [Symbol, ContextDev::Models::WebExtractCompetitorsResponse::Status]
+      required :status, enum: -> { ContextDev::Models::WebExtractCompetitorsResponse::Status }
+
+      # @!attribute target
+      #   Target company profile inferred from the landing page.
+      #
+      #   @return [ContextDev::Models::WebExtractCompetitorsResponse::Target]
+      required :target, -> { ContextDev::Models::WebExtractCompetitorsResponse::Target }
+
+      # @!method initialize(competitors:, domain:, status:, target:)
+      #   @param competitors [Array<ContextDev::Models::WebExtractCompetitorsResponse::Competitor>] Direct competitors ordered by relevance and confidence.
+      #
+      #   @param domain [String] Normalized input domain.
+      #
+      #   @param status [Symbol, ContextDev::Models::WebExtractCompetitorsResponse::Status] Status of the response.
+      #
+      #   @param target [ContextDev::Models::WebExtractCompetitorsResponse::Target] Target company profile inferred from the landing page.
+
+      class Competitor < ContextDev::Internal::Type::BaseModel
+        # @!attribute confidence
+        #   Confidence that this company is a direct competitor.
+        #
+        #   @return [Symbol, ContextDev::Models::WebExtractCompetitorsResponse::Competitor::Confidence]
+        required :confidence,
+                 enum: -> { ContextDev::Models::WebExtractCompetitorsResponse::Competitor::Confidence }
+
+        # @!attribute description
+        #   Short description of the competitor.
+        #
+        #   @return [String]
+        required :description, String
+
+        # @!attribute domain
+        #   Competitor's normalized official domain.
+        #
+        #   @return [String]
+        required :domain, String
+
+        # @!attribute name
+        #   Competitor company or product name.
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute source_urls
+        #   Search result URLs used as evidence for this competitor.
+        #
+        #   @return [Array<String>]
+        required :source_urls, ContextDev::Internal::Type::ArrayOf[String], api_name: :sourceUrls
+
+        # @!attribute url
+        #   Competitor website URL.
+        #
+        #   @return [String]
+        required :url, String
+
+        # @!method initialize(confidence:, description:, domain:, name:, source_urls:, url:)
+        #   @param confidence [Symbol, ContextDev::Models::WebExtractCompetitorsResponse::Competitor::Confidence] Confidence that this company is a direct competitor.
+        #
+        #   @param description [String] Short description of the competitor.
+        #
+        #   @param domain [String] Competitor's normalized official domain.
+        #
+        #   @param name [String] Competitor company or product name.
+        #
+        #   @param source_urls [Array<String>] Search result URLs used as evidence for this competitor.
+        #
+        #   @param url [String] Competitor website URL.
+
+        # Confidence that this company is a direct competitor.
+        #
+        # @see ContextDev::Models::WebExtractCompetitorsResponse::Competitor#confidence
+        module Confidence
+          extend ContextDev::Internal::Type::Enum
+
+          HIGH = :high
+          MEDIUM = :medium
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      # Status of the response.
+      #
+      # @see ContextDev::Models::WebExtractCompetitorsResponse#status
+      module Status
+        extend ContextDev::Internal::Type::Enum
+
+        OK = :ok
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # @see ContextDev::Models::WebExtractCompetitorsResponse#target
+      class Target < ContextDev::Internal::Type::BaseModel
+        # @!attribute company_name
+        #   Company or product name inferred from the landing page.
+        #
+        #   @return [String]
+        required :company_name, String, api_name: :companyName
+
+        # @!attribute field
+        #   Specific operating field, product category, or market.
+        #
+        #   @return [String]
+        required :field, String
+
+        # @!attribute field_description
+        #   One-sentence description of what the target company sells and who it serves.
+        #
+        #   @return [String]
+        required :field_description, String, api_name: :fieldDescription
+
+        # @!attribute website_url
+        #   Resolved URL used for the landing page analysis.
+        #
+        #   @return [String]
+        required :website_url, String, api_name: :websiteUrl
+
+        # @!method initialize(company_name:, field:, field_description:, website_url:)
+        #   Target company profile inferred from the landing page.
+        #
+        #   @param company_name [String] Company or product name inferred from the landing page.
+        #
+        #   @param field [String] Specific operating field, product category, or market.
+        #
+        #   @param field_description [String] One-sentence description of what the target company sells and who it serves.
+        #
+        #   @param website_url [String] Resolved URL used for the landing page analysis.
+      end
+    end
+  end
+end

data/lib/context_dev/models.rb

@@ -67,6 +67,8 @@ module ContextDev
 
   UtilityPrefetchParams = ContextDev::Models::UtilityPrefetchParams
 
+  WebExtractCompetitorsParams = ContextDev::Models::WebExtractCompetitorsParams
+
   WebExtractFontsParams = ContextDev::Models::WebExtractFontsParams
 
   WebExtractParams = ContextDev::Models::WebExtractParams

data/lib/context_dev/resources/web.rb

@@ -49,6 +49,37 @@ module ContextDev
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {ContextDev::Models::WebExtractCompetitorsParams} for more details.
+      #
+      # Analyze a company's landing page and web search evidence to return direct
+      # competitors for the same product or market.
+      #
+      # @overload extract_competitors(domain:, num_competitors: nil, timeout_ms: nil, request_options: {})
+      #
+      # @param domain [String] Company domain to analyze, such as `stripe.com`. Full http(s) URLs are accepted
+      #
+      # @param num_competitors [Integer] Exact number of direct competitors to return. Defaults to 5.
+      #
+      # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::WebExtractCompetitorsResponse]
+      #
+      # @see ContextDev::Models::WebExtractCompetitorsParams
+      def extract_competitors(params)
+        parsed, options = ContextDev::WebExtractCompetitorsParams.dump_request(params)
+        query = ContextDev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "web/competitors",
+          query: query.transform_keys(num_competitors: "numCompetitors", timeout_ms: "timeoutMS"),
+          model: ContextDev::Models::WebExtractCompetitorsResponse,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::WebExtractFontsParams} for more details.
       #

data/lib/context_dev/version.rb

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

data/lib/context_dev.rb

@@ -80,6 +80,8 @@ require_relative "context_dev/models/utility_prefetch_by_email_params"
 require_relative "context_dev/models/utility_prefetch_by_email_response"
 require_relative "context_dev/models/utility_prefetch_params"
 require_relative "context_dev/models/utility_prefetch_response"
+require_relative "context_dev/models/web_extract_competitors_params"
+require_relative "context_dev/models/web_extract_competitors_response"
 require_relative "context_dev/models/web_extract_fonts_params"
 require_relative "context_dev/models/web_extract_fonts_response"
 require_relative "context_dev/models/web_extract_params"

data/rbi/context_dev/models/web_extract_competitors_params.rbi

@@ -0,0 +1,74 @@
+# typed: strong
+
+module ContextDev
+  module Models
+    class WebExtractCompetitorsParams < ContextDev::Internal::Type::BaseModel
+      extend ContextDev::Internal::Type::RequestParameters::Converter
+      include ContextDev::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            ContextDev::WebExtractCompetitorsParams,
+            ContextDev::Internal::AnyHash
+          )
+        end
+
+      # Company domain to analyze, such as `stripe.com`. Full http(s) URLs are accepted
+      # and normalized to their domain.
+      sig { returns(String) }
+      attr_accessor :domain
+
+      # Exact number of direct competitors to return. Defaults to 5.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :num_competitors
+
+      sig { params(num_competitors: Integer).void }
+      attr_writer :num_competitors
+
+      # 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).
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :timeout_ms
+
+      sig { params(timeout_ms: Integer).void }
+      attr_writer :timeout_ms
+
+      sig do
+        params(
+          domain: String,
+          num_competitors: Integer,
+          timeout_ms: Integer,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Company domain to analyze, such as `stripe.com`. Full http(s) URLs are accepted
+        # and normalized to their domain.
+        domain:,
+        # Exact number of direct competitors to return. Defaults to 5.
+        num_competitors: 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
+
+      sig do
+        override.returns(
+          {
+            domain: String,
+            num_competitors: Integer,
+            timeout_ms: Integer,
+            request_options: ContextDev::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/context_dev/models/web_extract_competitors_response.rbi

@@ -0,0 +1,297 @@
+# typed: strong
+
+module ContextDev
+  module Models
+    class WebExtractCompetitorsResponse < ContextDev::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            ContextDev::Models::WebExtractCompetitorsResponse,
+            ContextDev::Internal::AnyHash
+          )
+        end
+
+      # Direct competitors ordered by relevance and confidence.
+      sig do
+        returns(
+          T::Array[
+            ContextDev::Models::WebExtractCompetitorsResponse::Competitor
+          ]
+        )
+      end
+      attr_accessor :competitors
+
+      # Normalized input domain.
+      sig { returns(String) }
+      attr_accessor :domain
+
+      # Status of the response.
+      sig do
+        returns(
+          ContextDev::Models::WebExtractCompetitorsResponse::Status::TaggedSymbol
+        )
+      end
+      attr_accessor :status
+
+      # Target company profile inferred from the landing page.
+      sig { returns(ContextDev::Models::WebExtractCompetitorsResponse::Target) }
+      attr_reader :target
+
+      sig do
+        params(
+          target:
+            ContextDev::Models::WebExtractCompetitorsResponse::Target::OrHash
+        ).void
+      end
+      attr_writer :target
+
+      sig do
+        params(
+          competitors:
+            T::Array[
+              ContextDev::Models::WebExtractCompetitorsResponse::Competitor::OrHash
+            ],
+          domain: String,
+          status:
+            ContextDev::Models::WebExtractCompetitorsResponse::Status::OrSymbol,
+          target:
+            ContextDev::Models::WebExtractCompetitorsResponse::Target::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Direct competitors ordered by relevance and confidence.
+        competitors:,
+        # Normalized input domain.
+        domain:,
+        # Status of the response.
+        status:,
+        # Target company profile inferred from the landing page.
+        target:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            competitors:
+              T::Array[
+                ContextDev::Models::WebExtractCompetitorsResponse::Competitor
+              ],
+            domain: String,
+            status:
+              ContextDev::Models::WebExtractCompetitorsResponse::Status::TaggedSymbol,
+            target: ContextDev::Models::WebExtractCompetitorsResponse::Target
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Competitor < ContextDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              ContextDev::Models::WebExtractCompetitorsResponse::Competitor,
+              ContextDev::Internal::AnyHash
+            )
+          end
+
+        # Confidence that this company is a direct competitor.
+        sig do
+          returns(
+            ContextDev::Models::WebExtractCompetitorsResponse::Competitor::Confidence::TaggedSymbol
+          )
+        end
+        attr_accessor :confidence
+
+        # Short description of the competitor.
+        sig { returns(String) }
+        attr_accessor :description
+
+        # Competitor's normalized official domain.
+        sig { returns(String) }
+        attr_accessor :domain
+
+        # Competitor company or product name.
+        sig { returns(String) }
+        attr_accessor :name
+
+        # Search result URLs used as evidence for this competitor.
+        sig { returns(T::Array[String]) }
+        attr_accessor :source_urls
+
+        # Competitor website URL.
+        sig { returns(String) }
+        attr_accessor :url
+
+        sig do
+          params(
+            confidence:
+              ContextDev::Models::WebExtractCompetitorsResponse::Competitor::Confidence::OrSymbol,
+            description: String,
+            domain: String,
+            name: String,
+            source_urls: T::Array[String],
+            url: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Confidence that this company is a direct competitor.
+          confidence:,
+          # Short description of the competitor.
+          description:,
+          # Competitor's normalized official domain.
+          domain:,
+          # Competitor company or product name.
+          name:,
+          # Search result URLs used as evidence for this competitor.
+          source_urls:,
+          # Competitor website URL.
+          url:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              confidence:
+                ContextDev::Models::WebExtractCompetitorsResponse::Competitor::Confidence::TaggedSymbol,
+              description: String,
+              domain: String,
+              name: String,
+              source_urls: T::Array[String],
+              url: String
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Confidence that this company is a direct competitor.
+        module Confidence
+          extend ContextDev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                ContextDev::Models::WebExtractCompetitorsResponse::Competitor::Confidence
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          HIGH =
+            T.let(
+              :high,
+              ContextDev::Models::WebExtractCompetitorsResponse::Competitor::Confidence::TaggedSymbol
+            )
+          MEDIUM =
+            T.let(
+              :medium,
+              ContextDev::Models::WebExtractCompetitorsResponse::Competitor::Confidence::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                ContextDev::Models::WebExtractCompetitorsResponse::Competitor::Confidence::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+
+      # Status of the response.
+      module Status
+        extend ContextDev::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(
+              Symbol,
+              ContextDev::Models::WebExtractCompetitorsResponse::Status
+            )
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        OK =
+          T.let(
+            :ok,
+            ContextDev::Models::WebExtractCompetitorsResponse::Status::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              ContextDev::Models::WebExtractCompetitorsResponse::Status::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      class Target < ContextDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              ContextDev::Models::WebExtractCompetitorsResponse::Target,
+              ContextDev::Internal::AnyHash
+            )
+          end
+
+        # Company or product name inferred from the landing page.
+        sig { returns(String) }
+        attr_accessor :company_name
+
+        # Specific operating field, product category, or market.
+        sig { returns(String) }
+        attr_accessor :field
+
+        # One-sentence description of what the target company sells and who it serves.
+        sig { returns(String) }
+        attr_accessor :field_description
+
+        # Resolved URL used for the landing page analysis.
+        sig { returns(String) }
+        attr_accessor :website_url
+
+        # Target company profile inferred from the landing page.
+        sig do
+          params(
+            company_name: String,
+            field: String,
+            field_description: String,
+            website_url: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Company or product name inferred from the landing page.
+          company_name:,
+          # Specific operating field, product category, or market.
+          field:,
+          # One-sentence description of what the target company sells and who it serves.
+          field_description:,
+          # Resolved URL used for the landing page analysis.
+          website_url:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              company_name: String,
+              field: String,
+              field_description: String,
+              website_url: String
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/context_dev/models.rbi

@@ -32,6 +32,8 @@ module ContextDev
 
   UtilityPrefetchParams = ContextDev::Models::UtilityPrefetchParams
 
+  WebExtractCompetitorsParams = ContextDev::Models::WebExtractCompetitorsParams
+
   WebExtractFontsParams = ContextDev::Models::WebExtractFontsParams
 
   WebExtractParams = ContextDev::Models::WebExtractParams

data/rbi/context_dev/resources/web.rbi

@@ -60,6 +60,30 @@ module ContextDev
       )
       end
 
+      # Analyze a company's landing page and web search evidence to return direct
+      # competitors for the same product or market.
+      sig do
+        params(
+          domain: String,
+          num_competitors: Integer,
+          timeout_ms: Integer,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(ContextDev::Models::WebExtractCompetitorsResponse)
+      end
+      def extract_competitors(
+        # Company domain to analyze, such as `stripe.com`. Full http(s) URLs are accepted
+        # and normalized to their domain.
+        domain:,
+        # Exact number of direct competitors to return. Defaults to 5.
+        num_competitors: 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
+
       # Scrape font information from a website including font families, usage
       # statistics, fallbacks, and element/word counts.
       sig do

data/sig/context_dev/models/web_extract_competitors_params.rbs

@@ -0,0 +1,36 @@
+module ContextDev
+  module Models
+    type web_extract_competitors_params =
+      { domain: String, num_competitors: Integer, timeout_ms: Integer }
+      & ContextDev::Internal::Type::request_parameters
+
+    class WebExtractCompetitorsParams < ContextDev::Internal::Type::BaseModel
+      extend ContextDev::Internal::Type::RequestParameters::Converter
+      include ContextDev::Internal::Type::RequestParameters
+
+      attr_accessor domain: String
+
+      attr_reader num_competitors: Integer?
+
+      def num_competitors=: (Integer) -> Integer
+
+      attr_reader timeout_ms: Integer?
+
+      def timeout_ms=: (Integer) -> Integer
+
+      def initialize: (
+        domain: String,
+        ?num_competitors: Integer,
+        ?timeout_ms: Integer,
+        ?request_options: ContextDev::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        domain: String,
+        num_competitors: Integer,
+        timeout_ms: Integer,
+        request_options: ContextDev::RequestOptions
+      }
+    end
+  end
+end

data/sig/context_dev/models/web_extract_competitors_response.rbs

@@ -0,0 +1,130 @@
+module ContextDev
+  module Models
+    type web_extract_competitors_response =
+      {
+        competitors: ::Array[ContextDev::Models::WebExtractCompetitorsResponse::Competitor],
+        domain: String,
+        status: ContextDev::Models::WebExtractCompetitorsResponse::status,
+        target: ContextDev::Models::WebExtractCompetitorsResponse::Target
+      }
+
+    class WebExtractCompetitorsResponse < ContextDev::Internal::Type::BaseModel
+      attr_accessor competitors: ::Array[ContextDev::Models::WebExtractCompetitorsResponse::Competitor]
+
+      attr_accessor domain: String
+
+      attr_accessor status: ContextDev::Models::WebExtractCompetitorsResponse::status
+
+      attr_accessor target: ContextDev::Models::WebExtractCompetitorsResponse::Target
+
+      def initialize: (
+        competitors: ::Array[ContextDev::Models::WebExtractCompetitorsResponse::Competitor],
+        domain: String,
+        status: ContextDev::Models::WebExtractCompetitorsResponse::status,
+        target: ContextDev::Models::WebExtractCompetitorsResponse::Target
+      ) -> void
+
+      def to_hash: -> {
+        competitors: ::Array[ContextDev::Models::WebExtractCompetitorsResponse::Competitor],
+        domain: String,
+        status: ContextDev::Models::WebExtractCompetitorsResponse::status,
+        target: ContextDev::Models::WebExtractCompetitorsResponse::Target
+      }
+
+      type competitor =
+        {
+          confidence: ContextDev::Models::WebExtractCompetitorsResponse::Competitor::confidence,
+          description: String,
+          domain: String,
+          name: String,
+          source_urls: ::Array[String],
+          url: String
+        }
+
+      class Competitor < ContextDev::Internal::Type::BaseModel
+        attr_accessor confidence: ContextDev::Models::WebExtractCompetitorsResponse::Competitor::confidence
+
+        attr_accessor description: String
+
+        attr_accessor domain: String
+
+        attr_accessor name: String
+
+        attr_accessor source_urls: ::Array[String]
+
+        attr_accessor url: String
+
+        def initialize: (
+          confidence: ContextDev::Models::WebExtractCompetitorsResponse::Competitor::confidence,
+          description: String,
+          domain: String,
+          name: String,
+          source_urls: ::Array[String],
+          url: String
+        ) -> void
+
+        def to_hash: -> {
+          confidence: ContextDev::Models::WebExtractCompetitorsResponse::Competitor::confidence,
+          description: String,
+          domain: String,
+          name: String,
+          source_urls: ::Array[String],
+          url: String
+        }
+
+        type confidence = :high | :medium
+
+        module Confidence
+          extend ContextDev::Internal::Type::Enum
+
+          HIGH: :high
+          MEDIUM: :medium
+
+          def self?.values: -> ::Array[ContextDev::Models::WebExtractCompetitorsResponse::Competitor::confidence]
+        end
+      end
+
+      type status = :ok
+
+      module Status
+        extend ContextDev::Internal::Type::Enum
+
+        OK: :ok
+
+        def self?.values: -> ::Array[ContextDev::Models::WebExtractCompetitorsResponse::status]
+      end
+
+      type target =
+        {
+          company_name: String,
+          field: String,
+          field_description: String,
+          website_url: String
+        }
+
+      class Target < ContextDev::Internal::Type::BaseModel
+        attr_accessor company_name: String
+
+        attr_accessor field: String
+
+        attr_accessor field_description: String
+
+        attr_accessor website_url: String
+
+        def initialize: (
+          company_name: String,
+          field: String,
+          field_description: String,
+          website_url: String
+        ) -> void
+
+        def to_hash: -> {
+          company_name: String,
+          field: String,
+          field_description: String,
+          website_url: String
+        }
+      end
+    end
+  end
+end

data/sig/context_dev/models.rbs

@@ -27,6 +27,8 @@ module ContextDev
 
   class UtilityPrefetchParams = ContextDev::Models::UtilityPrefetchParams
 
+  class WebExtractCompetitorsParams = ContextDev::Models::WebExtractCompetitorsParams
+
   class WebExtractFontsParams = ContextDev::Models::WebExtractFontsParams
 
   class WebExtractParams = ContextDev::Models::WebExtractParams

data/sig/context_dev/resources/web.rbs

@@ -16,6 +16,13 @@ module ContextDev
         ?request_options: ContextDev::request_opts
       ) -> ContextDev::Models::WebExtractResponse
 
+      def extract_competitors: (
+        domain: String,
+        ?num_competitors: Integer,
+        ?timeout_ms: Integer,
+        ?request_options: ContextDev::request_opts
+      ) -> ContextDev::Models::WebExtractCompetitorsResponse
+
       def extract_fonts: (
         ?direct_url: String,
         ?domain: String,

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: context.dev
 version: !ruby/object:Gem::Version
-  version: 1.26.0
+  version: 1.27.0
 platform: ruby
 authors:
 - Context Dev
@@ -97,6 +97,8 @@ files:
 - lib/context_dev/models/utility_prefetch_by_email_response.rb
 - lib/context_dev/models/utility_prefetch_params.rb
 - lib/context_dev/models/utility_prefetch_response.rb
+- lib/context_dev/models/web_extract_competitors_params.rb
+- lib/context_dev/models/web_extract_competitors_response.rb
 - lib/context_dev/models/web_extract_fonts_params.rb
 - lib/context_dev/models/web_extract_fonts_response.rb
 - lib/context_dev/models/web_extract_params.rb
@@ -172,6 +174,8 @@ files:
 - rbi/context_dev/models/utility_prefetch_by_email_response.rbi
 - rbi/context_dev/models/utility_prefetch_params.rbi
 - rbi/context_dev/models/utility_prefetch_response.rbi
+- rbi/context_dev/models/web_extract_competitors_params.rbi
+- rbi/context_dev/models/web_extract_competitors_response.rbi
 - rbi/context_dev/models/web_extract_fonts_params.rbi
 - rbi/context_dev/models/web_extract_fonts_response.rbi
 - rbi/context_dev/models/web_extract_params.rbi
@@ -246,6 +250,8 @@ files:
 - sig/context_dev/models/utility_prefetch_by_email_response.rbs
 - sig/context_dev/models/utility_prefetch_params.rbs
 - sig/context_dev/models/utility_prefetch_response.rbs
+- sig/context_dev/models/web_extract_competitors_params.rbs
+- sig/context_dev/models/web_extract_competitors_response.rbs
 - sig/context_dev/models/web_extract_fonts_params.rbs
 - sig/context_dev/models/web_extract_fonts_response.rbs
 - sig/context_dev/models/web_extract_params.rbs