context.dev 1.35.0 → 2.0.0

data/lib/context_dev/models/web_extract_styleguide_params.rb

@@ -7,6 +7,13 @@ module ContextDev
       extend ContextDev::Internal::Type::RequestParameters::Converter
       include ContextDev::Internal::Type::RequestParameters
 
+      # @!attribute color_scheme
+      #   Optional browser color scheme to emulate for websites that respond to
+      #   prefers-color-scheme. This value is part of the styleguide cache key.
+      #
+      #   @return [Symbol, ContextDev::Models::WebExtractStyleguideParams::ColorScheme, nil]
+      optional :color_scheme, enum: -> { ContextDev::WebExtractStyleguideParams::ColorScheme }
+
       # @!attribute direct_url
       #   A specific URL to fetch the styleguide from directly, bypassing domain
       #   resolution (e.g., 'https://example.com/design-system'). When provided, the
@@ -41,10 +48,12 @@ module ContextDev
       #   @return [Integer, nil]
       optional :timeout_ms, Integer
 
-      # @!method initialize(direct_url: nil, domain: nil, max_age_ms: nil, timeout_ms: nil, request_options: {})
+      # @!method initialize(color_scheme: nil, direct_url: nil, domain: nil, max_age_ms: nil, timeout_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebExtractStyleguideParams} for more details.
       #
+      #   @param color_scheme [Symbol, ContextDev::Models::WebExtractStyleguideParams::ColorScheme] Optional browser color scheme to emulate for websites that respond to prefers-co
+      #
       #   @param direct_url [String] A specific URL to fetch the styleguide from directly, bypassing domain resolutio
       #
       #   @param domain [String] Domain name to extract styleguide from (e.g., 'example.com', 'google.com'). The
@@ -54,6 +63,18 @@ module ContextDev
       #   @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}]
+
+      # Optional browser color scheme to emulate for websites that respond to
+      # prefers-color-scheme. This value is part of the styleguide cache key.
+      module ColorScheme
+        extend ContextDev::Internal::Type::Enum
+
+        LIGHT = :light
+        DARK = :dark
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
     end
   end
 end

data/lib/context_dev/models/web_screenshot_params.rb

@@ -7,6 +7,20 @@ module ContextDev
       extend ContextDev::Internal::Type::RequestParameters::Converter
       include ContextDev::Internal::Type::RequestParameters
 
+      # @!attribute color_scheme
+      #   Optional parameter to choose the site's visual theme in the screenshot. Use
+      #   'light' or 'dark' when the site offers both appearances.
+      #
+      #   @return [Symbol, ContextDev::Models::WebScreenshotParams::ColorScheme, nil]
+      optional :color_scheme, enum: -> { ContextDev::WebScreenshotParams::ColorScheme }
+
+      # @!attribute country
+      #   Two-letter ISO 3166-1 alpha-2 country code for the website request location.
+      #   When provided, Context.dev fetches the target page from that country.
+      #
+      #   @return [Symbol, ContextDev::Models::WebScreenshotParams::Country, nil]
+      optional :country, enum: -> { ContextDev::WebScreenshotParams::Country }
+
       # @!attribute direct_url
       #   A specific URL to screenshot directly, bypassing domain resolution (e.g.,
       #   'https://example.com/pricing'). When provided, the screenshot is taken of this
@@ -90,10 +104,14 @@ module ContextDev
       #   @return [Integer, nil]
       optional :wait_for_ms, Integer
 
-      # @!method initialize(direct_url: nil, domain: nil, full_screenshot: nil, handle_cookie_popup: nil, max_age_ms: nil, page: nil, scroll_offset: nil, timeout_ms: nil, viewport: nil, wait_for_ms: nil, request_options: {})
+      # @!method initialize(color_scheme: nil, country: nil, direct_url: nil, domain: nil, full_screenshot: nil, handle_cookie_popup: nil, max_age_ms: nil, page: nil, scroll_offset: nil, timeout_ms: nil, viewport: nil, wait_for_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebScreenshotParams} for more details.
       #
+      #   @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 for the website request location. Whe
+      #
       #   @param direct_url [String] A specific URL to screenshot directly, bypassing domain resolution (e.g., 'https
       #
       #   @param domain [String] Domain name to take screenshot of (e.g., 'example.com', 'google.com'). The domai
@@ -116,6 +134,232 @@ module ContextDev
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
 
