context.dev 1.17.0 → 1.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e47becb29d02dd213aee4b6b49429685c9d74c35f37d49c026b8bbabc87be191
-  data.tar.gz: 2e76f0c796bf46d9ec0a1f764de47841eabf2cb290c71b279a9740b574393d98
+  metadata.gz: 1f8d1ca708475c531193510f12a13c95d03e0a28c10b5411d6f1de6fc922dcab
+  data.tar.gz: 55b4b7999f774bd387bd3cc03a0c4095b4fb33295a5bb27d3a1ed69968557b14
 SHA512:
-  metadata.gz: 859d0da8ad2c2e9fd7d0bdb4b783b9e8c75f4323d3a599b42d28ad495342ff1187f6a502449b1a325090f3ccab3f76c1d855e25c5aaaee1e7e98d690e9ac44e4
-  data.tar.gz: 5b30272a7da7dbfeb75475e067f86bb404313ee842aa86b973817ccf359dc07c53fe06890b2e2dc34b689da07ec3b12a2b77a1f871eeaa0c549196f1afbc873d
+  metadata.gz: f6b4313f8b005eb2680db0468f0854b1d64bae299a89997ada0e7fb7d82559deca0e59431bd6d5b7c8342362233e2289cfd365d1afbaf2da1961e3481366ebfb
+  data.tar.gz: 20d55c97248661498d7ff43a627d63c97457900625bc53f7fb1a6c35ae28229ad2ece229c26474468330c6a23e4e50f0921307f7c78f3cf3ade343f893bea481

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 1.19.0 (2026-05-11)
+
+Full Changelog: [v1.18.0...v1.19.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.18.0...v1.19.0)
+
+### Features
+
+* **api:** api update ([ab9c393](https://github.com/context-dot-dev/context-ruby-sdk/commit/ab9c3935b669fbe2c7a8ffdd5bff7ea05fc2ae56))
+* **api:** api update ([7f8b7b7](https://github.com/context-dot-dev/context-ruby-sdk/commit/7f8b7b7a720f3fdf5364ffaf7c7e55f171b72c0e))
+
+## 1.18.0 (2026-05-10)
+
+Full Changelog: [v1.17.0...v1.18.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.17.0...v1.18.0)
+
+### Features
+
+* **api:** api update ([b582c05](https://github.com/context-dot-dev/context-ruby-sdk/commit/b582c05376102bb0cb6f8d4d8c9a2cefdef8c1ec))
+* **api:** api update ([4a4e4bb](https://github.com/context-dot-dev/context-ruby-sdk/commit/4a4e4bbc547662de263a307b213dd7eecd03a61d))
+* **api:** manual updates ([ec963bb](https://github.com/context-dot-dev/context-ruby-sdk/commit/ec963bb99ac36d162552c76fb067e87144f21089))
+
 ## 1.17.0 (2026-05-09)
 
 Full Changelog: [v1.16.0...v1.17.0](https://github.com/context-dot-dev/context-ruby-sdk/compare/v1.16.0...v1.17.0)

data/README.md

@@ -8,8 +8,8 @@ It is generated with [Stainless](https://www.stainless.com/).
 
 Use the Context Dev MCP Server to enable AI assistants to interact with this API, allowing them to explore endpoints, make test requests, and use documentation to help integrate this SDK into your application.
 
-[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=context.dev-mcp&config=eyJuYW1lIjoiY29udGV4dC5kZXYtbWNwIiwidHJhbnNwb3J0IjoiaHR0cCIsInVybCI6Imh0dHBzOi8vY29udGV4dC1kZXYuc3RsbWNwLmNvbSIsImhlYWRlcnMiOnsieC1jb250ZXh0LWRldi1hcGkta2V5IjoiTXkgQVBJIEtleSJ9fQ)
-[![Install in VS Code](https://img.shields.io/badge/_-Add_to_VS_Code-blue?style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCA0MCA0MCI+PHBhdGggZmlsbD0iI0VFRSIgZmlsbC1ydWxlPSJldmVub2RkIiBkPSJNMzAuMjM1IDM5Ljg4NGEyLjQ5MSAyLjQ5MSAwIDAgMS0xLjc4MS0uNzNMMTIuNyAyNC43OGwtMy40NiAyLjYyNC0zLjQwNiAyLjU4MmExLjY2NSAxLjY2NSAwIDAgMS0xLjA4Mi4zMzggMS42NjQgMS42NjQgMCAwIDEtMS4wNDYtLjQzMWwtMi4yLTJhMS42NjYgMS42NjYgMCAwIDEgMC0yLjQ2M0w3LjQ1OCAyMCA0LjY3IDE3LjQ1MyAxLjUwNyAxNC41N2ExLjY2NSAxLjY2NSAwIDAgMSAwLTIuNDYzbDIuMi0yYTEuNjY1IDEuNjY1IDAgMCAxIDIuMTMtLjA5N2w2Ljg2MyA1LjIwOUwyOC40NTIuODQ0YTIuNDg4IDIuNDg4IDAgMCAxIDEuODQxLS43MjljLjM1MS4wMDkuNjk5LjA5MSAxLjAxOS4yNDVsOC4yMzYgMy45NjFhMi41IDIuNSAwIDAgMSAxLjQxNSAyLjI1M3YuMDk5LS4wNDVWMzMuMzd2LS4wNDUuMDk1YTIuNTAxIDIuNTAxIDAgMCAxLTEuNDE2IDIuMjU3bC04LjIzNSAzLjk2MWEyLjQ5MiAyLjQ5MiAwIDAgMS0xLjA3Ny4yNDZabS43MTYtMjguOTQ3LTExLjk0OCA5LjA2MiAxMS45NTIgOS4wNjUtLjAwNC0xOC4xMjdaIi8+PC9zdmc+)](https://vscode.stainless.com/mcp/%7B%22name%22%3A%22context.dev-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fcontext-dev.stlmcp.com%22%2C%22headers%22%3A%7B%22x-context-dev-api-key%22%3A%22My%20API%20Key%22%7D%7D)
+[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=context-dev-mcp&config=eyJuYW1lIjoiY29udGV4dC1kZXYtbWNwIiwidHJhbnNwb3J0IjoiaHR0cCIsInVybCI6Imh0dHBzOi8vY29udGV4dC1kZXYuc3RsbWNwLmNvbSIsImhlYWRlcnMiOnsieC1jb250ZXh0LWRldi1hcGkta2V5IjoiTXkgQVBJIEtleSJ9fQ)
+[![Install in VS Code](https://img.shields.io/badge/_-Add_to_VS_Code-blue?style=for-the-badge&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCA0MCA0MCI+PHBhdGggZmlsbD0iI0VFRSIgZmlsbC1ydWxlPSJldmVub2RkIiBkPSJNMzAuMjM1IDM5Ljg4NGEyLjQ5MSAyLjQ5MSAwIDAgMS0xLjc4MS0uNzNMMTIuNyAyNC43OGwtMy40NiAyLjYyNC0zLjQwNiAyLjU4MmExLjY2NSAxLjY2NSAwIDAgMS0xLjA4Mi4zMzggMS42NjQgMS42NjQgMCAwIDEtMS4wNDYtLjQzMWwtMi4yLTJhMS42NjYgMS42NjYgMCAwIDEgMC0yLjQ2M0w3LjQ1OCAyMCA0LjY3IDE3LjQ1MyAxLjUwNyAxNC41N2ExLjY2NSAxLjY2NSAwIDAgMSAwLTIuNDYzbDIuMi0yYTEuNjY1IDEuNjY1IDAgMCAxIDIuMTMtLjA5N2w2Ljg2MyA1LjIwOUwyOC40NTIuODQ0YTIuNDg4IDIuNDg4IDAgMCAxIDEuODQxLS43MjljLjM1MS4wMDkuNjk5LjA5MSAxLjAxOS4yNDVsOC4yMzYgMy45NjFhMi41IDIuNSAwIDAgMSAxLjQxNSAyLjI1M3YuMDk5LS4wNDVWMzMuMzd2LS4wNDUuMDk1YTIuNTAxIDIuNTAxIDAgMCAxLTEuNDE2IDIuMjU3bC04LjIzNSAzLjk2MWEyLjQ5MiAyLjQ5MiAwIDAgMS0xLjA3Ny4yNDZabS43MTYtMjguOTQ3LTExLjk0OCA5LjA2MiAxMS45NTIgOS4wNjUtLjAwNC0xOC4xMjdaIi8+PC9zdmc+)](https://vscode.stainless.com/mcp/%7B%22name%22%3A%22context-dev-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fcontext-dev.stlmcp.com%22%2C%22headers%22%3A%7B%22x-context-dev-api-key%22%3A%22My%20API%20Key%22%7D%7D)
 
 > Note: You may need to set environment variables in your MCP client.
 
@@ -26,7 +26,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "context.dev", "~> 1.17.0"
+gem "context.dev", "~> 1.19.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/context_dev/models/web_screenshot_params.rb

@@ -31,6 +31,14 @@ module ContextDev
       #   @return [Symbol, ContextDev::Models::WebScreenshotParams::FullScreenshot, nil]
       optional :full_screenshot, enum: -> { ContextDev::WebScreenshotParams::FullScreenshot }
 
+      # @!attribute handle_cookie_popup
+      #   Optional parameter to control cookie/consent popup handling. If 'true', we
+      #   dismiss cookie banner before capture. If 'false' or not provided, captures the
+      #   page without that step.
+      #
+      #   @return [Symbol, ContextDev::Models::WebScreenshotParams::HandleCookiePopup, nil]
+      optional :handle_cookie_popup, enum: -> { ContextDev::WebScreenshotParams::HandleCookiePopup }
+
       # @!attribute max_age_ms
       #   Return a cached screenshot if a prior screenshot for the same parameters exists
       #   and is younger than this many milliseconds. Defaults to 1 day (86400000 ms) when
@@ -71,7 +79,7 @@ module ContextDev
       #   @return [Integer, nil]
       optional :wait_for_ms, Integer
 
-      # @!method initialize(direct_url: nil, domain: nil, full_screenshot: nil, max_age_ms: nil, page: nil, timeout_ms: nil, viewport: nil, wait_for_ms: nil, request_options: {})
+      # @!method initialize(direct_url: nil, domain: nil, full_screenshot: nil, handle_cookie_popup: nil, max_age_ms: nil, page: 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.
       #
@@ -81,6 +89,8 @@ module ContextDev
       #
       #   @param full_screenshot [Symbol, ContextDev::Models::WebScreenshotParams::FullScreenshot] Optional parameter to determine screenshot type. If 'true', takes a full page sc
       #
+      #   @param handle_cookie_popup [Symbol, ContextDev::Models::WebScreenshotParams::HandleCookiePopup] Optional parameter to control cookie/consent popup handling. If 'true', we dismi
+      #
       #   @param max_age_ms [Integer] Return a cached screenshot if a prior screenshot for the same parameters exists
       #
       #   @param page [Symbol, ContextDev::Models::WebScreenshotParams::Page] Optional parameter to specify which page type to screenshot. If provided, the sy
@@ -106,6 +116,19 @@ module ContextDev
         #   @return [Array<Symbol>]
       end
 
+      # Optional parameter to control cookie/consent popup handling. If 'true', we
+      # dismiss cookie banner before capture. If 'false' or not provided, captures the
+      # page without that step.
+      module HandleCookiePopup
+        extend ContextDev::Internal::Type::Enum
+
+        TRUE = :true
+        FALSE = :false
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
       # 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

data/lib/context_dev/models/web_web_crawl_md_params.rb

@@ -60,13 +60,12 @@ module ContextDev
       #   @return [Integer, nil]
       optional :max_pages, Integer, api_name: :maxPages
 
-      # @!attribute parse_pdf
-      #   When true (default), PDF pages are fetched and their text layer is extracted and
-      #   converted to Markdown alongside HTML pages. When false, PDF pages are skipped
-      #   entirely (not included in results and not counted as failures).
+      # @!attribute pdf
+      #   PDF parsing controls. Use start/end to limit text extraction and OCR to an
+      #   inclusive 1-based page range.
       #
-      #   @return [Boolean, nil]
-      optional :parse_pdf, ContextDev::Internal::Type::Boolean, api_name: :parsePDF
+      #   @return [ContextDev::Models::WebWebCrawlMdParams::Pdf, nil]
+      optional :pdf, -> { ContextDev::WebWebCrawlMdParams::Pdf }
 
       # @!attribute shorten_base64_images
       #   Truncate base64-encoded image data in the Markdown output
@@ -74,6 +73,15 @@ module ContextDev
       #   @return [Boolean, nil]
       optional :shorten_base64_images, ContextDev::Internal::Type::Boolean, api_name: :shortenBase64Images
 
+      # @!attribute stop_after_ms
+      #   Soft time budget for the crawl in milliseconds. After each scrape, the crawler
+      #   checks the elapsed time and, if exceeded, returns the pages collected so far
+      #   instead of continuing. Min: 10000 (10s). Max: 240000 (4 min). Default: 120000 (2
+      #   min).
+      #
+      #   @return [Integer, nil]
+      optional :stop_after_ms, Integer, api_name: :stopAfterMs
+
       # @!attribute timeout_ms
       #   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
@@ -102,7 +110,7 @@ module ContextDev
       #   @return [Integer, nil]
       optional :wait_for_ms, Integer, api_name: :waitForMs
 
-      # @!method initialize(url:, follow_subdomains: nil, include_frames: nil, include_images: nil, include_links: nil, max_age_ms: nil, max_depth: nil, max_pages: nil, parse_pdf: nil, shorten_base64_images: nil, timeout_ms: nil, url_regex: nil, use_main_content_only: nil, wait_for_ms: nil, request_options: {})
+      # @!method initialize(url:, follow_subdomains: nil, include_frames: nil, include_images: nil, include_links: 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.
       #
@@ -122,10 +130,12 @@ module ContextDev
       #
       #   @param max_pages [Integer] Maximum number of pages to crawl. Hard cap: 500.
       #
-      #   @param parse_pdf [Boolean] When true (default), PDF pages are fetched and their text layer is extracted and
+      #   @param pdf [ContextDev::Models::WebWebCrawlMdParams::Pdf] PDF parsing controls. Use start/end to limit text extraction and OCR to an inclu
       #
       #   @param shorten_base64_images [Boolean] Truncate base64-encoded image data in the Markdown output
       #
+      #   @param stop_after_ms [Integer] Soft time budget for the crawl in milliseconds. After each scrape, the crawler c
+      #
       #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
       #
       #   @param url_regex [String] Regex pattern. Only URLs matching this pattern will be followed and scraped.
@@ -135,6 +145,41 @@ module ContextDev
       #   @param wait_for_ms [Integer] Optional browser wait time in milliseconds after initial page load for each craw
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
+
+      class Pdf < ContextDev::Internal::Type::BaseModel
+        # @!attribute end_
+        #   Last 1-based PDF page to parse. When omitted, parsing ends at the last page.
+        #   Must be greater than or equal to start when both are provided.
+        #
+        #   @return [Integer, nil]
+        optional :end_, Integer, api_name: :end
+
+        # @!attribute should_parse
+        #   When true, PDF pages are fetched and parsed. When false, PDF pages are skipped
+        #   entirely (not included in results and not counted as failures).
+        #
+        #   @return [Boolean, nil]
+        optional :should_parse, ContextDev::Internal::Type::Boolean, api_name: :shouldParse
+
+        # @!attribute start
+        #   First 1-based PDF page to parse. When omitted, parsing starts at the first page.
+        #
+        #   @return [Integer, nil]
+        optional :start, Integer
+
+        # @!method initialize(end_: nil, should_parse: nil, start: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {ContextDev::Models::WebWebCrawlMdParams::Pdf} for more details.
+        #
+        #   PDF parsing controls. Use start/end to limit text extraction and OCR to an
+        #   inclusive 1-based page range.
+        #
+        #   @param end_ [Integer] Last 1-based PDF page to parse. When omitted, parsing ends at the last page. Mus
+        #
+        #   @param should_parse [Boolean] When true, PDF pages are fetched and parsed. When false, PDF pages are skipped e
+        #
+        #   @param start [Integer] First 1-based PDF page to parse. When omitted, parsing starts at the first page.
+      end
     end
   end
 end

data/lib/context_dev/models/web_web_crawl_md_response.rb

@@ -34,7 +34,8 @@ module ContextDev
         required :num_failed, Integer, api_name: :numFailed
 
         # @!attribute num_skipped
-        #   Number of URLs skipped (PDFs when parsePDF=false, or URLs not matching urlRegex)
+        #   Number of URLs skipped (PDFs when pdf.shouldParse=false, or URLs not matching
+        #   urlRegex)
         #
         #   @return [Integer]
         required :num_skipped, Integer, api_name: :numSkipped
@@ -59,7 +60,7 @@ module ContextDev
         #
         #   @param num_failed [Integer] Number of pages that failed to crawl
         #
-        #   @param num_skipped [Integer] Number of URLs skipped (PDFs when parsePDF=false, or URLs not matching urlRegex)
+        #   @param num_skipped [Integer] Number of URLs skipped (PDFs when pdf.shouldParse=false, or URLs not matching ur
         #
         #   @param num_succeeded [Integer] Number of pages successfully crawled
         #

data/lib/context_dev/models/web_web_scrape_html_params.rb

@@ -27,13 +27,12 @@ module ContextDev
       #   @return [Integer, nil]
       optional :max_age_ms, Integer
 
-      # @!attribute parse_pdf
-      #   When true (default), PDF URLs are fetched and their text layer is extracted and
-      #   returned wrapped in <html><pdf>…</pdf></html>. When false, PDF URLs are skipped
-      #   and a 400 WEBSITE_ACCESS_ERROR is returned.
+      # @!attribute pdf
+      #   PDF parsing controls. Use start/end to limit text extraction and OCR to an
+      #   inclusive 1-based page range.
       #
-      #   @return [Boolean, nil]
-      optional :parse_pdf, ContextDev::Internal::Type::Boolean
+      #   @return [ContextDev::Models::WebWebScrapeHTMLParams::Pdf, nil]
+      optional :pdf, -> { ContextDev::WebWebScrapeHTMLParams::Pdf }
 
       # @!attribute timeout_ms
       #   Optional timeout in milliseconds for the request. If the request takes longer
@@ -50,7 +49,7 @@ module ContextDev
       #   @return [Integer, nil]
       optional :wait_for_ms, Integer
 
-      # @!method initialize(url:, include_frames: nil, max_age_ms: nil, parse_pdf: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
+      # @!method initialize(url:, include_frames: nil, max_age_ms: nil, pdf: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebWebScrapeHTMLParams} for more details.
       #
@@ -60,13 +59,48 @@ module ContextDev
       #
       #   @param max_age_ms [Integer] Return a cached result if a prior scrape for the same parameters exists and is y
       #
-      #   @param parse_pdf [Boolean] When true (default), PDF URLs are fetched and their text layer is extracted and
+      #   @param pdf [ContextDev::Models::WebWebScrapeHTMLParams::Pdf] PDF parsing controls. Use start/end to limit text extraction and OCR to an inclu
       #
       #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
       #
       #   @param wait_for_ms [Integer] Optional browser wait time in milliseconds after initial page load. Min: 0. Max:
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
+
+      class Pdf < ContextDev::Internal::Type::BaseModel
+        # @!attribute end_
+        #   Last 1-based PDF page to parse. When omitted, parsing ends at the last page.
+        #   Must be greater than or equal to start when both are provided.
+        #
+        #   @return [Integer, nil]
+        optional :end_, Integer, api_name: :end
+
+        # @!attribute should_parse
+        #   When true, PDF URLs are fetched and parsed. When false, PDF URLs are skipped and
+        #   a 400 WEBSITE_ACCESS_ERROR is returned.
+        #
+        #   @return [Boolean, nil]
+        optional :should_parse, ContextDev::Internal::Type::Boolean, api_name: :shouldParse
+
+        # @!attribute start
+        #   First 1-based PDF page to parse. When omitted, parsing starts at the first page.
+        #
+        #   @return [Integer, nil]
+        optional :start, Integer
+
+        # @!method initialize(end_: nil, should_parse: nil, start: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {ContextDev::Models::WebWebScrapeHTMLParams::Pdf} for more details.
+        #
+        #   PDF parsing controls. Use start/end to limit text extraction and OCR to an
+        #   inclusive 1-based page range.
+        #
+        #   @param end_ [Integer] Last 1-based PDF page to parse. When omitted, parsing ends at the last page. Mus
+        #
+        #   @param should_parse [Boolean] When true, PDF URLs are fetched and parsed. When false, PDF URLs are skipped and
+        #
+        #   @param start [Integer] First 1-based PDF page to parse. When omitted, parsing starts at the first page.
+      end
     end
   end
 end

data/lib/context_dev/models/web_web_scrape_md_params.rb

@@ -40,13 +40,12 @@ module ContextDev
       #   @return [Integer, nil]
       optional :max_age_ms, Integer
 
-      # @!attribute parse_pdf
-      #   When true (default), PDF URLs are fetched and their text layer is extracted and
-      #   converted to Markdown. When false, PDF URLs are skipped and a 400
-      #   WEBSITE_ACCESS_ERROR is returned.
+      # @!attribute pdf
+      #   PDF parsing controls. Use start/end to limit text extraction and OCR to an
+      #   inclusive 1-based page range.
       #
-      #   @return [Boolean, nil]
-      optional :parse_pdf, ContextDev::Internal::Type::Boolean
+      #   @return [ContextDev::Models::WebWebScrapeMdParams::Pdf, nil]
+      optional :pdf, -> { ContextDev::WebWebScrapeMdParams::Pdf }
 
       # @!attribute shorten_base64_images
       #   Shorten base64-encoded image data in the Markdown output
@@ -76,7 +75,7 @@ module ContextDev
       #   @return [Integer, nil]
       optional :wait_for_ms, Integer
 
-      # @!method initialize(url:, include_frames: nil, include_images: nil, include_links: nil, max_age_ms: nil, parse_pdf: nil, shorten_base64_images: nil, timeout_ms: nil, use_main_content_only: nil, wait_for_ms: nil, request_options: {})
+      # @!method initialize(url:, include_frames: nil, include_images: nil, include_links: nil, max_age_ms: nil, pdf: nil, shorten_base64_images: nil, timeout_ms: nil, use_main_content_only: nil, wait_for_ms: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebWebScrapeMdParams} for more details.
       #
@@ -90,7 +89,7 @@ module ContextDev
       #
       #   @param max_age_ms [Integer] Return a cached result if a prior scrape for the same parameters exists and is y
       #
-      #   @param parse_pdf [Boolean] When true (default), PDF URLs are fetched and their text layer is extracted and
+      #   @param pdf [ContextDev::Models::WebWebScrapeMdParams::Pdf] PDF parsing controls. Use start/end to limit text extraction and OCR to an inclu
       #
       #   @param shorten_base64_images [Boolean] Shorten base64-encoded image data in the Markdown output
       #
@@ -101,6 +100,41 @@ module ContextDev
       #   @param wait_for_ms [Integer] Optional browser wait time in milliseconds after initial page load before conver
       #
       #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
+
+      class Pdf < ContextDev::Internal::Type::BaseModel
+        # @!attribute end_
+        #   Last 1-based PDF page to parse. When omitted, parsing ends at the last page.
+        #   Must be greater than or equal to start when both are provided.
+        #
+        #   @return [Integer, nil]
+        optional :end_, Integer, api_name: :end
+
+        # @!attribute should_parse
+        #   When true, PDF URLs are fetched and parsed. When false, PDF URLs are skipped and
+        #   a 400 WEBSITE_ACCESS_ERROR is returned.
+        #
+        #   @return [Boolean, nil]
+        optional :should_parse, ContextDev::Internal::Type::Boolean, api_name: :shouldParse
+
+        # @!attribute start
+        #   First 1-based PDF page to parse. When omitted, parsing starts at the first page.
+        #
+        #   @return [Integer, nil]
+        optional :start, Integer
+
+        # @!method initialize(end_: nil, should_parse: nil, start: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {ContextDev::Models::WebWebScrapeMdParams::Pdf} for more details.
+        #
+        #   PDF parsing controls. Use start/end to limit text extraction and OCR to an
+        #   inclusive 1-based page range.
+        #
+        #   @param end_ [Integer] Last 1-based PDF page to parse. When omitted, parsing ends at the last page. Mus
+        #
+        #   @param should_parse [Boolean] When true, PDF URLs are fetched and parsed. When false, PDF URLs are skipped and
+        #
+        #   @param start [Integer] First 1-based PDF page to parse. When omitted, parsing starts at the first page.
+      end
     end
   end
 end

data/lib/context_dev/resources/web.rb

@@ -70,7 +70,7 @@ module ContextDev
       #
       # Capture a screenshot of a website.
       #
-      # @overload screenshot(direct_url: nil, domain: nil, full_screenshot: nil, max_age_ms: nil, page: nil, timeout_ms: nil, viewport: nil, wait_for_ms: nil, request_options: {})
+      # @overload screenshot(direct_url: nil, domain: nil, full_screenshot: nil, handle_cookie_popup: nil, max_age_ms: nil, page: nil, timeout_ms: nil, viewport: nil, wait_for_ms: nil, request_options: {})
       #
       # @param direct_url [String] A specific URL to screenshot directly, bypassing domain resolution (e.g., 'https
       #
@@ -78,6 +78,8 @@ module ContextDev
       #
       # @param full_screenshot [Symbol, ContextDev::Models::WebScreenshotParams::FullScreenshot] Optional parameter to determine screenshot type. If 'true', takes a full page sc
       #
+      # @param handle_cookie_popup [Symbol, ContextDev::Models::WebScreenshotParams::HandleCookiePopup] Optional parameter to control cookie/consent popup handling. If 'true', we dismi
+      #
       # @param max_age_ms [Integer] Return a cached screenshot if a prior screenshot for the same parameters exists
       #
       # @param page [Symbol, ContextDev::Models::WebScreenshotParams::Page] Optional parameter to specify which page type to screenshot. If provided, the sy
@@ -102,6 +104,7 @@ module ContextDev
           query: query.transform_keys(
             direct_url: "directUrl",
             full_screenshot: "fullScreenshot",
+            handle_cookie_popup: "handleCookiePopup",
             max_age_ms: "maxAgeMs",
             timeout_ms: "timeoutMS",
             wait_for_ms: "waitForMs"
@@ -117,7 +120,7 @@ module ContextDev
       # Performs a crawl starting from a given URL, extracts page content as Markdown,
       # and returns results for all crawled pages.
       #
-      # @overload web_crawl_md(url:, follow_subdomains: nil, include_frames: nil, include_images: nil, include_links: nil, max_age_ms: nil, max_depth: nil, max_pages: nil, parse_pdf: nil, shorten_base64_images: nil, timeout_ms: nil, url_regex: nil, use_main_content_only: nil, wait_for_ms: nil, request_options: {})
+      # @overload web_crawl_md(url:, follow_subdomains: nil, include_frames: nil, include_images: nil, include_links: 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: {})
       #
       # @param url [String] The starting URL for the crawl (must include http:// or https:// protocol)
       #
@@ -135,10 +138,12 @@ module ContextDev
       #
       # @param max_pages [Integer] Maximum number of pages to crawl. Hard cap: 500.
       #
-      # @param parse_pdf [Boolean] When true (default), PDF pages are fetched and their text layer is extracted and
+      # @param pdf [ContextDev::Models::WebWebCrawlMdParams::Pdf] PDF parsing controls. Use start/end to limit text extraction and OCR to an inclu
       #
       # @param shorten_base64_images [Boolean] Truncate base64-encoded image data in the Markdown output
       #
+      # @param stop_after_ms [Integer] Soft time budget for the crawl in milliseconds. After each scrape, the crawler c
+      #
       # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
       #
       # @param url_regex [String] Regex pattern. Only URLs matching this pattern will be followed and scraped.
@@ -168,7 +173,7 @@ module ContextDev
       #
       # Scrapes the given URL and returns the raw HTML content of the page.
       #
-      # @overload web_scrape_html(url:, include_frames: nil, max_age_ms: nil, parse_pdf: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
+      # @overload web_scrape_html(url:, include_frames: nil, max_age_ms: nil, pdf: nil, timeout_ms: nil, wait_for_ms: nil, request_options: {})
       #
       # @param url [String] Full URL to scrape (must include http:// or https:// protocol)
       #
@@ -176,7 +181,7 @@ module ContextDev
       #
       # @param max_age_ms [Integer] Return a cached result if a prior scrape for the same parameters exists and is y
       #
-      # @param parse_pdf [Boolean] When true (default), PDF URLs are fetched and their text layer is extracted and
+      # @param pdf [ContextDev::Models::WebWebScrapeHTMLParams::Pdf] PDF parsing controls. Use start/end to limit text extraction and OCR to an inclu
       #
       # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
       #
@@ -196,7 +201,6 @@ module ContextDev
           query: query.transform_keys(
             include_frames: "includeFrames",
             max_age_ms: "maxAgeMs",
-            parse_pdf: "parsePDF",
             timeout_ms: "timeoutMS",
             wait_for_ms: "waitForMs"
           ),
@@ -251,7 +255,7 @@ module ContextDev
       #
       # Scrapes the given URL into LLM usable Markdown.
       #
-      # @overload web_scrape_md(url:, include_frames: nil, include_images: nil, include_links: nil, max_age_ms: nil, parse_pdf: nil, shorten_base64_images: nil, timeout_ms: nil, use_main_content_only: nil, wait_for_ms: nil, request_options: {})
+      # @overload web_scrape_md(url:, include_frames: nil, include_images: nil, include_links: nil, max_age_ms: nil, pdf: nil, shorten_base64_images: nil, timeout_ms: nil, use_main_content_only: nil, wait_for_ms: nil, request_options: {})
       #
       # @param url [String] Full URL to scrape into LLM usable Markdown (must include http:// or https:// pr
       #
@@ -263,7 +267,7 @@ module ContextDev
       #
       # @param max_age_ms [Integer] Return a cached result if a prior scrape for the same parameters exists and is y
       #
-      # @param parse_pdf [Boolean] When true (default), PDF URLs are fetched and their text layer is extracted and
+      # @param pdf [ContextDev::Models::WebWebScrapeMdParams::Pdf] PDF parsing controls. Use start/end to limit text extraction and OCR to an inclu
       #
       # @param shorten_base64_images [Boolean] Shorten base64-encoded image data in the Markdown output
       #
@@ -289,7 +293,6 @@ module ContextDev
             include_images: "includeImages",
             include_links: "includeLinks",
             max_age_ms: "maxAgeMs",
-            parse_pdf: "parsePDF",
             shorten_base64_images: "shortenBase64Images",
             timeout_ms: "timeoutMS",
             use_main_content_only: "useMainContentOnly",

data/lib/context_dev/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ContextDev
-  VERSION = "1.17.0"
+  VERSION = "1.19.0"
 end

data/rbi/context_dev/models/web_screenshot_params.rbi

@@ -47,6 +47,26 @@ module ContextDev
       end
       attr_writer :full_screenshot
 
+      # Optional parameter to control cookie/consent popup handling. If 'true', we
+      # dismiss cookie banner before capture. If 'false' or not provided, captures the
+      # page without that step.
+      sig do
+        returns(
+          T.nilable(
+            ContextDev::WebScreenshotParams::HandleCookiePopup::OrSymbol
+          )
+        )
+      end
+      attr_reader :handle_cookie_popup
+
+      sig do
+        params(
+          handle_cookie_popup:
+            ContextDev::WebScreenshotParams::HandleCookiePopup::OrSymbol
+        ).void
+      end
+      attr_writer :handle_cookie_popup
+
       # Return a cached screenshot if a prior screenshot for the same parameters exists
       # and is younger than this many milliseconds. Defaults to 1 day (86400000 ms) when
       # omitted. Max is 30 days (2592000000 ms). Set to 0 to always capture fresh.
@@ -102,6 +122,8 @@ module ContextDev
           domain: String,
           full_screenshot:
             ContextDev::WebScreenshotParams::FullScreenshot::OrSymbol,
+          handle_cookie_popup:
+            ContextDev::WebScreenshotParams::HandleCookiePopup::OrSymbol,
           max_age_ms: Integer,
           page: ContextDev::WebScreenshotParams::Page::OrSymbol,
           timeout_ms: Integer,
@@ -123,6 +145,10 @@ module ContextDev
         # screenshot capturing all content. If 'false' or not provided, takes a viewport
         # screenshot (standard browser view).
         full_screenshot: nil,
+        # Optional parameter to control cookie/consent popup handling. If 'true', we
+        # dismiss cookie banner before capture. If 'false' or not provided, captures the
+        # page without that step.
+        handle_cookie_popup: nil,
         # Return a cached screenshot if a prior screenshot for the same parameters exists
         # and is younger than this many milliseconds. Defaults to 1 day (86400000 ms) when
         # omitted. Max is 30 days (2592000000 ms). Set to 0 to always capture fresh.
@@ -154,6 +180,8 @@ module ContextDev
             domain: String,
             full_screenshot:
               ContextDev::WebScreenshotParams::FullScreenshot::OrSymbol,
+            handle_cookie_popup:
+              ContextDev::WebScreenshotParams::HandleCookiePopup::OrSymbol,
             max_age_ms: Integer,
             page: ContextDev::WebScreenshotParams::Page::OrSymbol,
             timeout_ms: Integer,
@@ -200,6 +228,40 @@ module ContextDev
         end
       end
 
+      # Optional parameter to control cookie/consent popup handling. If 'true', we
+      # dismiss cookie banner before capture. If 'false' or not provided, captures the
+      # page without that step.
+      module HandleCookiePopup
+        extend ContextDev::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, ContextDev::WebScreenshotParams::HandleCookiePopup)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        TRUE =
+          T.let(
+            :true,
+            ContextDev::WebScreenshotParams::HandleCookiePopup::TaggedSymbol
+          )
+        FALSE =
+          T.let(
+            :false,
+            ContextDev::WebScreenshotParams::HandleCookiePopup::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              ContextDev::WebScreenshotParams::HandleCookiePopup::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
       # 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