context.dev 2.2.0 → 2.3.0

data/lib/context_dev/models/parse_handle_response.rb

@@ -0,0 +1,132 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Models
+    # @see ContextDev::Resources::Parse#handle
+    class ParseHandleResponse < ContextDev::Internal::Type::BaseModel
+      # @!attribute markdown
+      #   Input bytes converted to GitHub Flavored Markdown
+      #
+      #   @return [String]
+      required :markdown, String
+
+      # @!attribute success
+      #   Indicates success
+      #
+      #   @return [Boolean, ContextDev::Models::ParseHandleResponse::Success]
+      required :success, enum: -> { ContextDev::Models::ParseHandleResponse::Success }
+
+      # @!attribute type
+      #   Detected content type used for parsing
+      #
+      #   @return [Symbol, ContextDev::Models::ParseHandleResponse::Type]
+      required :type, enum: -> { ContextDev::Models::ParseHandleResponse::Type }
+
+      # @!attribute key_metadata
+      #   Metadata about the API key used for the request. Included in every response
+      #   whenever a valid API key is provided, even when the response status is not 200.
+      #
+      #   @return [ContextDev::Models::ParseHandleResponse::KeyMetadata, nil]
+      optional :key_metadata, -> { ContextDev::Models::ParseHandleResponse::KeyMetadata }
+
+      # @!method initialize(markdown:, success:, type:, key_metadata: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::ParseHandleResponse} for more details.
+      #
+      #   @param markdown [String] Input bytes converted to GitHub Flavored Markdown
+      #
+      #   @param success [Boolean, ContextDev::Models::ParseHandleResponse::Success] Indicates success
+      #
+      #   @param type [Symbol, ContextDev::Models::ParseHandleResponse::Type] Detected content type used for parsing
+      #
+      #   @param key_metadata [ContextDev::Models::ParseHandleResponse::KeyMetadata] Metadata about the API key used for the request. Included in every response when
+
+      # Indicates success
+      #
+      # @see ContextDev::Models::ParseHandleResponse#success
+      module Success
+        extend ContextDev::Internal::Type::Enum
+
+        TRUE = true
+
+        # @!method self.values
+        #   @return [Array<Boolean>]
+      end
+
+      # Detected content type used for parsing
+      #
+      # @see ContextDev::Models::ParseHandleResponse#type
+      module Type
+        extend ContextDev::Internal::Type::Enum
+
+        HTML = :html
+        XML = :xml
+        JSON = :json
+        JSONL = :jsonl
+        TEXT = :text
+        CSV = :csv
+        TSV = :tsv
+        MARKDOWN = :markdown
+        YAML = :yaml
+        PYTHON = :python
+        JAVA = :java
+        JAVASCRIPT = :javascript
+        PHP = :php
+        SHELL = :shell
+        RUBY = :ruby
+        TYPESCRIPT = :typescript
+        RTF = :rtf
+        SRT = :srt
+        CSS = :css
+        SCSS = :scss
+        LESS = :less
+        STYLUS = :stylus
+        SASS = :sass
+        SVG = :svg
+        PDF = :pdf
+        DOCX = :docx
+        DOC = :doc
+        XLSX = :xlsx
+        XLS = :xls
+        PPTX = :pptx
+        PPT = :ppt
+        JPG = :jpg
+        PNG = :png
+        GIF = :gif
+        BMP = :bmp
+        TIFF = :tiff
+        WEBP = :webp
+        PPM = :ppm
+        PBM = :pbm
+        PGM = :pgm
+        PNM = :pnm
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # @see ContextDev::Models::ParseHandleResponse#key_metadata
+      class KeyMetadata < ContextDev::Internal::Type::BaseModel
+        # @!attribute credits_consumed
+        #   The number of credits consumed by this request.
+        #
+        #   @return [Integer]
+        required :credits_consumed, Integer
+
+        # @!attribute credits_remaining
+        #   The number of credits remaining for your organization after this request.
+        #
+        #   @return [Integer]
+        required :credits_remaining, Integer
+
+        # @!method initialize(credits_consumed:, credits_remaining:)
+        #   Metadata about the API key used for the request. Included in every response
+        #   whenever a valid API key is provided, even when the response status is not 200.
+        #
+        #   @param credits_consumed [Integer] The number of credits consumed by this request.
+        #
+        #   @param credits_remaining [Integer] The number of credits remaining for your organization after this request.
+      end
+    end
+  end
+end

