context.dev 2.2.0 → 2.4.0

data/lib/context_dev/models/parse_handle_params.rb

@@ -0,0 +1,194 @@
+# frozen_string_literal: true
+
+module ContextDev
+  module Models
+    # @see ContextDev::Resources::Parse#handle
+    class ParseHandleParams < ContextDev::Internal::Type::BaseModel
+      extend ContextDev::Internal::Type::RequestParameters::Converter
+      include ContextDev::Internal::Type::RequestParameters
+
+      # @!attribute body
+      #
+      #   @return [Pathname, StringIO, IO, String, ContextDev::FilePart]
+      required :body, ContextDev::Internal::Type::FileInput
+
+      # @!attribute extension
+      #   Optional file extension hint. Case-insensitive; a leading dot is accepted (e.g.
+      #   ".pdf").
+      #
+      #   @return [Symbol, ContextDev::Models::ParseHandleParams::Extension, nil]
+      optional :extension, enum: -> { ContextDev::ParseHandleParams::Extension }
+
+      # @!attribute include_images
+      #   Include image references in Markdown output
+      #
+      #   @return [Boolean, nil]
+      optional :include_images, ContextDev::Internal::Type::Boolean
+
+      # @!attribute include_links
+      #   Preserve hyperlinks in Markdown output
+      #
+      #   @return [Boolean, nil]
+      optional :include_links, ContextDev::Internal::Type::Boolean
+
+      # @!attribute ocr
+      #   Gates all OCR. When true, PDFs get embedded-image OCR (recognized text inserted
+      #   at each image's position in page reading order, preserving the text layer;
+      #   pdf.start/pdf.end limit the page range), scanned PDFs with no text layer get
+      #   full-document OCR, and raster images get their visible text transcribed. When
+      #   false, no OCR runs: scanned PDFs may yield no content and images return only
+      #   format/dimension metadata. Calls where OCR actually runs cost 5 credits instead
+      #   of 1.
+      #
+      #   @return [Boolean, nil]
+      optional :ocr, ContextDev::Internal::Type::Boolean
+
+      # @!attribute pdf
+      #   PDF page-range controls. Use start/end to limit parsing (and OCR when ocr=true)
+      #   to an inclusive 1-based page range.
+      #
+      #   @return [ContextDev::Models::ParseHandleParams::Pdf, nil]
+      optional :pdf, -> { ContextDev::ParseHandleParams::Pdf }
+
+      # @!attribute shorten_base64_images
+      #   Shorten base64-encoded image data in the Markdown output
+      #
+      #   @return [Boolean, nil]
+      optional :shorten_base64_images, ContextDev::Internal::Type::Boolean
+
+      # @!attribute use_main_content_only
+      #   Extract only the main content from HTML-like inputs
+      #
+      #   @return [Boolean, nil]
+      optional :use_main_content_only, ContextDev::Internal::Type::Boolean
+
+      # @!method initialize(body:, extension: nil, include_images: nil, include_links: nil, ocr: nil, pdf: nil, shorten_base64_images: nil, use_main_content_only: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {ContextDev::Models::ParseHandleParams} for more details.
+      #
+      #   @param body [Pathname, StringIO, IO, String, ContextDev::FilePart]
+      #
+      #   @param extension [Symbol, ContextDev::Models::ParseHandleParams::Extension] Optional file extension hint. Case-insensitive; a leading dot is accepted (e.g.
+      #
+      #   @param include_images [Boolean] Include image references in Markdown output
+      #
+      #   @param include_links [Boolean] Preserve hyperlinks in Markdown output
+      #
+      #   @param ocr [Boolean] Gates all OCR. When true, PDFs get embedded-image OCR (recognized text inserted
+      #
+      #   @param pdf [ContextDev::Models::ParseHandleParams::Pdf] PDF page-range controls. Use start/end to limit parsing (and OCR when ocr=true)
+      #
+      #   @param shorten_base64_images [Boolean] Shorten base64-encoded image data in the Markdown output
+      #
+      #   @param use_main_content_only [Boolean] Extract only the main content from HTML-like inputs
+      #
+      #   @param request_options [ContextDev::RequestOptions, Hash{Symbol=>Object}]
+
+      # Optional file extension hint. Case-insensitive; a leading dot is accepted (e.g.
+      # ".pdf").
+      module Extension
+        extend ContextDev::Internal::Type::Enum
+
+        TXT = :txt
+        TEXT = :text
+        MD = :md
+        MARKDOWN = :markdown
+        HTML = :html
+        HTM = :htm
+        XHTML = :xhtml
+        XML = :xml
+        RSS = :rss
+        ATOM = :atom
+        CSV = :csv
+        TSV = :tsv
+        YAML = :yaml
+        YML = :yml
+        PY = :py
+        JAVA = :java
+        JS = :js
+        JSX = :jsx
+        MJS = :mjs
+        CJS = :cjs
+        JSON = :json
+        JSONL = :jsonl
+        NDJSON = :ndjson
+        PHP = :php
+        SH = :sh
+        BASH = :bash
+        ZSH = :zsh
+        FISH = :fish
+        RB = :rb
+        TS = :ts
+        TSX = :tsx
+        RTF = :rtf
+        SRT = :srt
+        CSS = :css
+        SCSS = :scss
+        LESS = :less
+        STYL = :styl
+        SASS = :sass
+        SVG = :svg
+        PDF = :pdf
+        DOCX = :docx
+        DOC = :doc
+        XLSX = :xlsx
+        XLSM = :xlsm
+        XLSB = :xlsb
+        XLTX = :xltx
+        XLTM = :xltm
+        XLS = :xls
+        PPTX = :pptx
+        PPTM = :pptm
+        PPSX = :ppsx
+        PPSM = :ppsm
+        POTX = :potx
+        POTM = :potm
+        PPT = :ppt
+        PPS = :pps
+        POT = :pot
+        JPG = :jpg
+        JPEG = :jpeg
+        JPE = :jpe
+        PNG = :png
+        GIF = :gif
+        BMP = :bmp
+        TIFF = :tiff
+        TIF = :tif
+        WEBP = :webp
+        PPM = :ppm
+        PBM = :pbm
+        PGM = :pgm
+        PNM = :pnm
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      class Pdf < ContextDev::Internal::Type::BaseModel
+        # @!attribute end_
+        #   Last 1-based PDF page to parse. When omitted, parsing ends at the last page.
+        #   Must be greater than or equal to start when both are provided.
+        #
+        #   @return [Integer, nil]
+        optional :end_, Integer, api_name: :end
+
+        # @!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, start: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {ContextDev::Models::ParseHandleParams::Pdf} for more details.
+        #
+        #   PDF page-range controls. Use start/end to limit parsing (and OCR when ocr=true)
+        #   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 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/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.