+      # Optional parameter to choose the site's visual theme in the screenshot. Use
+      # 'light' or 'dark' when the site offers both appearances.
+      module ColorScheme
+        extend ContextDev::Internal::Type::Enum
+
+        LIGHT = :light
+        DARK = :dark
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Two-letter ISO 3166-1 alpha-2 country code for the website request location.
+      # When provided, Context.dev fetches the target page from that country.
+      module Country
+        extend ContextDev::Internal::Type::Enum
+
+        AD = :ad
+        AE = :ae
+        AF = :af
+        AG = :ag
+        AI = :ai
+        AL = :al
+        AM = :am
+        AO = :ao
+        AR = :ar
+        AT = :at
+        AU = :au
+        AW = :aw
+        AZ = :az
+        BA = :ba
+        BB = :bb
+        BD = :bd
+        BE = :be
+        BF = :bf
+        BG = :bg
+        BH = :bh
+        BI = :bi
+        BJ = :bj
+        BM = :bm
+        BN = :bn
+        BO = :bo
+        BQ = :bq
+        BR = :br
+        BS = :bs
+        BW = :bw
+        BY = :by
+        BZ = :bz
+        CA = :ca
+        CD = :cd
+        CF = :cf
+        CG = :cg
+        CH = :ch
+        CI = :ci
+        CL = :cl
+        CM = :cm
+        CN = :cn
+        CO = :co
+        CR = :cr
+        CV = :cv
+        CW = :cw
+        CY = :cy
+        CZ = :cz
+        DE = :de
+        DJ = :dj
+        DK = :dk
+        DM = :dm
+        DO = :do
+        DZ = :dz
+        EC = :ec
+        EE = :ee
+        EG = :eg
+        ES = :es
+        ET = :et
+        FI = :fi
+        FJ = :fj
+        FR = :fr
+        GA = :ga
+        GB = :gb
+        GD = :gd
+        GE = :ge
+        GF = :gf
+        GG = :gg
+        GH = :gh
+        GM = :gm
+        GN = :gn
+        GP = :gp
+        GQ = :gq
+        GR = :gr
+        GT = :gt
+        GU = :gu
+        GW = :gw
+        GY = :gy
+        HK = :hk
+        HN = :hn
+        HR = :hr
+        HT = :ht
+        HU = :hu
+        ID = :id
+        IE = :ie
+        IL = :il
+        IM = :im
+        IN = :in
+        IQ = :iq
+        IR = :ir
+        IS = :is
+        IT = :it
+        JE = :je
+        JM = :jm
+        JO = :jo
+        JP = :jp
+        KE = :ke
+        KG = :kg
+        KH = :kh
+        KN = :kn
+        KR = :kr
+        KW = :kw
+        KY = :ky
+        KZ = :kz
+        LA = :la
+        LB = :lb
+        LC = :lc
+        LK = :lk
+        LR = :lr
+        LS = :ls
+        LT = :lt
+        LU = :lu
+        LV = :lv
+        LY = :ly
+        MA = :ma
+        MC = :mc
+        MD = :md
+        ME = :me
+        MF = :mf
+        MG = :mg
+        MK = :mk
+        ML = :ml
+        MM = :mm
+        MN = :mn
+        MO = :mo
+        MQ = :mq
+        MR = :mr
+        MT = :mt
+        MU = :mu
+        MV = :mv
+        MW = :mw
+        MX = :mx
+        MY = :my
+        MZ = :mz
+        NA = :na
+        NC = :nc
+        NE = :ne
+        NG = :ng
+        NI = :ni
+        NL = :nl
+        NO = :no
+        NP = :np
+        NZ = :nz
+        OM = :om
+        PA = :pa
+        PE = :pe
+        PF = :pf
+        PG = :pg
+        PH = :ph
+        PK = :pk
+        PL = :pl
+        PR = :pr
+        PS = :ps
+        PT = :pt
+        PY = :py
+        QA = :qa
+        RE = :re
+        RO = :ro
+        RS = :rs
+        RU = :ru
+        RW = :rw
+        SA = :sa
+        SC = :sc
+        SD = :sd
+        SE = :se
+        SG = :sg
+        SI = :si
+        SK = :sk
+        SL = :sl
+        SM = :sm
+        SN = :sn
+        SO = :so
+        SR = :sr
+        SS = :ss
+        ST = :st
+        SV = :sv
+        SX = :sx
+        SY = :sy
+        SZ = :sz
+        TC = :tc
+        TD = :td
+        TG = :tg
+        TH = :th
+        TJ = :tj
+        TL = :tl
+        TM = :tm
+        TN = :tn
+        TR = :tr
+        TT = :tt
+        TW = :tw
+        TZ = :tz
+        UA = :ua
+        UG = :ug
+        US = :us
+        UY = :uy
+        UZ = :uz
+        VC = :vc
+        VE = :ve
+        VG = :vg
+        VI = :vi
+        VN = :vn
+        YE = :ye
+        YT = :yt
+        ZA = :za
+        ZM = :zm
+        ZW = :zw
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
       # 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).