data/lib/context_dev/models/web_web_crawl_md_params.rb

@@ -86,8 +86,8 @@ module ContextDev
       optional :max_pages, Integer, api_name: :maxPages
 
       # @!attribute pdf
-      #   PDF parsing controls. Use start/end to limit text extraction and OCR to an
-      #   inclusive 1-based page range.
+      #   PDF parsing controls. Use start/end to limit text extraction and embedded-image
+      #   detection/OCR to an inclusive 1-based page range.
       #
       #   @return [ContextDev::Models::WebWebCrawlMdParams::Pdf, nil]
       optional :pdf, -> { ContextDev::WebWebCrawlMdParams::Pdf }
@@ -169,7 +169,7 @@ module ContextDev
       #
       #   @param max_pages [Integer] Maximum number of pages to crawl. Hard cap: 500.
       #
-      #   @param pdf [ContextDev::Models::WebWebCrawlMdParams::Pdf] PDF parsing controls. Use start/end to limit text extraction and OCR to an inclu
+      #   @param pdf [ContextDev::Models::WebWebCrawlMdParams::Pdf] PDF parsing controls. Use start/end to limit text extraction and embedded-image
       #
       #   @param settle_animations [Boolean] When true, waits briefly for CSS and transition animations to settle before extr
       #
@@ -410,6 +410,14 @@ module ContextDev
         #   @return [Integer, nil]
         optional :end_, Integer, api_name: :end
 
+        # @!attribute ocr
+        #   When true, detect and OCR images embedded in the selected PDF pages, inserting
+        #   recognized text at each image's position in page reading order while preserving
+        #   the PDF text layer. This is separate from automatic scanned-PDF OCR fallback.
+        #
+        #   @return [Boolean, nil]
+        optional :ocr, ContextDev::Internal::Type::Boolean
+
         # @!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).
@@ -423,15 +431,17 @@ module ContextDev
         #   @return [Integer, nil]
         optional :start, Integer
 
-        # @!method initialize(end_: nil, should_parse: nil, start: nil)
+        # @!method initialize(end_: nil, ocr: 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.
+        #   PDF parsing controls. Use start/end to limit text extraction and embedded-image
+        #   detection/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 ocr [Boolean] When true, detect and OCR images embedded in the selected PDF pages, inserting r
+        #
         #   @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.

data/lib/context_dev/models/web_web_scrape_html_params.rb

@@ -59,8 +59,8 @@ module ContextDev
       optional :max_age_ms, Integer
 
       # @!attribute pdf
-      #   PDF parsing controls. Use start/end to limit text extraction and OCR to an
-      #   inclusive 1-based page range.
+      #   PDF parsing controls. Use start/end to limit text extraction and embedded-image
+      #   detection/OCR to an inclusive 1-based page range.
       #
       #   @return [ContextDev::Models::WebWebScrapeHTMLParams::Pdf, nil]
       optional :pdf, -> { ContextDev::WebWebScrapeHTMLParams::Pdf }
@@ -113,7 +113,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 pdf [ContextDev::Models::WebWebScrapeHTMLParams::Pdf] PDF parsing controls. Use start/end to limit text extraction and OCR to an inclu
+      #   @param pdf [ContextDev::Models::WebWebScrapeHTMLParams::Pdf] PDF parsing controls. Use start/end to limit text extraction and embedded-image
       #
       #   @param settle_animations [Boolean] When true, waits briefly for CSS and transition animations to settle before extr
       #
@@ -347,6 +347,14 @@ module ContextDev
         #   @return [Integer, nil]
         optional :end_, Integer, api_name: :end
 
+        # @!attribute ocr
+        #   When true, detect and OCR images embedded in the selected PDF pages, inserting
+        #   recognized text at each image's position in page reading order while preserving
+        #   the PDF text layer. This is separate from automatic scanned-PDF OCR fallback.
+        #
+        #   @return [Boolean, nil]
+        optional :ocr, ContextDev::Internal::Type::Boolean
+
         # @!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.
@@ -360,15 +368,17 @@ module ContextDev
         #   @return [Integer, nil]
         optional :start, Integer
 
