context.dev 1.34.0 → 1.36.0

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

data/lib/context_dev/models/web_web_crawl_md_params.rb

@@ -13,6 +13,14 @@ module ContextDev
       #   @return [String]
       required :url, String
 
+      # @!attribute country
+      #   Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev
+      #   residential proxy exit location. Must be one of Context.dev's supported
+      #   countries. When provided, Context.dev fetches the target page from that country.
+      #
+      #   @return [Symbol, ContextDev::Models::WebWebCrawlMdParams::Country, nil]
+      optional :country, enum: -> { ContextDev::WebWebCrawlMdParams::Country }
+
       # @!attribute exclude_selectors
       #   CSS selectors to remove before each crawled page is converted to Markdown.
       #   Applied after includeSelectors. Exclusion takes precedence: an element matching
@@ -127,12 +135,14 @@ module ContextDev
       #   @return [Integer, nil]
       optional :wait_for_ms, Integer, api_name: :waitForMs
 
-      # @!method initialize(url:, exclude_selectors: nil, follow_subdomains: nil, include_frames: nil, include_images: nil, include_links: nil, include_selectors: nil, max_age_ms: nil, max_depth: nil, max_pages: nil, pdf: nil, shorten_base64_images: nil, stop_after_ms: nil, timeout_ms: nil, url_regex: nil, use_main_content_only: nil, wait_for_ms: nil, request_options: {})
+      # @!method initialize(url:, country: nil, exclude_selectors: nil, follow_subdomains: nil, include_frames: nil, include_images: nil, include_links: nil, include_selectors: nil, max_age_ms: nil, max_depth: nil, max_pages: nil, pdf: nil, shorten_base64_images: nil, stop_after_ms: nil, timeout_ms: nil, url_regex: nil, use_main_content_only: nil, wait_for_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebWebCrawlMdParams} for more details.
       #
       #   @param url [String] The starting URL for the crawl (must include http:// or https:// protocol)
       #
+      #   @param country [Symbol, ContextDev::Models::WebWebCrawlMdParams::Country] Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev r
+      #
       #   @param exclude_selectors [Array<String>] CSS selectors to remove before each crawled page is converted to Markdown. Appli
       #
       #   @param follow_subdomains [Boolean] When true, follow links on subdomains of the starting URL's domain (e.g. docs.ex
@@ -167,6 +177,221 @@ module ContextDev
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
 
+      # Two-letter ISO 3166-1 alpha-2 country code identifying a supported Context.dev
+      # residential proxy exit location. Must be one of Context.dev's supported
+      # countries. When provided, Context.dev fetches the target page from that country.
+      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
+
       class Pdf < ContextDev::Internal::Type::BaseModel
         # @!attribute end_
         #   Last 1-based PDF page to parse. When omitted, parsing ends at the last page.