data/lib/context_dev/models/web_search_params.rb

@@ -8,11 +8,19 @@ module ContextDev
       include ContextDev::Internal::Type::RequestParameters
 
       # @!attribute query
-      #   Natural-language search query.
+      #   Search query. Accepts natural language as well as Google-style search operators
+      #   such as `site:`, `-site:`, `inurl:`, `intitle:`, quoted phrases, and `OR`.
       #
       #   @return [String]
       required :query, String
 
+      # @!attribute country
+      #   Two-letter ISO 3166-1 alpha-2 country code to localize results to a specific
+      #   country (maps to Google's `gl` parameter). Example: "us", "gb", "de".
+      #
+      #   @return [Symbol, ContextDev::Models::WebSearchParams::Country, nil]
+      optional :country, enum: -> { ContextDev::WebSearchParams::Country }
+
       # @!attribute exclude_domains
       #   Blocklist — drop results from these domains. Example: ["pinterest.com",
       #   "reddit.com"].
@@ -41,6 +49,12 @@ module ContextDev
                -> { ContextDev::WebSearchParams::MarkdownOptions },
                api_name: :markdownOptions
 
+      # @!attribute num_results
+      #   Number of results to request and return (10–100). Defaults to 10.
+      #
+      #   @return [Integer, nil]
+      optional :num_results, Integer, api_name: :numResults
+
       # @!attribute query_fanout
       #   Expand the query into multiple parallel variants for broader recall.
       #
@@ -55,11 +69,13 @@ module ContextDev
       #   @return [Integer, nil]
       optional :timeout_ms, Integer, api_name: :timeoutMS
 
-      # @!method initialize(query:, exclude_domains: nil, freshness: nil, include_domains: nil, markdown_options: nil, query_fanout: nil, timeout_ms: nil, request_options: {})
+      # @!method initialize(query:, country: nil, exclude_domains: nil, freshness: nil, include_domains: nil, markdown_options: nil, num_results: nil, query_fanout: nil, timeout_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebSearchParams} for more details.
       #
-      #   @param query [String] Natural-language search query.
+      #   @param query [String] Search query. Accepts natural language as well as Google-style search operators
+      #
+      #   @param country [Symbol, ContextDev::Models::WebSearchParams::Country] Two-letter ISO 3166-1 alpha-2 country code to localize results to a specific cou
       #
       #   @param exclude_domains [Array<String>] Blocklist — drop results from these domains. Example: ["pinterest.com", "reddit.
       #
@@ -69,12 +85,263 @@ module ContextDev
       #
       #   @param markdown_options [ContextDev::Models::WebSearchParams::MarkdownOptions] Inline Markdown scraping for each result. Set `enabled: true` to activate.
       #
+      #   @param num_results [Integer] Number of results to request and return (10–100). Defaults to 10.
+      #
       #   @param query_fanout [Boolean] Expand the query into multiple parallel variants for broader recall.
       #
       #   @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}]
 
