context.dev 1.20.1 → 1.21.0

data/sig/context_dev/models/web_search_params.rbs

@@ -0,0 +1,193 @@
+module ContextDev
+  module Models
+    type web_search_params =
+      {
+        query: String,
+        exclude_domains: ::Array[String],
+        freshness: ContextDev::Models::WebSearchParams::freshness,
+        include_domains: ::Array[String],
+        markdown_options: ContextDev::WebSearchParams::MarkdownOptions,
+        query_fanout: bool,
+        timeout_ms: Integer
+      }
+      & ContextDev::Internal::Type::request_parameters
+
+    class WebSearchParams < ContextDev::Internal::Type::BaseModel
+      extend ContextDev::Internal::Type::RequestParameters::Converter
+      include ContextDev::Internal::Type::RequestParameters
+
+      attr_accessor query: String
+
+      attr_reader exclude_domains: ::Array[String]?
+
+      def exclude_domains=: (::Array[String]) -> ::Array[String]
+
+      attr_reader freshness: ContextDev::Models::WebSearchParams::freshness?
+
+      def freshness=: (
+        ContextDev::Models::WebSearchParams::freshness
+      ) -> ContextDev::Models::WebSearchParams::freshness
+
+      attr_reader include_domains: ::Array[String]?
+
+      def include_domains=: (::Array[String]) -> ::Array[String]
+
+      attr_reader markdown_options: ContextDev::WebSearchParams::MarkdownOptions?
+
+      def markdown_options=: (
+        ContextDev::WebSearchParams::MarkdownOptions
+      ) -> ContextDev::WebSearchParams::MarkdownOptions
+
+      attr_reader query_fanout: bool?
+
+      def query_fanout=: (bool) -> bool
+
+      attr_reader timeout_ms: Integer?
+
+      def timeout_ms=: (Integer) -> Integer
+
+      def initialize: (
+        query: String,
+        ?exclude_domains: ::Array[String],
+        ?freshness: ContextDev::Models::WebSearchParams::freshness,
+        ?include_domains: ::Array[String],
+        ?markdown_options: ContextDev::WebSearchParams::MarkdownOptions,
+        ?query_fanout: bool,
+        ?timeout_ms: Integer,
+        ?request_options: ContextDev::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        query: String,
+        exclude_domains: ::Array[String],
+        freshness: ContextDev::Models::WebSearchParams::freshness,
+        include_domains: ::Array[String],
+        markdown_options: ContextDev::WebSearchParams::MarkdownOptions,
+        query_fanout: bool,
+        timeout_ms: Integer,
+        request_options: ContextDev::RequestOptions
+      }
+
+      type freshness = :last_24_hours | :last_week | :last_month | :last_year
+
+      module Freshness
+        extend ContextDev::Internal::Type::Enum
+
+        LAST_24_HOURS: :last_24_hours
+        LAST_WEEK: :last_week
+        LAST_MONTH: :last_month
+        LAST_YEAR: :last_year
+
+        def self?.values: -> ::Array[ContextDev::Models::WebSearchParams::freshness]
+      end
+
+      type markdown_options =
+        {
+          enabled: bool,
+          include_frames: bool,
+          include_images: bool,
+          include_links: bool,
+          max_age_ms: Integer,
+          pdf: ContextDev::WebSearchParams::MarkdownOptions::Pdf,
+          :shorten_base64_images => bool,
+          timeout_ms: Integer,
+          use_main_content_only: bool,
+          wait_for_ms: Integer
+        }
+
+      class MarkdownOptions < ContextDev::Internal::Type::BaseModel
+        attr_reader enabled: bool?
+
+        def enabled=: (bool) -> bool
+
+        attr_reader include_frames: bool?
+
+        def include_frames=: (bool) -> bool
+
+        attr_reader include_images: bool?
+
+        def include_images=: (bool) -> bool
+
+        attr_reader include_links: bool?
+
+        def include_links=: (bool) -> bool
+
+        attr_reader max_age_ms: Integer?
+
+        def max_age_ms=: (Integer) -> Integer
+
+        attr_reader pdf: ContextDev::WebSearchParams::MarkdownOptions::Pdf?
+
+        def pdf=: (
+          ContextDev::WebSearchParams::MarkdownOptions::Pdf
+        ) -> ContextDev::WebSearchParams::MarkdownOptions::Pdf
+
+        attr_reader shorten_base64_images: bool?
+
+        def shorten_base64_images=: (bool) -> bool
+
+        attr_reader timeout_ms: Integer?
+
+        def timeout_ms=: (Integer) -> Integer
+
+        attr_reader use_main_content_only: bool?
+
+        def use_main_content_only=: (bool) -> bool
+
+        attr_reader wait_for_ms: Integer?
+
+        def wait_for_ms=: (Integer) -> Integer
+
+        def initialize: (
+          ?enabled: bool,
+          ?include_frames: bool,
+          ?include_images: bool,
+          ?include_links: bool,
+          ?max_age_ms: Integer,
+          ?pdf: ContextDev::WebSearchParams::MarkdownOptions::Pdf,
+          ?shorten_base64_images: bool,
+          ?timeout_ms: Integer,
+          ?use_main_content_only: bool,
+          ?wait_for_ms: Integer
+        ) -> void
+
+        def to_hash: -> {
+          enabled: bool,
+          include_frames: bool,
+          include_images: bool,
+          include_links: bool,
+          max_age_ms: Integer,
+          pdf: ContextDev::WebSearchParams::MarkdownOptions::Pdf,
+          :shorten_base64_images => bool,
+          timeout_ms: Integer,
+          use_main_content_only: bool,
+          wait_for_ms: Integer
+        }
+
+        type pdf = { end_: Integer, should_parse: bool, start: Integer }
+
+        class Pdf < ContextDev::Internal::Type::BaseModel
+          attr_reader end_: Integer?
+
+          def end_=: (Integer) -> Integer
+
+          attr_reader should_parse: bool?
+
+          def should_parse=: (bool) -> bool
+
+          attr_reader start: Integer?
+
+          def start=: (Integer) -> Integer
+
+          def initialize: (
+            ?end_: Integer,
+            ?should_parse: bool,
+            ?start: Integer
+          ) -> void
+
+          def to_hash: -> { end_: Integer, should_parse: bool, start: Integer }
+        end
+      end
+    end
+  end
+end