-        # @!method initialize(end_: nil, should_parse: nil, start: nil)
+        # @!method initialize(end_: nil, ocr: 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.
+        #   PDF parsing controls. Use start/end to limit text extraction and embedded-image
+        #   detection/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 ocr [Boolean] When true, detect and OCR images embedded in the selected PDF pages, inserting r
+        #
         #   @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.

data/lib/context_dev/models/web_web_scrape_md_params.rb

@@ -72,8 +72,8 @@ module ContextDev
       optional :max_age_ms, Integer
 
       # @!attribute pdf
-      #   PDF parsing controls. Use start/end to limit text extraction and OCR to an
-      #   inclusive 1-based page range.
+      #   PDF parsing controls. Use start/end to limit text extraction and embedded-image
+      #   detection/OCR to an inclusive 1-based page range.
       #
       #   @return [ContextDev::Models::WebWebScrapeMdParams::Pdf, nil]
       optional :pdf, -> { ContextDev::WebWebScrapeMdParams::Pdf }
@@ -136,7 +136,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 pdf [ContextDev::Models::WebWebScrapeMdParams::Pdf] PDF parsing controls. Use start/end to limit text extraction and OCR to an inclu
+      #   @param pdf [ContextDev::Models::WebWebScrapeMdParams::Pdf] PDF parsing controls. Use start/end to limit text extraction and embedded-image
       #
       #   @param settle_animations [Boolean] When true, waits briefly for CSS and transition animations to settle before conv
       #
@@ -372,6 +372,14 @@ module ContextDev
         #   @return [Integer, nil]
         optional :end_, Integer, api_name: :end
 
+        # @!attribute ocr
+        #   When true, detect and OCR images embedded in the selected PDF pages, inserting
+        #   recognized text at each image's position in page reading order while preserving
+        #   the PDF text layer. This is separate from automatic scanned-PDF OCR fallback.
+        #
+        #   @return [Boolean, nil]
+        optional :ocr, ContextDev::Internal::Type::Boolean
+
         # @!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.
@@ -385,15 +393,17 @@ module ContextDev
         #   @return [Integer, nil]
         optional :start, Integer
 
-        # @!method initialize(end_: nil, should_parse: nil, start: nil)
+        # @!method initialize(end_: nil, ocr: 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.
+        #   PDF parsing controls. Use start/end to limit text extraction and embedded-image
+        #   detection/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 ocr [Boolean] When true, detect and OCR images embedded in the selected PDF pages, inserting r
+        #
         #   @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.

data/lib/context_dev/models/web_web_scrape_md_response.rb

@@ -4,6 +4,14 @@ module ContextDev
   module Models
     # @see ContextDev::Resources::Web#web_scrape_md
     class WebWebScrapeMdResponse < ContextDev::Internal::Type::BaseModel
+      # @!attribute content_length
+      #   UTF-8 byte length of the returned Markdown. Use 0 to identify an empty result
+      #   and compare small values against your workload's minimum useful-content
+      #   threshold.
+      #
+      #   @return [Integer]
+      required :content_length, Integer, api_name: :contentLength
+
       # @!attribute markdown
       #   Page content converted to GitHub Flavored Markdown
       #
@@ -35,10 +43,12 @@ module ContextDev
       #   @return [ContextDev::Models::WebWebScrapeMdResponse::KeyMetadata, nil]
       optional :key_metadata, -> { ContextDev::Models::WebWebScrapeMdResponse::KeyMetadata }
 
-      # @!method initialize(markdown:, metadata:, success:, url:, key_metadata: nil)
+      # @!method initialize(content_length:, markdown:, metadata:, success:, url:, key_metadata: nil)
       #   Some parameter documentations has been truncated, see
       #   {ContextDev::Models::WebWebScrapeMdResponse} for more details.
       #
+      #   @param content_length [Integer] UTF-8 byte length of the returned Markdown. Use 0 to identify an empty result an
+      #
       #   @param markdown [String] Page content converted to GitHub Flavored Markdown
       #
       #   @param metadata [ContextDev::Models::WebWebScrapeMdResponse::Metadata] Metadata extracted from the scraped page HTML.

