context.dev 0.1.0 → 0.2.0

data/rbi/context_dev/resources/industry.rbi

@@ -0,0 +1,40 @@
+# typed: strong
+
+module ContextDev
+  module Resources
+    class Industry
+      # Endpoint to classify any brand into a 2022 NAICS code.
+      sig do
+        params(
+          input: String,
+          max_results: Integer,
+          min_results: Integer,
+          timeout_ms: Integer,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(ContextDev::Models::IndustryRetrieveNaicsResponse)
+      end
+      def retrieve_naics(
+        # Brand domain or title to retrieve NAICS code for. If a valid domain is provided
+        # in `input`, it will be used for classification, otherwise, we will search for
+        # the brand using the provided title.
+        input:,
+        # Maximum number of NAICS codes to return. Must be between 1 and 10. Defaults
+        # to 5.
+        max_results: nil,
+        # Minimum number of NAICS codes to return. Must be at least 1. Defaults to 1.
+        min_results: 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/style.rbi

@@ -0,0 +1,67 @@
+# typed: strong
+
+module ContextDev
+  module Resources
+    class Style
+      # Extract font information from a brand's website including font families, usage
+      # statistics, fallbacks, and element/word counts.
+      sig do
+        params(
+          domain: String,
+          timeout_ms: Integer,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(ContextDev::Models::StyleExtractFontsResponse)
+      end
+      def extract_fonts(
+        # Domain name to extract fonts from (e.g., 'example.com', 'google.com'). The
+        # domain will be automatically normalized and validated.
+        domain:,
+        # 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
+
+      # Automatically extract comprehensive design system information from a brand's
+      # website including colors, typography, spacing, shadows, and UI components.
+      # Either 'domain' or 'directUrl' must be provided as a query parameter, but not
+      # both.
+      sig do
+        params(
+          direct_url: String,
+          domain: String,
+          prioritize:
+            ContextDev::StyleExtractStyleguideParams::Prioritize::OrSymbol,
+          timeout_ms: Integer,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(ContextDev::Models::StyleExtractStyleguideResponse)
+      end
+      def extract_styleguide(
+        # A specific URL to fetch the styleguide from directly, bypassing domain
+        # resolution (e.g., 'https://example.com/design-system').
+        direct_url: nil,
+        # Domain name to extract styleguide from (e.g., 'example.com', 'google.com'). The
+        # domain will be automatically normalized and validated.
+        domain: nil,
+        # Optional parameter to prioritize screenshot capture for styleguide extraction.
+        # If 'speed', optimizes for faster capture with basic quality. If 'quality',
+        # optimizes for higher quality with longer wait times. Defaults to 'quality' if
+        # not provided.
+        prioritize: 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/utility.rbi

@@ -0,0 +1,60 @@
+# typed: strong
+
+module ContextDev
+  module Resources
+    class Utility
+      # Signal that you may fetch brand data for a particular domain soon to improve
+      # latency. This endpoint does not charge credits and is available for paid
+      # customers to optimize future requests. [You must be on a paid plan to use this
+      # endpoint]
+      sig do
+        params(
+          domain: String,
+          timeout_ms: Integer,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(ContextDev::Models::UtilityPrefetchResponse)
+      end
+      def prefetch(
+        # Domain name to prefetch brand data for
+        domain:,
+        # 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
+
+      # Signal that you may fetch brand data for a particular domain soon to improve
+      # latency. This endpoint accepts an email address, extracts the domain from it,
+      # validates that it's not a disposable or free email provider, and queues the
+      # domain for prefetching. This endpoint does not charge credits and is available
+      # for paid customers to optimize future requests. [You must be on a paid plan to
+      # use this endpoint]
+      sig do
+        params(
+          email: String,
+          timeout_ms: Integer,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(ContextDev::Models::UtilityPrefetchByEmailResponse)
+      end
+      def prefetch_by_email(
+        # Email address to prefetch brand data for. The domain will be extracted from the
+        # email. Free email providers (gmail.com, yahoo.com, etc.) and disposable email
+        # addresses are not allowed.
+        email:,
+        # 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/web.rbi

@@ -0,0 +1,121 @@
+# typed: strong
+
+module ContextDev
+  module Resources
+    class Web
+      # Capture a screenshot of a website. Supports both viewport (standard browser
+      # view) and full-page screenshots. Can also screenshot specific page types (login,
+      # pricing, etc.) by using heuristics to find the appropriate URL. Returns a URL to
+      # the uploaded screenshot image hosted on our CDN.
+      sig do
+        params(
+          domain: String,
+          full_screenshot:
+            ContextDev::WebScreenshotParams::FullScreenshot::OrSymbol,
+          page: ContextDev::WebScreenshotParams::Page::OrSymbol,
+          prioritize: ContextDev::WebScreenshotParams::Prioritize::OrSymbol,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(ContextDev::Models::WebScreenshotResponse)
+      end
+      def screenshot(
+        # Domain name to take screenshot of (e.g., 'example.com', 'google.com'). The
+        # domain will be automatically normalized and validated.
+        domain:,
+        # Optional parameter to determine screenshot type. If 'true', takes a full page
+        # screenshot capturing all content. If 'false' or not provided, takes a viewport
+        # screenshot (standard browser view).
+        full_screenshot: nil,
+        # Optional parameter to specify which page type to screenshot. If provided, the
+        # system will scrape the domain's links and use heuristics to find the most
+        # appropriate URL for the specified page type (30 supported languages). If not
+        # provided, screenshots the main domain landing page.
+        page: nil,
+        # Optional parameter to prioritize screenshot capture. If 'speed', optimizes for
+        # faster capture with basic quality. If 'quality', optimizes for higher quality
+        # with longer wait times. Defaults to 'quality' if not provided.
+        prioritize: nil,
+        request_options: {}
+      )
+      end
+
+      # Scrapes the given URL and returns the raw HTML content of the page. Uses
+      # automatic proxy escalation to handle blocked sites.
+      sig do
+        params(
+          url: String,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(ContextDev::Models::WebWebScrapeHTMLResponse)
+      end
+      def web_scrape_html(
+        # Full URL to scrape (must include http:// or https:// protocol)
+        url:,
+        request_options: {}
+      )
+      end
+
+      # Scrapes all images from the given URL. Extracts images from img, svg,
+      # picture/source, link, and video elements including inline SVGs, base64 data
+      # URIs, and standard URLs.
+      sig do
+        params(
+          url: String,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(ContextDev::Models::WebWebScrapeImagesResponse)
+      end
+      def web_scrape_images(
+        # Full URL to scrape images from (must include http:// or https:// protocol)
+        url:,
+        request_options: {}
+      )
+      end
+
+      # Scrapes the given URL, converts the HTML content to GitHub Flavored Markdown
+      # (GFM), and returns the result. Uses automatic proxy escalation to handle blocked
+      # sites.
+      sig do
+        params(
+          url: String,
+          include_images: T::Boolean,
+          include_links: T::Boolean,
+          shorten_base64_images: T::Boolean,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(ContextDev::Models::WebWebScrapeMdResponse)
+      end
+      def web_scrape_md(
+        # Full URL to scrape and convert to markdown (must include http:// or https://
+        # protocol)
+        url:,
+        # Include image references in Markdown output
+        include_images: nil,
+        # Preserve hyperlinks in Markdown output
+        include_links: nil,
+        # Shorten base64-encoded image data in the Markdown output
+        shorten_base64_images: nil,
+        request_options: {}
+      )
+      end
+
+      # Crawls the sitemap of the given domain and returns all discovered page URLs.
+      # Supports sitemap index files (recursive), parallel fetching with concurrency
+      # control, deduplication, and filters out non-page resources (images, PDFs, etc.).
+      sig do
+        params(
+          domain: String,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(ContextDev::Models::WebWebScrapeSitemapResponse)
+      end
+      def web_scrape_sitemap(
+        # Domain name to crawl sitemaps for (e.g., 'example.com'). The domain will be
+        # automatically normalized and validated.
+        domain:,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: ContextDev::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/sig/context_dev/client.rbs

@@ -10,8 +10,18 @@ module ContextDev
 
     attr_reader api_key: String
 
+    attr_reader web: ContextDev::Resources::Web
+
+    attr_reader ai: ContextDev::Resources::AI
+
+    attr_reader style: ContextDev::Resources::Style
+
     attr_reader brand: ContextDev::Resources::Brand
 
+    attr_reader industry: ContextDev::Resources::Industry
+
+    attr_reader utility: ContextDev::Resources::Utility
+
     private def auth_headers: -> ::Hash[String, String]
 
     def initialize: (

data/sig/context_dev/models/{brand_ai_query_params.rbs → ai_ai_query_params.rbs}

@@ -1,44 +1,44 @@
 module ContextDev
   module Models
-    type brand_ai_query_params =
+    type aiai_query_params =
       {
-        data_to_extract: ::Array[ContextDev::BrandAIQueryParams::DataToExtract],
+        data_to_extract: ::Array[ContextDev::AIAIQueryParams::DataToExtract],
         domain: String,
-        specific_pages: ContextDev::BrandAIQueryParams::SpecificPages,
+        specific_pages: ContextDev::AIAIQueryParams::SpecificPages,
         timeout_ms: Integer
       }
       & ContextDev::Internal::Type::request_parameters
 
-    class BrandAIQueryParams < ContextDev::Internal::Type::BaseModel
+    class AIAIQueryParams < ContextDev::Internal::Type::BaseModel
       extend ContextDev::Internal::Type::RequestParameters::Converter
       include ContextDev::Internal::Type::RequestParameters
 
-      attr_accessor data_to_extract: ::Array[ContextDev::BrandAIQueryParams::DataToExtract]
+      attr_accessor data_to_extract: ::Array[ContextDev::AIAIQueryParams::DataToExtract]
 
       attr_accessor domain: String
 
-      attr_reader specific_pages: ContextDev::BrandAIQueryParams::SpecificPages?
+      attr_reader specific_pages: ContextDev::AIAIQueryParams::SpecificPages?
 
       def specific_pages=: (
-        ContextDev::BrandAIQueryParams::SpecificPages
-      ) -> ContextDev::BrandAIQueryParams::SpecificPages
+        ContextDev::AIAIQueryParams::SpecificPages
+      ) -> ContextDev::AIAIQueryParams::SpecificPages
 
       attr_reader timeout_ms: Integer?
 
       def timeout_ms=: (Integer) -> Integer
 
       def initialize: (
-        data_to_extract: ::Array[ContextDev::BrandAIQueryParams::DataToExtract],
+        data_to_extract: ::Array[ContextDev::AIAIQueryParams::DataToExtract],
         domain: String,
-        ?specific_pages: ContextDev::BrandAIQueryParams::SpecificPages,
+        ?specific_pages: ContextDev::AIAIQueryParams::SpecificPages,
         ?timeout_ms: Integer,
         ?request_options: ContextDev::request_opts
       ) -> void
 
       def to_hash: -> {
-        data_to_extract: ::Array[ContextDev::BrandAIQueryParams::DataToExtract],
+        data_to_extract: ::Array[ContextDev::AIAIQueryParams::DataToExtract],
         domain: String,
-        specific_pages: ContextDev::BrandAIQueryParams::SpecificPages,
+        specific_pages: ContextDev::AIAIQueryParams::SpecificPages,
         timeout_ms: Integer,
         request_options: ContextDev::RequestOptions
       }
@@ -48,9 +48,9 @@ module ContextDev
           datapoint_description: String,
           datapoint_example: String,
           datapoint_name: String,
-          datapoint_type: ContextDev::Models::BrandAIQueryParams::DataToExtract::datapoint_type,
-          datapoint_list_type: ContextDev::Models::BrandAIQueryParams::DataToExtract::datapoint_list_type,
-          datapoint_object_schema: ::Hash[Symbol, ContextDev::Models::BrandAIQueryParams::DataToExtract::datapoint_object_schema]
+          datapoint_type: ContextDev::Models::AIAIQueryParams::DataToExtract::datapoint_type,
+          datapoint_list_type: ContextDev::Models::AIAIQueryParams::DataToExtract::datapoint_list_type,
+          datapoint_object_schema: ::Hash[Symbol, ContextDev::Models::AIAIQueryParams::DataToExtract::datapoint_object_schema]
         }
 
       class DataToExtract < ContextDev::Internal::Type::BaseModel
@@ -60,36 +60,36 @@ module ContextDev
 
         attr_accessor datapoint_name: String
 
-        attr_accessor datapoint_type: ContextDev::Models::BrandAIQueryParams::DataToExtract::datapoint_type
+        attr_accessor datapoint_type: ContextDev::Models::AIAIQueryParams::DataToExtract::datapoint_type
 
-        attr_reader datapoint_list_type: ContextDev::Models::BrandAIQueryParams::DataToExtract::datapoint_list_type?
+        attr_reader datapoint_list_type: ContextDev::Models::AIAIQueryParams::DataToExtract::datapoint_list_type?
 
         def datapoint_list_type=: (
-          ContextDev::Models::BrandAIQueryParams::DataToExtract::datapoint_list_type
-        ) -> ContextDev::Models::BrandAIQueryParams::DataToExtract::datapoint_list_type
+          ContextDev::Models::AIAIQueryParams::DataToExtract::datapoint_list_type
+        ) -> ContextDev::Models::AIAIQueryParams::DataToExtract::datapoint_list_type
 
-        attr_reader datapoint_object_schema: ::Hash[Symbol, ContextDev::Models::BrandAIQueryParams::DataToExtract::datapoint_object_schema]?
+        attr_reader datapoint_object_schema: ::Hash[Symbol, ContextDev::Models::AIAIQueryParams::DataToExtract::datapoint_object_schema]?
 
         def datapoint_object_schema=: (
-          ::Hash[Symbol, ContextDev::Models::BrandAIQueryParams::DataToExtract::datapoint_object_schema]
-        ) -> ::Hash[Symbol, ContextDev::Models::BrandAIQueryParams::DataToExtract::datapoint_object_schema]
+          ::Hash[Symbol, ContextDev::Models::AIAIQueryParams::DataToExtract::datapoint_object_schema]
+        ) -> ::Hash[Symbol, ContextDev::Models::AIAIQueryParams::DataToExtract::datapoint_object_schema]
 
         def initialize: (
           datapoint_description: String,
           datapoint_example: String,
           datapoint_name: String,
-          datapoint_type: ContextDev::Models::BrandAIQueryParams::DataToExtract::datapoint_type,
-          ?datapoint_list_type: ContextDev::Models::BrandAIQueryParams::DataToExtract::datapoint_list_type,
-          ?datapoint_object_schema: ::Hash[Symbol, ContextDev::Models::BrandAIQueryParams::DataToExtract::datapoint_object_schema]
+          datapoint_type: ContextDev::Models::AIAIQueryParams::DataToExtract::datapoint_type,
+          ?datapoint_list_type: ContextDev::Models::AIAIQueryParams::DataToExtract::datapoint_list_type,
+          ?datapoint_object_schema: ::Hash[Symbol, ContextDev::Models::AIAIQueryParams::DataToExtract::datapoint_object_schema]
         ) -> void
 
         def to_hash: -> {
           datapoint_description: String,
           datapoint_example: String,
           datapoint_name: String,
-          datapoint_type: ContextDev::Models::BrandAIQueryParams::DataToExtract::datapoint_type,
-          datapoint_list_type: ContextDev::Models::BrandAIQueryParams::DataToExtract::datapoint_list_type,
-          datapoint_object_schema: ::Hash[Symbol, ContextDev::Models::BrandAIQueryParams::DataToExtract::datapoint_object_schema]
+          datapoint_type: ContextDev::Models::AIAIQueryParams::DataToExtract::datapoint_type,
+          datapoint_list_type: ContextDev::Models::AIAIQueryParams::DataToExtract::datapoint_list_type,
+          datapoint_object_schema: ::Hash[Symbol, ContextDev::Models::AIAIQueryParams::DataToExtract::datapoint_object_schema]
         }
 
         type datapoint_type = :text | :number | :date | :boolean | :list | :url
@@ -104,7 +104,7 @@ module ContextDev
           LIST: :list
           URL: :url
 
-          def self?.values: -> ::Array[ContextDev::Models::BrandAIQueryParams::DataToExtract::datapoint_type]
+          def self?.values: -> ::Array[ContextDev::Models::AIAIQueryParams::DataToExtract::datapoint_type]
         end
 
         type datapoint_list_type =
@@ -122,7 +122,7 @@ module ContextDev
           URL: :url
           OBJECT: :object
 
-          def self?.values: -> ::Array[ContextDev::Models::BrandAIQueryParams::DataToExtract::datapoint_list_type]
+          def self?.values: -> ::Array[ContextDev::Models::AIAIQueryParams::DataToExtract::datapoint_list_type]
         end
 
         type datapoint_object_schema = :string | :number | :date | :boolean
@@ -135,7 +135,7 @@ module ContextDev
           DATE: :date
           BOOLEAN: :boolean
 
-          def self?.values: -> ::Array[ContextDev::Models::BrandAIQueryParams::DataToExtract::datapoint_object_schema]
+          def self?.values: -> ::Array[ContextDev::Models::AIAIQueryParams::DataToExtract::datapoint_object_schema]
         end
       end
 

data/sig/context_dev/models/{brand_ai_query_response.rbs → ai_ai_query_response.rbs}

@@ -1,19 +1,19 @@
 module ContextDev
   module Models
-    type brand_ai_query_response =
+    type aiai_query_response =
       {
-        data_extracted: ::Array[ContextDev::Models::BrandAIQueryResponse::DataExtracted],
+        data_extracted: ::Array[ContextDev::Models::AIAIQueryResponse::DataExtracted],
         domain: String,
         status: String,
         urls_analyzed: ::Array[String]
       }
 
-    class BrandAIQueryResponse < ContextDev::Internal::Type::BaseModel
-      attr_reader data_extracted: ::Array[ContextDev::Models::BrandAIQueryResponse::DataExtracted]?
+    class AIAIQueryResponse < ContextDev::Internal::Type::BaseModel
+      attr_reader data_extracted: ::Array[ContextDev::Models::AIAIQueryResponse::DataExtracted]?
 
       def data_extracted=: (
-        ::Array[ContextDev::Models::BrandAIQueryResponse::DataExtracted]
-      ) -> ::Array[ContextDev::Models::BrandAIQueryResponse::DataExtracted]
+        ::Array[ContextDev::Models::AIAIQueryResponse::DataExtracted]
+      ) -> ::Array[ContextDev::Models::AIAIQueryResponse::DataExtracted]
 
       attr_reader domain: String?
 
@@ -28,14 +28,14 @@ module ContextDev
       def urls_analyzed=: (::Array[String]) -> ::Array[String]
 
       def initialize: (
-        ?data_extracted: ::Array[ContextDev::Models::BrandAIQueryResponse::DataExtracted],
+        ?data_extracted: ::Array[ContextDev::Models::AIAIQueryResponse::DataExtracted],
         ?domain: String,
         ?status: String,
         ?urls_analyzed: ::Array[String]
       ) -> void
 
       def to_hash: -> {
-        data_extracted: ::Array[ContextDev::Models::BrandAIQueryResponse::DataExtracted],
+        data_extracted: ::Array[ContextDev::Models::AIAIQueryResponse::DataExtracted],
         domain: String,
         status: String,
         urls_analyzed: ::Array[String]
@@ -44,7 +44,7 @@ module ContextDev
       type data_extracted =
         {
           datapoint_name: String,
-          datapoint_value: ContextDev::Models::BrandAIQueryResponse::DataExtracted::datapoint_value
+          datapoint_value: ContextDev::Models::AIAIQueryResponse::DataExtracted::datapoint_value
         }
 
       class DataExtracted < ContextDev::Internal::Type::BaseModel
@@ -52,20 +52,20 @@ module ContextDev
 
         def datapoint_name=: (String) -> String
 
-        attr_reader datapoint_value: ContextDev::Models::BrandAIQueryResponse::DataExtracted::datapoint_value?
+        attr_reader datapoint_value: ContextDev::Models::AIAIQueryResponse::DataExtracted::datapoint_value?
 
         def datapoint_value=: (
-          ContextDev::Models::BrandAIQueryResponse::DataExtracted::datapoint_value
-        ) -> ContextDev::Models::BrandAIQueryResponse::DataExtracted::datapoint_value
+          ContextDev::Models::AIAIQueryResponse::DataExtracted::datapoint_value
+        ) -> ContextDev::Models::AIAIQueryResponse::DataExtracted::datapoint_value
 
         def initialize: (
           ?datapoint_name: String,
-          ?datapoint_value: ContextDev::Models::BrandAIQueryResponse::DataExtracted::datapoint_value
+          ?datapoint_value: ContextDev::Models::AIAIQueryResponse::DataExtracted::datapoint_value
         ) -> void
 
         def to_hash: -> {
           datapoint_name: String,
-          datapoint_value: ContextDev::Models::BrandAIQueryResponse::DataExtracted::datapoint_value
+          datapoint_value: ContextDev::Models::AIAIQueryResponse::DataExtracted::datapoint_value
         }
 
         type datapoint_value =
@@ -79,7 +79,7 @@ module ContextDev
         module DatapointValue
           extend ContextDev::Internal::Type::Union
 
-          def self?.variants: -> ::Array[ContextDev::Models::BrandAIQueryResponse::DataExtracted::datapoint_value]
+          def self?.variants: -> ::Array[ContextDev::Models::AIAIQueryResponse::DataExtracted::datapoint_value]
 
           StringArray: ContextDev::Internal::Type::Converter
 

data/sig/context_dev/models/{brand_ai_product_params.rbs → ai_extract_product_params.rbs}

@@ -1,10 +1,10 @@
 module ContextDev
   module Models
-    type brand_ai_product_params =
+    type ai_extract_product_params =
       { url: String, timeout_ms: Integer }
       & ContextDev::Internal::Type::request_parameters
 
-    class BrandAIProductParams < ContextDev::Internal::Type::BaseModel
+    class AIExtractProductParams < ContextDev::Internal::Type::BaseModel
       extend ContextDev::Internal::Type::RequestParameters::Converter
       include ContextDev::Internal::Type::RequestParameters