+      # Two-letter ISO 3166-1 alpha-2 country code to localize results to a specific
+      # country (maps to Google's `gl` parameter). Example: "us", "gb", "de".
+      module Country
+        extend ContextDev::Internal::Type::Enum
+
+        AF = :af
+        AL = :al
+        DZ = :dz
+        AS = :as
+        AD = :ad
+        AO = :ao
+        AI = :ai
+        AQ = :aq
+        AG = :ag
+        AR = :ar
+        AM = :am
+        AW = :aw
+        AU = :au
+        AT = :at
+        AZ = :az
+        BS = :bs
+        BH = :bh
+        BD = :bd
+        BB = :bb
+        BY = :by
+        BE = :be
+        BZ = :bz
+        BJ = :bj
+        BM = :bm
+        BT = :bt
+        BO = :bo
+        BA = :ba
+        BW = :bw
+        BV = :bv
+        BR = :br
+        IO = :io
+        BN = :bn
+        BG = :bg
+        BF = :bf
+        BI = :bi
+        KH = :kh
+        CM = :cm
+        CA = :ca
+        CV = :cv
+        KY = :ky
+        CF = :cf
+        TD = :td
+        CL = :cl
+        CN = :cn
+        CX = :cx
+        CC = :cc
+        CO = :co
+        KM = :km
+        CG = :cg
+        CD = :cd
+        CK = :ck
+        CR = :cr
+        CI = :ci
+        HR = :hr
+        CU = :cu
+        CY = :cy
+        CZ = :cz
+        DK = :dk
+        DJ = :dj
+        DM = :dm
+        DO = :do
+        EC = :ec
+        EG = :eg
+        SV = :sv
+        GQ = :gq
+        ER = :er
+        EE = :ee
+        ET = :et
+        FK = :fk
+        FO = :fo
+        FJ = :fj
+        FI = :fi
+        FR = :fr
+        GF = :gf
+        PF = :pf
+        TF = :tf
+        GA = :ga
+        GM = :gm
+        GE = :ge
+        DE = :de
+        GH = :gh
+        GI = :gi
+        GR = :gr
+        GL = :gl
+        GD = :gd
+        GP = :gp
+        GU = :gu
+        GT = :gt
+        GN = :gn
+        GW = :gw
+        GY = :gy
+        HT = :ht
+        HM = :hm
+        VA = :va
+        HN = :hn
+        HK = :hk
+        HU = :hu
+        IS = :is
+        IN = :in
+        ID = :id
+        IR = :ir
+        IQ = :iq
+        IE = :ie
+        IL = :il
+        IT = :it
+        JM = :jm
+        JP = :jp
+        JO = :jo
+        KZ = :kz
+        KE = :ke
+        KI = :ki
+        KP = :kp
+        KR = :kr
+        KW = :kw
+        KG = :kg
+        LA = :la
+        LV = :lv
+        LB = :lb
+        LS = :ls
+        LR = :lr
+        LY = :ly
+        LI = :li
+        LT = :lt
+        LU = :lu
+        MO = :mo
+        MK = :mk
+        MG = :mg
+        MW = :mw
+        MY = :my
+        MV = :mv
+        ML = :ml
+        MT = :mt
+        MH = :mh
+        MQ = :mq
+        MR = :mr
+        MU = :mu
+        YT = :yt
+        MX = :mx
+        FM = :fm
+        MD = :md
+        MC = :mc
+        MN = :mn
+        MS = :ms
+        MA = :ma
+        MZ = :mz
+        MM = :mm
+        NA = :na
+        NR = :nr
+        NP = :np
+        NL = :nl
+        AN = :an
+        NC = :nc
+        NZ = :nz
+        NI = :ni
+        NE = :ne
+        NG = :ng
+        NU = :nu
+        NF = :nf
+        MP = :mp
+        NO = :no
+        OM = :om
+        PK = :pk
+        PW = :pw
+        PS = :ps
+        PA = :pa
+        PG = :pg
+        PY = :py
+        PE = :pe
+        PH = :ph
+        PN = :pn
+        PL = :pl
+        PT = :pt
+        PR = :pr
+        QA = :qa
+        RE = :re
+        RO = :ro
+        RU = :ru
+        RW = :rw
+        SH = :sh
+        KN = :kn
+        LC = :lc
+        PM = :pm
+        VC = :vc
+        WS = :ws
+        SM = :sm
+        ST = :st
+        SA = :sa
+        SN = :sn
+        RS = :rs
+        SC = :sc
+        SL = :sl
+        SG = :sg
+        SK = :sk
+        SI = :si
+        SB = :sb
+        SO = :so
+        ZA = :za
+        GS = :gs
+        ES = :es
+        LK = :lk
+        SD = :sd
+        SR = :sr
+        SJ = :sj
+        SZ = :sz
+        SE = :se
+        CH = :ch
+        SY = :sy
+        TW = :tw
+        TJ = :tj
+        TZ = :tz
+        TH = :th
+        TL = :tl
+        TG = :tg
+        TK = :tk
+        TO = :to
+        TT = :tt
+        TN = :tn
+        TR = :tr
+        TM = :tm
+        TC = :tc
+        TV = :tv
+        UG = :ug
+        UA = :ua
+        AE = :ae
+        GB = :gb
+        US = :us
+        UM = :um
+        UY = :uy
+        UZ = :uz
+        VU = :vu
+        VE = :ve
+        VN = :vn
+        VG = :vg
+        VI = :vi
+        WF = :wf
+        EH = :eh
+        YE = :ye
+        ZM = :zm
+        ZW = :zw
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
       # Restrict results to content published within this window.
       module Freshness
         extend ContextDev::Internal::Type::Enum