data/lib/context_dev/models/webhook_delivery.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Models
+    class WebhookDelivery < ContextDev::Internal::Type::BaseModel
+      # @!attribute attempted_at
+      #
+      #   @return [Time]
+      required :attempted_at, Time
+
+      # @!attribute error
+      #
+      #   @return [ContextDev::Models::WebhookDelivery::Error, nil]
+      required :error, -> { ContextDev::WebhookDelivery::Error }, nil?: true
+
+      # @!attribute event
+      #   The event this delivery carried. Deliveries recorded before event selection
+      #   existed report change.detected.
+      #
+      #   @return [Symbol, ContextDev::Models::WebhookDelivery::Event]
+      required :event, enum: -> { ContextDev::WebhookDelivery::Event }
+
+      # @!attribute event_id
+      #   Identifier sent in the X-Context-Id header.
+      #
+      #   @return [String]
+      required :event_id, String
+
+      # @!attribute http_status
+      #   The endpoint's final HTTP response status, or null when no response was
+      #   received.
+      #
+      #   @return [Integer, nil]
+      required :http_status, Integer, nil?: true
+
+      # @!attribute status
+      #   Delivery outcome. delivered means any 2xx response; rejected means a non-2xx
+      #   response; failed means no HTTP response was received; skipped_unsafe_url means
+      #   the URL failed the public-endpoint safety check.
+      #
+      #   @return [Symbol, ContextDev::Models::WebhookDelivery::Status]
+      required :status, enum: -> { ContextDev::WebhookDelivery::Status }
+
+      # @!method initialize(attempted_at:, error:, event:, event_id:, http_status:, status:)
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::WebhookDelivery} for more details.
+      #
+      #   @param attempted_at [Time]
+      #
+      #   @param error [ContextDev::Models::WebhookDelivery::Error, nil]
+      #
+      #   @param event [Symbol, ContextDev::Models::WebhookDelivery::Event] The event this delivery carried. Deliveries recorded before event selection exis
+      #
+      #   @param event_id [String] Identifier sent in the X-Context-Id header.
+      #
+      #   @param http_status [Integer, nil] The endpoint's final HTTP response status, or null when no response was received
+      #
+      #   @param status [Symbol, ContextDev::Models::WebhookDelivery::Status] Delivery outcome. delivered means any 2xx response; rejected means a non-2xx res
+
+      # @see ContextDev::Models::WebhookDelivery#error
+      class Error < ContextDev::Internal::Type::BaseModel
+        # @!attribute code
+        #
+        #   @return [String]
+        required :code, String
+
+        # @!attribute message
+        #
+        #   @return [String]
+        required :message, String
+
+        # @!method initialize(code:, message:)
+        #   @param code [String]
+        #   @param message [String]
+      end
+
+      # The event this delivery carried. Deliveries recorded before event selection
+      # existed report change.detected.
+      #
+      # @see ContextDev::Models::WebhookDelivery#event
+      module Event
+        extend ContextDev::Internal::Type::Enum
+
+        CHANGE_DETECTED = :"change.detected"
+        RUN_COMPLETED = :"run.completed"
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Delivery outcome. delivered means any 2xx response; rejected means a non-2xx
+      # response; failed means no HTTP response was received; skipped_unsafe_url means
+      # the URL failed the public-endpoint safety check.
+      #
+      # @see ContextDev::Models::WebhookDelivery#status
+      module Status
+        extend ContextDev::Internal::Type::Enum
+
+        DELIVERED = :delivered
+        REJECTED = :rejected
+        FAILED = :failed
+        SKIPPED_UNSAFE_URL = :skipped_unsafe_url
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/context_dev/models.rb

@@ -73,6 +73,8 @@ module ContextDev
 
   MonitorUpdateParams = ContextDev::Models::MonitorUpdateParams
 
+  ParseHandleParams = ContextDev::Models::ParseHandleParams
+
   UtilityPrefetchParams = ContextDev::Models::UtilityPrefetchParams
 
   WebExtractCompetitorsParams = ContextDev::Models::WebExtractCompetitorsParams
@@ -83,6 +85,8 @@ module ContextDev
 
   WebExtractStyleguideParams = ContextDev::Models::WebExtractStyleguideParams
 
+  WebhookDelivery = ContextDev::Models::WebhookDelivery
+
   WebScreenshotParams = ContextDev::Models::WebScreenshotParams
 
   WebSearchParams = ContextDev::Models::WebSearchParams