data/sig/context_dev/models/web_search_response.rbs

@@ -0,0 +1,115 @@
+module ContextDev
+  module Models
+    type web_search_response =
+      {
+        query: String,
+        results: ::Array[ContextDev::Models::WebSearchResponse::Result]
+      }
+
+    class WebSearchResponse < ContextDev::Internal::Type::BaseModel
+      attr_accessor query: String
+
+      attr_accessor results: ::Array[ContextDev::Models::WebSearchResponse::Result]
+
+      def initialize: (
+        query: String,
+        results: ::Array[ContextDev::Models::WebSearchResponse::Result]
+      ) -> void
+
+      def to_hash: -> {
+        query: String,
+        results: ::Array[ContextDev::Models::WebSearchResponse::Result]
+      }
+
+      type result =
+        {
+          description: String,
+          markdown: ContextDev::Models::WebSearchResponse::Result::Markdown,
+          relevance: ContextDev::Models::WebSearchResponse::Result::relevance,
+          title: String,
+          url: String
+        }
+
+      class Result < ContextDev::Internal::Type::BaseModel
+        attr_accessor description: String
+
+        attr_accessor markdown: ContextDev::Models::WebSearchResponse::Result::Markdown
+
+        attr_accessor relevance: ContextDev::Models::WebSearchResponse::Result::relevance
+
+        attr_accessor title: String
+
+        attr_accessor url: String
+
+        def initialize: (
+          description: String,
+          markdown: ContextDev::Models::WebSearchResponse::Result::Markdown,
+          relevance: ContextDev::Models::WebSearchResponse::Result::relevance,
+          title: String,
+          url: String
+        ) -> void
+
+        def to_hash: -> {
+          description: String,
+          markdown: ContextDev::Models::WebSearchResponse::Result::Markdown,
+          relevance: ContextDev::Models::WebSearchResponse::Result::relevance,
+          title: String,
+          url: String
+        }
+
+        type markdown =
+          {
+            code: ContextDev::Models::WebSearchResponse::Result::Markdown::code,
+            markdown: String?
+          }
+
+        class Markdown < ContextDev::Internal::Type::BaseModel
+          attr_accessor code: ContextDev::Models::WebSearchResponse::Result::Markdown::code
+
+          attr_accessor markdown: String?
+
+          def initialize: (
+            code: ContextDev::Models::WebSearchResponse::Result::Markdown::code,
+            markdown: String?
+          ) -> void
+
+          def to_hash: -> {
+            code: ContextDev::Models::WebSearchResponse::Result::Markdown::code,
+            markdown: String?
+          }
+
+          type code =
+            :SUCCESS
+            | :NOT_REQUESTED
+            | :TIMEOUT
+            | :WEBSITE_ACCESS_ERROR
+            | :ERROR
+
+          module Code
+            extend ContextDev::Internal::Type::Enum
+
+            SUCCESS: :SUCCESS
+            NOT_REQUESTED: :NOT_REQUESTED
+            TIMEOUT: :TIMEOUT
+            WEBSITE_ACCESS_ERROR: :WEBSITE_ACCESS_ERROR
+            ERROR: :ERROR
+
+            def self?.values: -> ::Array[ContextDev::Models::WebSearchResponse::Result::Markdown::code]
+          end
+        end
+
+        type relevance = :high | :medium | :low
+
+        module Relevance
+          extend ContextDev::Internal::Type::Enum
+
+          HIGH: :high
+          MEDIUM: :medium
+          LOW: :low
+
+          def self?.values: -> ::Array[ContextDev::Models::WebSearchResponse::Result::relevance]
+        end
+      end
+    end
+  end
+end

