context.dev 1.34.0 → 1.36.0

data/rbi/context_dev/models/web_web_scrape_md_params.rbi

@@ -16,6 +16,20 @@ module ContextDev
       sig { returns(String) }
       attr_accessor :url
 
+      # 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.
+      sig do
+        returns(T.nilable(ContextDev::WebWebScrapeMdParams::Country::OrSymbol))
+      end
+      attr_reader :country
+
+      sig do
+        params(
+          country: ContextDev::WebWebScrapeMdParams::Country::OrSymbol
+        ).void
+      end
+      attr_writer :country
+
       # CSS selectors to remove before conversion to Markdown. Applied after
       # includeSelectors. Exclusion takes precedence: an element matching both is
       # removed. Examples: "nav", "footer", ".ad-banner", "[aria-hidden=true]".
@@ -116,6 +130,7 @@ module ContextDev
       sig do
         params(
           url: String,
+          country: ContextDev::WebWebScrapeMdParams::Country::OrSymbol,
           exclude_selectors: T::Array[String],
           headers: T::Hash[Symbol, String],
           include_frames: T::Boolean,
@@ -135,6 +150,9 @@ module ContextDev
         # Full URL to scrape into LLM usable Markdown (must include http:// or https://
         # protocol)
         url:,
+        # 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.
+        country: nil,
         # CSS selectors to remove before conversion to Markdown. Applied after
         # includeSelectors. Exclusion takes precedence: an element matching both is
         # removed. Examples: "nav", "footer", ".ad-banner", "[aria-hidden=true]".
@@ -180,6 +198,7 @@ module ContextDev
         override.returns(
           {
             url: String,
+            country: ContextDev::WebWebScrapeMdParams::Country::OrSymbol,
             exclude_selectors: T::Array[String],
             headers: T::Hash[Symbol, String],
             include_frames: T::Boolean,
@@ -199,6 +218,231 @@ module ContextDev
       def to_hash
       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
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, ContextDev::WebWebScrapeMdParams::Country)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        AD = T.let(:ad, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        AE = T.let(:ae, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        AF = T.let(:af, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        AG = T.let(:ag, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        AI = T.let(:ai, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        AL = T.let(:al, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        AM = T.let(:am, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        AO = T.let(:ao, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        AR = T.let(:ar, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        AT = T.let(:at, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        AU = T.let(:au, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        AW = T.let(:aw, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        AZ = T.let(:az, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        BA = T.let(:ba, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        BB = T.let(:bb, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        BD = T.let(:bd, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        BE = T.let(:be, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        BF = T.let(:bf, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        BG = T.let(:bg, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        BH = T.let(:bh, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        BI = T.let(:bi, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        BJ = T.let(:bj, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        BM = T.let(:bm, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        BN = T.let(:bn, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        BO = T.let(:bo, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        BQ = T.let(:bq, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        BR = T.let(:br, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        BS = T.let(:bs, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        BW = T.let(:bw, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        BY = T.let(:by, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        BZ = T.let(:bz, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        CA = T.let(:ca, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        CD = T.let(:cd, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        CF = T.let(:cf, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        CG = T.let(:cg, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        CH = T.let(:ch, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        CI = T.let(:ci, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        CL = T.let(:cl, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        CM = T.let(:cm, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        CN = T.let(:cn, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        CO = T.let(:co, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        CR = T.let(:cr, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        CV = T.let(:cv, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        CW = T.let(:cw, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        CY = T.let(:cy, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        CZ = T.let(:cz, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        DE = T.let(:de, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        DJ = T.let(:dj, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        DK = T.let(:dk, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        DM = T.let(:dm, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        DO = T.let(:do, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        DZ = T.let(:dz, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        EC = T.let(:ec, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        EE = T.let(:ee, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        EG = T.let(:eg, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        ES = T.let(:es, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        ET = T.let(:et, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        FI = T.let(:fi, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        FJ = T.let(:fj, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        FR = T.let(:fr, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        GA = T.let(:ga, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        GB = T.let(:gb, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        GD = T.let(:gd, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        GE = T.let(:ge, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        GF = T.let(:gf, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        GG = T.let(:gg, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        GH = T.let(:gh, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        GM = T.let(:gm, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        GN = T.let(:gn, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        GP = T.let(:gp, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        GQ = T.let(:gq, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        GR = T.let(:gr, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        GT = T.let(:gt, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        GU = T.let(:gu, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        GW = T.let(:gw, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        GY = T.let(:gy, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        HK = T.let(:hk, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        HN = T.let(:hn, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        HR = T.let(:hr, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        HT = T.let(:ht, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        HU = T.let(:hu, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        ID = T.let(:id, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        IE = T.let(:ie, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        IL = T.let(:il, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        IM = T.let(:im, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        IN = T.let(:in, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        IQ = T.let(:iq, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        IR = T.let(:ir, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        IS = T.let(:is, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        IT = T.let(:it, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        JE = T.let(:je, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        JM = T.let(:jm, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        JO = T.let(:jo, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        JP = T.let(:jp, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        KE = T.let(:ke, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        KG = T.let(:kg, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        KH = T.let(:kh, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        KN = T.let(:kn, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        KR = T.let(:kr, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        KW = T.let(:kw, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        KY = T.let(:ky, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        KZ = T.let(:kz, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        LA = T.let(:la, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        LB = T.let(:lb, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        LC = T.let(:lc, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        LK = T.let(:lk, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        LR = T.let(:lr, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        LS = T.let(:ls, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        LT = T.let(:lt, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        LU = T.let(:lu, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        LV = T.let(:lv, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        LY = T.let(:ly, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        MA = T.let(:ma, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        MC = T.let(:mc, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        MD = T.let(:md, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        ME = T.let(:me, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        MF = T.let(:mf, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        MG = T.let(:mg, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        MK = T.let(:mk, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        ML = T.let(:ml, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        MM = T.let(:mm, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        MN = T.let(:mn, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        MO = T.let(:mo, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        MQ = T.let(:mq, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        MR = T.let(:mr, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        MT = T.let(:mt, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        MU = T.let(:mu, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        MV = T.let(:mv, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        MW = T.let(:mw, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        MX = T.let(:mx, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        MY = T.let(:my, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        MZ = T.let(:mz, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        NA = T.let(:na, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        NC = T.let(:nc, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        NE = T.let(:ne, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        NG = T.let(:ng, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        NI = T.let(:ni, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        NL = T.let(:nl, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        NO = T.let(:no, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        NP = T.let(:np, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        NZ = T.let(:nz, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        OM = T.let(:om, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        PA = T.let(:pa, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        PE = T.let(:pe, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        PF = T.let(:pf, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        PG = T.let(:pg, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        PH = T.let(:ph, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        PK = T.let(:pk, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        PL = T.let(:pl, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        PR = T.let(:pr, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        PS = T.let(:ps, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        PT = T.let(:pt, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        PY = T.let(:py, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        QA = T.let(:qa, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        RE = T.let(:re, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        RO = T.let(:ro, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        RS = T.let(:rs, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        RU = T.let(:ru, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        RW = T.let(:rw, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        SA = T.let(:sa, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        SC = T.let(:sc, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        SD = T.let(:sd, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        SE = T.let(:se, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        SG = T.let(:sg, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        SI = T.let(:si, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        SK = T.let(:sk, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        SL = T.let(:sl, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        SM = T.let(:sm, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        SN = T.let(:sn, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        SO = T.let(:so, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        SR = T.let(:sr, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        SS = T.let(:ss, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        ST = T.let(:st, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        SV = T.let(:sv, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        SX = T.let(:sx, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        SY = T.let(:sy, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        SZ = T.let(:sz, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        TC = T.let(:tc, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        TD = T.let(:td, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        TG = T.let(:tg, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        TH = T.let(:th, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        TJ = T.let(:tj, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        TL = T.let(:tl, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        TM = T.let(:tm, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        TN = T.let(:tn, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        TR = T.let(:tr, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        TT = T.let(:tt, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        TW = T.let(:tw, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        TZ = T.let(:tz, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        UA = T.let(:ua, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        UG = T.let(:ug, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        US = T.let(:us, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        UY = T.let(:uy, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        UZ = T.let(:uz, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        VC = T.let(:vc, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        VE = T.let(:ve, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        VG = T.let(:vg, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        VI = T.let(:vi, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        VN = T.let(:vn, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        YE = T.let(:ye, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        YT = T.let(:yt, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        ZA = T.let(:za, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        ZM = T.let(:zm, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+        ZW = T.let(:zw, ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[ContextDev::WebWebScrapeMdParams::Country::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+
       class Pdf < ContextDev::Internal::Type::BaseModel
         OrHash =
           T.type_alias do

data/rbi/context_dev/resources/web.rbi

@@ -129,6 +129,8 @@ module ContextDev
       # typography, spacing, shadows, and UI components.
       sig do
         params(
+          color_scheme:
+            ContextDev::WebExtractStyleguideParams::ColorScheme::OrSymbol,
           direct_url: String,
           domain: String,
           max_age_ms: Integer,
@@ -137,6 +139,9 @@ module ContextDev
         ).returns(ContextDev::Models::WebExtractStyleguideResponse)
       end
       def extract_styleguide(
+        # Optional browser color scheme to emulate for websites that respond to
+        # prefers-color-scheme. This value is part of the styleguide cache key.
+        color_scheme: nil,
         # A specific URL to fetch the styleguide from directly, bypassing domain
         # resolution (e.g., 'https://example.com/design-system'). When provided, the
         # styleguide is extracted from this exact URL. You must provide either 'domain' or
@@ -162,6 +167,8 @@ module ContextDev
       # Capture a screenshot of a website.
       sig do
         params(
+          color_scheme: ContextDev::WebScreenshotParams::ColorScheme::OrSymbol,
+          country: ContextDev::WebScreenshotParams::Country::OrSymbol,
           direct_url: String,
           domain: String,
           full_screenshot:
@@ -170,6 +177,7 @@ module ContextDev
             ContextDev::WebScreenshotParams::HandleCookiePopup::OrSymbol,
           max_age_ms: Integer,
           page: ContextDev::WebScreenshotParams::Page::OrSymbol,
+          scroll_offset: Integer,
           timeout_ms: Integer,
           viewport: ContextDev::WebScreenshotParams::Viewport::OrHash,
           wait_for_ms: Integer,
@@ -177,6 +185,12 @@ module ContextDev
         ).returns(ContextDev::Models::WebScreenshotResponse)
       end
       def screenshot(
+        # Optional parameter to choose the site's visual theme in the screenshot. Use
+        # 'light' or 'dark' when the site offers both appearances.
+        color_scheme: nil,
+        # 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.
+        country: nil,
         # A specific URL to screenshot directly, bypassing domain resolution (e.g.,
         # 'https://example.com/pricing'). When provided, the screenshot is taken of this
         # exact URL. You must provide either 'domain' or 'directUrl', but not both.
@@ -203,6 +217,13 @@ module ContextDev
         # provided, screenshots the main domain landing page. Only applicable when using
         # 'domain', not 'directUrl'.
         page: nil,
+        # Optional vertical scroll offset in pixels for capturing a long page in
+        # viewport-sized chunks. When provided, the full page is captured once and the
+        # returned image is the viewport-sized slice that begins at this Y offset (e.g.
+        # request scrollOffset=0, then 1080, then 2160 to walk a 1920x1080 landing page
+        # top to bottom). The final slice may be shorter than the viewport height. Takes
+        # precedence over fullScreenshot. Max: 100000.
+        scroll_offset: 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).
@@ -221,19 +242,25 @@ module ContextDev
       sig do
         params(
           query: String,
+          country: ContextDev::WebSearchParams::Country::OrSymbol,
           exclude_domains: T::Array[String],
           freshness: ContextDev::WebSearchParams::Freshness::OrSymbol,
           include_domains: T::Array[String],
           markdown_options:
             ContextDev::WebSearchParams::MarkdownOptions::OrHash,
+          num_results: Integer,
           query_fanout: T::Boolean,
           timeout_ms: Integer,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(ContextDev::Models::WebSearchResponse)
       end
       def search(
-        # 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`.
         query:,
+        # 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".
+        country: nil,
         # Blocklist — drop results from these domains. Example: ["pinterest.com",
         # "reddit.com"].
         exclude_domains: nil,
@@ -244,6 +271,8 @@ module ContextDev
         include_domains: nil,
         # Inline Markdown scraping for each result. Set `enabled: true` to activate.
         markdown_options: nil,
+        # Number of results to request and return (10–100). Defaults to 10.
+        num_results: nil,
         # Expand the query into multiple parallel variants for broader recall.
         query_fanout: nil,
         # Optional timeout in milliseconds for the request. If the request takes longer
@@ -259,6 +288,7 @@ module ContextDev
       sig do
         params(
           url: String,
+          country: ContextDev::WebWebCrawlMdParams::Country::OrSymbol,
           exclude_selectors: T::Array[String],
           follow_subdomains: T::Boolean,
           include_frames: T::Boolean,
@@ -281,6 +311,10 @@ module ContextDev
       def web_crawl_md(
         # The starting URL for the crawl (must include http:// or https:// protocol)
         url:,
+        # 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.
+        country: nil,
         # CSS selectors to remove before each crawled page is converted to Markdown.
         # Applied after includeSelectors. Exclusion takes precedence: an element matching
         # both is removed. Examples: "nav", "footer", ".ad-banner", "[aria-hidden=true]".
@@ -339,6 +373,7 @@ module ContextDev
       sig do
         params(
           url: String,
+          country: ContextDev::WebWebScrapeHTMLParams::Country::OrSymbol,
           exclude_selectors: T::Array[String],
           headers: T::Hash[Symbol, String],
           include_frames: T::Boolean,
@@ -354,6 +389,9 @@ module ContextDev
       def web_scrape_html(
         # Full URL to scrape (must include http:// or https:// protocol)
         url:,
+        # 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.
+        country: nil,
         # CSS selectors to remove from the result. Applied after includeSelectors.
         # Exclusion takes precedence: an element matching both is removed. Examples:
         # "nav", "footer", ".ad-banner", "[aria-hidden=true]".
@@ -432,6 +470,7 @@ module ContextDev
       sig do
         params(
           url: String,
+          country: ContextDev::WebWebScrapeMdParams::Country::OrSymbol,
           exclude_selectors: T::Array[String],
           headers: T::Hash[Symbol, String],
           include_frames: T::Boolean,
@@ -451,6 +490,9 @@ module ContextDev
         # Full URL to scrape into LLM usable Markdown (must include http:// or https://
         # protocol)
         url:,
+        # 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.
+        country: nil,
         # CSS selectors to remove before conversion to Markdown. Applied after
         # includeSelectors. Exclusion takes precedence: an element matching both is
         # removed. Examples: "nav", "footer", ".ad-banner", "[aria-hidden=true]".

data/sig/context_dev/models/web_extract_styleguide_params.rbs

@@ -2,6 +2,7 @@ module ContextDev
   module Models
     type web_extract_styleguide_params =
       {
+        color_scheme: ContextDev::Models::WebExtractStyleguideParams::color_scheme,
         direct_url: String,
         domain: String,
         max_age_ms: Integer,
@@ -13,6 +14,12 @@ module ContextDev
       extend ContextDev::Internal::Type::RequestParameters::Converter
       include ContextDev::Internal::Type::RequestParameters
 
+      attr_reader color_scheme: ContextDev::Models::WebExtractStyleguideParams::color_scheme?
+
+      def color_scheme=: (
+        ContextDev::Models::WebExtractStyleguideParams::color_scheme
+      ) -> ContextDev::Models::WebExtractStyleguideParams::color_scheme
+
       attr_reader direct_url: String?
 
       def direct_url=: (String) -> String
@@ -30,6 +37,7 @@ module ContextDev
       def timeout_ms=: (Integer) -> Integer
 
       def initialize: (
+        ?color_scheme: ContextDev::Models::WebExtractStyleguideParams::color_scheme,
         ?direct_url: String,
         ?domain: String,
         ?max_age_ms: Integer,
@@ -38,12 +46,24 @@ module ContextDev
       ) -> void
 
       def to_hash: -> {
+        color_scheme: ContextDev::Models::WebExtractStyleguideParams::color_scheme,
         direct_url: String,
         domain: String,
         max_age_ms: Integer,
         timeout_ms: Integer,
         request_options: ContextDev::RequestOptions
       }
+
+      type color_scheme = :light | :dark
+
+      module ColorScheme
+        extend ContextDev::Internal::Type::Enum
+
+        LIGHT: :light
+        DARK: :dark
+
+        def self?.values: -> ::Array[ContextDev::Models::WebExtractStyleguideParams::color_scheme]
+      end
     end
   end
 end