data/lib/context_dev/resources/monitors.rb

@@ -3,8 +3,9 @@
 module ContextDev
   module Resources
     # Monitor pages, sitemaps, and extracted website data for exact or semantic
-    # changes. The change.detected webhook payload is documented by the
-    # MonitorsChangeDetectedWebhookPayload schema.
+    # changes. Webhook payloads are documented by the
+    # MonitorsChangeDetectedWebhookPayload and MonitorsRunCompletedWebhookPayload
+    # schemas.
     class Monitors
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::MonitorCreateParams} for more details.

data/lib/context_dev/resources/parse.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Resources
+    class Parse
+      # Some parameter documentations has been truncated, see
+      # {ContextDev::Models::ParseHandleParams} for more details.
+      #
+      # Converts raw text, source code, web/data, PDF, Microsoft Office, and image bytes
+      # into LLM-usable Markdown.
+      #
+      # @overload handle(body:, base_url: nil, extension: nil, filename: nil, include_images: nil, include_links: nil, ocr: nil, pdf_end: nil, pdf_start: nil, shorten_base64_images: nil, use_main_content_only: nil, request_options: {})
+      #
+      # @param body [Pathname, StringIO, IO, String, ContextDev::FilePart] Body param
+      #
+      # @param base_url [String] Query param: Optional HTTP(S) source document URL used to resolve relative links
+      #
+      # @param extension [String] Query param: Optional file extension hint, such as pdf, docx, xlsx, pptx, html,
+      #
+      # @param filename [String] Query param: Optional filename hint used to infer the extension when extension i
+      #
+      # @param include_images [Boolean] Query param: Include image references in Markdown output
+      #
+      # @param include_links [Boolean] Query param: Preserve hyperlinks in Markdown output
+      #
+      # @param ocr [Boolean] Query param: When true for PDF inputs, detect and OCR images embedded in the sel
+      #
+      # @param pdf_end [Integer] Query param: Last 1-based PDF page to parse. When omitted, parsing ends at the l
+      #
+      # @param pdf_start [Integer] Query param: First 1-based PDF page to parse. When omitted, parsing starts at th
+      #
+      # @param shorten_base64_images [Boolean] Query param: Shorten base64-encoded image data in the Markdown output
+      #
+      # @param use_main_content_only [Boolean] Query param: Extract only the main content from HTML-like inputs
+      #
+      # @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [ContextDev::Models::ParseHandleResponse]
+      #
+      # @see ContextDev::Models::ParseHandleParams
+      def handle(params)
+        parsed, options = ContextDev::ParseHandleParams.dump_request(params)
+        query = ContextDev::Internal::Util.encode_query_params(parsed.except(:body))
+        @client.request(
+          method: :post,
+          path: "parse",
+          query: query,
+          headers: {"content-type" => "application/octet-stream"},
+          body: parsed[:body],
+          model: ContextDev::Models::ParseHandleResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [ContextDev::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/context_dev/resources/web.rb

@@ -289,7 +289,7 @@ module ContextDev
       #
       # @param max_pages [Integer] Maximum number of pages to crawl. Hard cap: 500.
       #
-      # @param pdf [ContextDev::Models::WebWebCrawlMdParams::Pdf] PDF parsing controls. Use start/end to limit text extraction and OCR to an inclu
+      # @param pdf [ContextDev::Models::WebWebCrawlMdParams::Pdf] PDF parsing controls. Use start/end to limit text extraction and embedded-image
       #
       # @param settle_animations [Boolean] When true, waits briefly for CSS and transition animations to settle before extr
       #
@@ -342,7 +342,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 pdf [ContextDev::Models::WebWebScrapeHTMLParams::Pdf] PDF parsing controls. Use start/end to limit text extraction and OCR to an inclu
+      # @param pdf [ContextDev::Models::WebWebScrapeHTMLParams::Pdf] PDF parsing controls. Use start/end to limit text extraction and embedded-image
       #
       # @param settle_animations [Boolean] When true, waits briefly for CSS and transition animations to settle before extr
       #
@@ -426,7 +426,22 @@ module ContextDev
       # Some parameter documentations has been truncated, see
       # {ContextDev::Models::WebWebScrapeMdParams} for more details.
       #
-      # Scrapes the given URL into LLM usable Markdown.
+      # Scrapes the given URL into LLM usable Markdown. Inspect key_metadata on JSON
+      # responses from a recognized API key; use error_code to distinguish stable
+      # failure categories.
+      #
+      # ### Billing & errors
+      #
+      # | HTTP status | Billed?        | Meaning                                                                                  |
+      # | ----------- | -------------- | ---------------------------------------------------------------------------------------- |
+      # | 200         | Yes — 1 credit | Successful scrape, including a zero-length result when includeSelectors matched nothing  |
+      # | 400         | No             | Invalid input, skipped PDF, or the page could not be scraped                             |
+      # | 401 / 403   | No             | Invalid/disabled key, insufficient permissions, or credits exhausted; inspect error_code |
+      # | 404         | No             | Target page returned or fingerprinted as not found                                       |
+      # | 408         | No             | Request timed out                                                                        |
+      # | 415         | No             | Unsupported content type                                                                 |
+      # | 429         | No             | Per-minute rate limit exceeded; honor Retry-After                                        |
+      # | 500         | No             | Internal error                                                                           |
       #
       # @overload web_scrape_md(url:, country: nil, exclude_selectors: nil, headers: nil, include_frames: nil, include_images: nil, include_links: nil, include_selectors: nil, max_age_ms: nil, pdf: nil, settle_animations: nil, shorten_base64_images: nil, timeout_ms: nil, use_main_content_only: nil, wait_for_ms: nil, request_options: {})
       #
@@ -448,7 +463,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 pdf [ContextDev::Models::WebWebScrapeMdParams::Pdf] PDF parsing controls. Use start/end to limit text extraction and OCR to an inclu
+      # @param pdf [ContextDev::Models::WebWebScrapeMdParams::Pdf] PDF parsing controls. Use start/end to limit text extraction and embedded-image
       #
       # @param settle_animations [Boolean] When true, waits briefly for CSS and transition animations to settle before conv
       #

data/lib/context_dev/version.rb

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

data/lib/context_dev.rb

@@ -86,6 +86,8 @@ require_relative "context_dev/models/monitor_run_params"
 require_relative "context_dev/models/monitor_run_response"
 require_relative "context_dev/models/monitor_update_params"
 require_relative "context_dev/models/monitor_update_response"
+require_relative "context_dev/models/parse_handle_params"
+require_relative "context_dev/models/parse_handle_response"
 require_relative "context_dev/models/utility_prefetch_params"
 require_relative "context_dev/models/utility_prefetch_response"
 require_relative "context_dev/models/web_extract_competitors_params"
@@ -96,6 +98,7 @@ require_relative "context_dev/models/web_extract_params"
 require_relative "context_dev/models/web_extract_response"
 require_relative "context_dev/models/web_extract_styleguide_params"
 require_relative "context_dev/models/web_extract_styleguide_response"
+require_relative "context_dev/models/webhook_delivery"
 require_relative "context_dev/models/web_screenshot_params"
 require_relative "context_dev/models/web_screenshot_response"
 require_relative "context_dev/models/web_search_params"
@@ -115,5 +118,6 @@ require_relative "context_dev/resources/ai"
 require_relative "context_dev/resources/brand"
 require_relative "context_dev/resources/industry"
 require_relative "context_dev/resources/monitors"
+require_relative "context_dev/resources/parse"
 require_relative "context_dev/resources/utility"
 require_relative "context_dev/resources/web"

data/rbi/context_dev/client.rbi

@@ -13,6 +13,9 @@ module ContextDev
     sig { returns(String) }
     attr_reader :api_key
 
+    sig { returns(ContextDev::Resources::Parse) }
+    attr_reader :parse
+
     sig { returns(ContextDev::Resources::Web) }
     attr_reader :web
 
@@ -29,8 +32,9 @@ module ContextDev
     attr_reader :utility
 
     # Monitor pages, sitemaps, and extracted website data for exact or semantic
-    # changes. The change.detected webhook payload is documented by the
-    # MonitorsChangeDetectedWebhookPayload schema.
+    # changes. Webhook payloads are documented by the
+    # MonitorsChangeDetectedWebhookPayload and MonitorsRunCompletedWebhookPayload
+    # schemas.
     sig { returns(ContextDev::Resources::Monitors) }
     attr_reader :monitors