data/sig/context_dev/models.rbs

@@ -33,6 +33,8 @@ module ContextDev
 
   class WebScreenshotParams = ContextDev::Models::WebScreenshotParams
 
+  class WebSearchParams = ContextDev::Models::WebSearchParams
+
   class WebWebCrawlMdParams = ContextDev::Models::WebWebCrawlMdParams
 
   class WebWebScrapeHTMLParams = ContextDev::Models::WebWebScrapeHTMLParams

data/sig/context_dev/resources/web.rbs

@@ -28,6 +28,17 @@ module ContextDev
         ?request_options: ContextDev::request_opts
       ) -> ContextDev::Models::WebScreenshotResponse
 
+      def search: (
+        query: String,
+        ?exclude_domains: ::Array[String],
+        ?freshness: ContextDev::Models::WebSearchParams::freshness,
+        ?include_domains: ::Array[String],
+        ?markdown_options: ContextDev::WebSearchParams::MarkdownOptions,
+        ?query_fanout: bool,
+        ?timeout_ms: Integer,
+        ?request_options: ContextDev::request_opts
+      ) -> ContextDev::Models::WebSearchResponse
+
       def web_crawl_md: (
         url: String,
         ?follow_subdomains: bool,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: context.dev
 version: !ruby/object:Gem::Version
-  version: 1.20.1
+  version: 1.21.0
 platform: ruby
 authors:
 - Context Dev
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-14 00:00:00.000000000 Z
+date: 2026-05-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -103,6 +103,8 @@ files:
 - lib/context_dev/models/web_extract_styleguide_response.rb
 - lib/context_dev/models/web_screenshot_params.rb
 - lib/context_dev/models/web_screenshot_response.rb
+- lib/context_dev/models/web_search_params.rb
+- lib/context_dev/models/web_search_response.rb
 - lib/context_dev/models/web_web_crawl_md_params.rb
 - lib/context_dev/models/web_web_crawl_md_response.rb
 - lib/context_dev/models/web_web_scrape_html_params.rb
@@ -174,6 +176,8 @@ files:
 - rbi/context_dev/models/web_extract_styleguide_response.rbi
 - rbi/context_dev/models/web_screenshot_params.rbi
 - rbi/context_dev/models/web_screenshot_response.rbi
+- rbi/context_dev/models/web_search_params.rbi
+- rbi/context_dev/models/web_search_response.rbi
 - rbi/context_dev/models/web_web_crawl_md_params.rbi
 - rbi/context_dev/models/web_web_crawl_md_response.rbi
 - rbi/context_dev/models/web_web_scrape_html_params.rbi
@@ -244,6 +248,8 @@ files:
 - sig/context_dev/models/web_extract_styleguide_response.rbs
 - sig/context_dev/models/web_screenshot_params.rbs
 - sig/context_dev/models/web_screenshot_response.rbs
+- sig/context_dev/models/web_search_params.rbs
+- sig/context_dev/models/web_search_response.rbs
 - sig/context_dev/models/web_web_crawl_md_params.rbs
 - sig/context_dev/models/web_web_crawl_md_response.rbs
 - sig/context_dev/models/web_web_scrape_html_params.rbs