context.dev 2.4.0 → 2.6.0

data/rbi/context_dev/resources/monitors.rbi

@@ -12,39 +12,40 @@ module ContextDev
       # its initial baseline.
       sig do
         params(
-          change_detection:
-            T.any(
-              ContextDev::MonitorCreateParams::ChangeDetection::Exact::OrHash,
-              ContextDev::MonitorCreateParams::ChangeDetection::Semantic::OrHash
-            ),
           name: String,
-          schedule: ContextDev::MonitorCreateParams::Schedule::OrHash,
           target:
             T.any(
               ContextDev::MonitorCreateParams::Target::Page::OrHash,
               ContextDev::MonitorCreateParams::Target::Sitemap::OrHash,
               ContextDev::MonitorCreateParams::Target::Extract::OrHash
             ),
+          change_detection:
+            T.any(
+              ContextDev::MonitorCreateParams::ChangeDetection::Exact::OrHash,
+              ContextDev::MonitorCreateParams::ChangeDetection::Semantic::OrHash
+            ),
           mode: ContextDev::MonitorCreateParams::Mode::OrSymbol,
+          schedule: ContextDev::MonitorCreateParams::Schedule::OrHash,
           tags: T::Array[String],
           webhook: T.nilable(ContextDev::MonitorCreateParams::Webhook::OrHash),
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(ContextDev::Models::MonitorCreateResponse)
       end
       def create(
-        # Discriminated union describing how changes are detected.
-        change_detection:,
         name:,
-        # Run the monitor on a fixed interval defined by a frequency and a unit, e.g.
-        # every 6 hours or every 2 days. The total interval (frequency × unit) must be
-        # between 10 minutes and 1 year.
-        schedule:,
         # Discriminated union describing what the monitor watches.
         target:,
+        # Discriminated union describing how changes are detected.
+        change_detection: nil,
         # Top-level monitor category. Always `web` today; the concrete behavior is
         # described by `target` and `change_detection`.
         mode: nil,
+        # Run the monitor on a fixed interval defined by a frequency and a unit, e.g.
+        # every 6 hours or every 2 days. The total interval (frequency × unit) must be
+        # between 10 minutes and 1 year.
+        schedule: nil,
         # User-defined tags for grouping and filtering monitors and their changes.
+        # Duplicates are removed.
         tags: nil,
         webhook: nil,
         request_options: {}
@@ -97,6 +98,7 @@ module ContextDev
         schedule: nil,
         status: nil,
         # User-defined tags for grouping and filtering monitors and their changes.
+        # Duplicates are removed.
         tags: nil,
         # Discriminated union describing what the monitor watches.
         target: nil,
@@ -117,18 +119,23 @@ module ContextDev
           limit: Integer,
           q: String,
           search_by:
-            T::Array[ContextDev::MonitorListParams::SearchBy::OrSymbol],
+            T.nilable(
+              T::Array[ContextDev::MonitorListParams::SearchBy::OrSymbol]
+            ),
           search_type: ContextDev::MonitorListParams::SearchType::OrSymbol,
           status: ContextDev::MonitorListParams::Status::OrSymbol,
           tag: String,
-          tags: T::Array[String],
+          tags: T.nilable(T::Array[String]),
           target_type: ContextDev::MonitorListParams::TargetType::OrSymbol,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(ContextDev::Models::MonitorListResponse)
       end
       def list(
+        # Filter by change detection type.
         change_detection_type: nil,
+        # Opaque pagination cursor from a previous response.
         cursor: nil,
+        # Maximum number of items to return per page (1-100). Defaults to 25.
         limit: nil,
         # Free-text search term, matched against the fields named in `search_by`.
         q: nil,
@@ -138,16 +145,13 @@ module ContextDev
         # `prefix` for as-you-type prefix matching (default), `exact` for full-token
         # matching.
         search_type: nil,
-        # Monitor lifecycle status. `failed` means the most recent run failed (see the
-        # monitor's `last_error`); failed monitors keep running on schedule and flip back
-        # to `active` on the next successful run. Monitors are auto-`paused` after
-        # repeated consecutive failures or insufficient-credit skips; resume by PATCHing
-        # status to `active`.
+        # Filter monitors by lifecycle status.
         status: nil,
         # Filter to items that have this tag.
         tag: nil,
         # Comma-separated list of tags to filter by (matches monitors having any of them).
         tags: nil,
+        # Filter by target type.
         target_type: nil,
         request_options: {}
       )
@@ -163,6 +167,33 @@ module ContextDev
       def delete(monitor_id, request_options: {})
       end
 
+      # Returns credits charged per monitor over an optional [since, until] window,
+      # newest spenders first.
+      sig do
+        params(
+          since: Time,
+          until_: Time,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(ContextDev::Models::MonitorGetCreditUsageResponse)
+      end
+      def get_credit_usage(
+        # Only include items at or after this ISO 8601 timestamp.
+        since: nil,
+        # Only include items before this ISO 8601 timestamp.
+        until_: nil,
+        request_options: {}
+      )
+      end
+
+      # Returns how many monitors the account has and the maximum it allows.
+      sig do
+        params(request_options: ContextDev::RequestOptions::OrHash).returns(
+          ContextDev::Models::MonitorGetLimitsResponse
+        )
+      end
+      def get_limits(request_options: {})
+      end
+
       # Returns an account-wide feed of detected changes across monitors.
       sig do
         params(
@@ -180,14 +211,21 @@ module ContextDev
         ).returns(ContextDev::Models::MonitorListAccountChangesResponse)
       end
       def list_account_changes(
+        # Filter by change detection type.
         change_detection_type: nil,
+        # Opaque pagination cursor from a previous response.
         cursor: nil,
+        # Maximum number of items to return per page (1-100). Defaults to 25.
         limit: nil,
+        # Filter changes to a single monitor.
         monitor_id: nil,
+        # Only include items at or after this ISO 8601 timestamp.
         since: nil,
         # Filter to items that have this tag.
         tag: nil,
+        # Filter by target type.
         target_type: nil,
+        # Only include items before this ISO 8601 timestamp.
         until_: nil,
         request_options: {}
       )
@@ -203,10 +241,11 @@ module ContextDev
         ).returns(ContextDev::Models::MonitorListAccountRunsResponse)
       end
       def list_account_runs(
+        # Opaque pagination cursor from a previous response.
         cursor: nil,
+        # Maximum number of items to return per page (1-100). Defaults to 25.
         limit: nil,
-        # Lifecycle status of a run. `skipped` runs never executed — see `skip_reason`
-        # (insufficient credits, monitor paused, or superseded by a concurrent run).
+        # Filter runs by lifecycle status.
         status: nil,
         request_options: {}
       )
@@ -226,11 +265,15 @@ module ContextDev
       end
       def list_changes(
         monitor_id,
+        # Opaque pagination cursor from a previous response.
         cursor: nil,
+        # Maximum number of items to return per page (1-100). Defaults to 25.
         limit: nil,
+        # Only include items at or after this ISO 8601 timestamp.
         since: nil,
         # Filter to items that have this tag.
         tag: nil,
+        # Only include items before this ISO 8601 timestamp.
         until_: nil,
         request_options: {}
       )
@@ -248,10 +291,11 @@ module ContextDev
       end
       def list_runs(
         monitor_id,
+        # Opaque pagination cursor from a previous response.
         cursor: nil,
+        # Maximum number of items to return per page (1-100). Defaults to 25.
         limit: nil,
-        # Lifecycle status of a run. `skipped` runs never executed — see `skip_reason`
-        # (insufficient credits, monitor paused, or superseded by a concurrent run).
+        # Filter runs by lifecycle status.
         status: nil,
         request_options: {}
       )

data/rbi/context_dev/resources/parse.rbi

@@ -4,47 +4,74 @@ module ContextDev
   module Resources
     class Parse
       # Converts raw text, source code, web/data, PDF, Microsoft Office, and image bytes
-      # into LLM-usable Markdown. The base request costs 1 credit. When OCR runs
-      # (requires ocr=true), the entire call costs 5 credits; ocr=true requests where no
-      # OCR ends up running still cost 1 credit.
+      # into LLM-usable Markdown.
       sig do
         params(
           body: ContextDev::Internal::FileInput,
+          client: String,
           extension: ContextDev::ParseHandleParams::Extension::OrSymbol,
-          include_images: T::Boolean,
-          include_links: T::Boolean,
-          ocr: T::Boolean,
+          include_images:
+            T.any(
+              T::Boolean,
+              ContextDev::ParseHandleParams::IncludeImages::OrSymbol
+            ),
+          include_links:
+            T.any(
+              T::Boolean,
+              ContextDev::ParseHandleParams::IncludeLinks::OrSymbol
+            ),
+          ocr: T.any(T::Boolean, ContextDev::ParseHandleParams::Ocr::OrSymbol),
           pdf: ContextDev::ParseHandleParams::Pdf::OrHash,
-          shorten_base64_images: T::Boolean,
-          use_main_content_only: T::Boolean,
+          shorten_base64_images:
+            T.any(
+              T::Boolean,
+              ContextDev::ParseHandleParams::ShortenBase64Images::OrSymbol
+            ),
+          tags: T::Array[String],
+          use_main_content_only:
+            T.any(
+              T::Boolean,
+              ContextDev::ParseHandleParams::UseMainContentOnly::OrSymbol
+            ),
+          zdr: ContextDev::ParseHandleParams::Zdr::OrSymbol,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(ContextDev::Models::ParseHandleResponse)
       end
       def handle(
         # Body param
         body:,
-        # Query param: Optional file extension hint. Case-insensitive; a leading dot is
-        # accepted (e.g. ".pdf").
+        # Query param: Optional client identifier used for usage attribution.
+        client: nil,
+        # Query param: Optional file extension hint, such as pdf, docx, xlsx, pptx, html,
+        # json, csv, md, py, rtf, jpg, png, or txt.
         extension: nil,
         # Query param: Include image references in Markdown output
         include_images: nil,
         # Query param: Preserve hyperlinks in Markdown output
         include_links: nil,
-        # Query param: 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.
+        # Query param: When true for PDF inputs, detect and OCR images embedded in the
+        # selected pages, inserting recognized text at each image's position in page
+        # reading order while preserving the PDF text layer. pdf.start/pdf.end limit the
+        # inclusive page range. When false, all OCR is disabled, including the automatic
+        # scanned-PDF fallback.
         ocr: nil,
-        # Query param: PDF page-range controls. Use start/end to limit parsing (and OCR
-        # when ocr=true) to an inclusive 1-based page range.
+        # Query param: PDF page-range options as a JSON object, e.g. {"start": 2, "end":
+        # 5}.
         pdf: nil,
         # Query param: Shorten base64-encoded image data in the Markdown output
         shorten_base64_images: nil,
+        # Query param: Optional comma-separated caller-defined tags for tracking this
+        # request. Tags are recorded on the request's usage log and can be used to filter
+        # usage on the dashboard usage page. Up to 20 tags, each 1-50 characters.
+        tags: nil,
         # Query param: Extract only the main content from HTML-like inputs
         use_main_content_only: nil,
+        # Query param: Set to enabled to bypass shared caches and omit request and
+        # response content from retained usage logs. Requires zero data retention to be
+        # enabled for your organization (contact support@context.dev), otherwise the
+        # request fails with ZDR_NOT_ENABLED. Successful ZDR responses include
+        # X-Context-ZDR: true.
+        zdr: nil,
         request_options: {}
       )
       end

data/rbi/context_dev/resources/utility.rbi

@@ -15,6 +15,7 @@ module ContextDev
               ContextDev::UtilityPrefetchParams::Identifier::UtilityPrefetchEmailIdentifier::OrHash
             ),
           type: ContextDev::UtilityPrefetchParams::Type::OrSymbol,
+          tags: T::Array[String],
           timeout_ms: Integer,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(ContextDev::Models::UtilityPrefetchResponse)
@@ -24,6 +25,8 @@ module ContextDev
         identifier:,
         # What to prefetch. Currently only 'brand' is supported.
         type:,
+        # Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.
+        tags: nil,
         # Optional timeout in milliseconds for the request. If the request takes longer
         # than this value, it will be aborted with a 408 status code. Maximum allowed
         # value is 300000ms (5 minutes).