context.dev 2.11.0 → 2.13.0

data/rbi/context_dev/models/web_extract_response.rbi

@@ -11,6 +11,20 @@ module ContextDev
           )
         end
 
+      # Cache outcome for this response. Composite responses are hits only when every
+      # cache-controlled fetch contributing to the output was a hit; age_ms is the
+      # oldest contributing hit.
+      sig { returns(ContextDev::Models::WebExtractResponse::CacheMetadata) }
+      attr_reader :cache_metadata
+
+      sig do
+        params(
+          cache_metadata:
+            ContextDev::Models::WebExtractResponse::CacheMetadata::OrHash
+        ).void
+      end
+      attr_writer :cache_metadata
+
       # Extracted data matching the request schema
       sig { returns(T::Hash[Symbol, T.anything]) }
       attr_accessor :data
@@ -54,6 +68,8 @@ module ContextDev
 
       sig do
         params(
+          cache_metadata:
+            ContextDev::Models::WebExtractResponse::CacheMetadata::OrHash,
           data: T::Hash[Symbol, T.anything],
           metadata: ContextDev::Models::WebExtractResponse::Metadata::OrHash,
           status: String,
@@ -64,6 +80,10 @@ module ContextDev
         ).returns(T.attached_class)
       end
       def self.new(
+        # Cache outcome for this response. Composite responses are hits only when every
+        # cache-controlled fetch contributing to the output was a hit; age_ms is the
+        # oldest contributing hit.
+        cache_metadata:,
         # Extracted data matching the request schema
         data:,
         metadata:,
@@ -82,6 +102,8 @@ module ContextDev
       sig do
         override.returns(
           {
+            cache_metadata:
+              ContextDev::Models::WebExtractResponse::CacheMetadata,
             data: T::Hash[Symbol, T.anything],
             metadata: ContextDev::Models::WebExtractResponse::Metadata,
             status: String,
@@ -94,6 +116,101 @@ module ContextDev
       def to_hash
       end
 
+      class CacheMetadata < ContextDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              ContextDev::Models::WebExtractResponse::CacheMetadata,
+              ContextDev::Internal::AnyHash
+            )
+          end
+
+        # Age of the cached data in milliseconds. Zero for miss and zdr responses.
+        sig { returns(Integer) }
+        attr_accessor :age_ms
+
+        # Whether the response was served from cache, required fresh work, or honored
+        # zero-data-retention cache bypass.
+        sig do
+          returns(
+            ContextDev::Models::WebExtractResponse::CacheMetadata::Status::TaggedSymbol
+          )
+        end
+        attr_accessor :status
+
+        # Cache outcome for this response. Composite responses are hits only when every
+        # cache-controlled fetch contributing to the output was a hit; age_ms is the
+        # oldest contributing hit.
+        sig do
+          params(
+            age_ms: Integer,
+            status:
+              ContextDev::Models::WebExtractResponse::CacheMetadata::Status::OrSymbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Age of the cached data in milliseconds. Zero for miss and zdr responses.
+          age_ms:,
+          # Whether the response was served from cache, required fresh work, or honored
+          # zero-data-retention cache bypass.
+          status:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              age_ms: Integer,
+              status:
+                ContextDev::Models::WebExtractResponse::CacheMetadata::Status::TaggedSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Whether the response was served from cache, required fresh work, or honored
+        # zero-data-retention cache bypass.
+        module Status
+          extend ContextDev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                ContextDev::Models::WebExtractResponse::CacheMetadata::Status
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          HIT =
+            T.let(
+              :hit,
+              ContextDev::Models::WebExtractResponse::CacheMetadata::Status::TaggedSymbol
+            )
+          MISS =
+            T.let(
+              :miss,
+              ContextDev::Models::WebExtractResponse::CacheMetadata::Status::TaggedSymbol
+            )
+          ZDR =
+            T.let(
+              :zdr,
+              ContextDev::Models::WebExtractResponse::CacheMetadata::Status::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                ContextDev::Models::WebExtractResponse::CacheMetadata::Status::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+
       class Metadata < ContextDev::Internal::Type::BaseModel
         OrHash =
           T.type_alias do
@@ -123,6 +240,28 @@ module ContextDev
         sig { returns(Integer) }
         attr_accessor :num_urls
 
+        # One verified outcome per requested browser action, in request order.
+        sig do
+          returns(
+            T.nilable(
+              T::Array[
+                ContextDev::Models::WebExtractResponse::Metadata::ActionsApplied
+              ]
+            )
+          )
+        end
+        attr_reader :actions_applied
+
+        sig do
+          params(
+            actions_applied:
+              T::Array[
+                ContextDev::Models::WebExtractResponse::Metadata::ActionsApplied::OrHash
+              ]
+          ).void
+        end
+        attr_writer :actions_applied
+
         sig do
           params(
             max_crawl_depth: Integer,
@@ -130,7 +269,11 @@ module ContextDev
             num_failed: Integer,
             num_skipped: Integer,
             num_succeeded: Integer,
-            num_urls: Integer
+            num_urls: Integer,
+            actions_applied:
+              T::Array[
+                ContextDev::Models::WebExtractResponse::Metadata::ActionsApplied::OrHash
+              ]
           ).returns(T.attached_class)
         end
         def self.new(
@@ -141,7 +284,9 @@ module ContextDev
           num_failed:,
           num_skipped:,
           num_succeeded:,
-          num_urls:
+          num_urls:,
+          # One verified outcome per requested browser action, in request order.
+          actions_applied: nil
         )
         end
 
@@ -153,12 +298,153 @@ module ContextDev
               num_failed: Integer,
               num_skipped: Integer,
               num_succeeded: Integer,
-              num_urls: Integer
+              num_urls: Integer,
+              actions_applied:
+                T::Array[
+                  ContextDev::Models::WebExtractResponse::Metadata::ActionsApplied
+                ]
             }
           )
         end
         def to_hash
         end
+
+        class ActionsApplied < ContextDev::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                ContextDev::Models::WebExtractResponse::Metadata::ActionsApplied,
+                ContextDev::Internal::AnyHash
+              )
+            end
+
+          sig { returns(String) }
+          attr_accessor :instruction
+
+          # Applied means the requested page state was visibly verified. Failed means it was
+          # not verified. Skipped means it was not attempted.
+          sig do
+            returns(
+              ContextDev::Models::WebExtractResponse::Metadata::ActionsApplied::Status::TaggedSymbol
+            )
+          end
+          attr_accessor :status
+
+          # Visible page evidence used to verify an applied action.
+          sig { returns(T.nilable(String)) }
+          attr_reader :completion_evidence
+
+          sig { params(completion_evidence: String).void }
+          attr_writer :completion_evidence
+
+          sig { returns(T.nilable(Float)) }
+          attr_reader :duration_ms
+
+          sig { params(duration_ms: Float).void }
+          attr_writer :duration_ms
+
+          sig { returns(T.nilable(String)) }
+          attr_reader :error
+
+          sig { params(error: String).void }
+          attr_writer :error
+
+          sig { returns(T.nilable(String)) }
+          attr_reader :method_
+
+          sig { params(method_: String).void }
+          attr_writer :method_
+
+          sig { returns(T.nilable(String)) }
+          attr_reader :target_description
+
+          sig { params(target_description: String).void }
+          attr_writer :target_description
+
+          sig do
+            params(
+              instruction: String,
+              status:
+                ContextDev::Models::WebExtractResponse::Metadata::ActionsApplied::Status::OrSymbol,
+              completion_evidence: String,
+              duration_ms: Float,
+              error: String,
+              method_: String,
+              target_description: String
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            instruction:,
+            # Applied means the requested page state was visibly verified. Failed means it was
+            # not verified. Skipped means it was not attempted.
+            status:,
+            # Visible page evidence used to verify an applied action.
+            completion_evidence: nil,
+            duration_ms: nil,
+            error: nil,
+            method_: nil,
+            target_description: nil
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                instruction: String,
+                status:
+                  ContextDev::Models::WebExtractResponse::Metadata::ActionsApplied::Status::TaggedSymbol,
+                completion_evidence: String,
+                duration_ms: Float,
+                error: String,
+                method_: String,
+                target_description: String
+              }
+            )
+          end
+          def to_hash
+          end
+
+          # Applied means the requested page state was visibly verified. Failed means it was
+          # not verified. Skipped means it was not attempted.
+          module Status
+            extend ContextDev::Internal::Type::Enum
+
+            TaggedSymbol =
+              T.type_alias do
+                T.all(
+                  Symbol,
+                  ContextDev::Models::WebExtractResponse::Metadata::ActionsApplied::Status
+                )
+              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+            APPLIED =
+              T.let(
+                :applied,
+                ContextDev::Models::WebExtractResponse::Metadata::ActionsApplied::Status::TaggedSymbol
+              )
+            FAILED =
+              T.let(
+                :failed,
+                ContextDev::Models::WebExtractResponse::Metadata::ActionsApplied::Status::TaggedSymbol
+              )
+            SKIPPED =
+              T.let(
+                :skipped,
+                ContextDev::Models::WebExtractResponse::Metadata::ActionsApplied::Status::TaggedSymbol
+              )
+
+            sig do
+              override.returns(
+                T::Array[
+                  ContextDev::Models::WebExtractResponse::Metadata::ActionsApplied::Status::TaggedSymbol
+                ]
+              )
+            end
+            def self.values
+            end
+          end
+        end
       end
 
       class KeyMetadata < ContextDev::Internal::Type::BaseModel

data/rbi/context_dev/models/web_extract_styleguide_response.rbi

@@ -11,6 +11,22 @@ module ContextDev
           )
         end
 
+      # Cache outcome for this response. Composite responses are hits only when every
+      # cache-controlled fetch contributing to the output was a hit; age_ms is the
+      # oldest contributing hit.
+      sig do
+        returns(ContextDev::Models::WebExtractStyleguideResponse::CacheMetadata)
+      end
+      attr_reader :cache_metadata
+
+      sig do
+        params(
+          cache_metadata:
+            ContextDev::Models::WebExtractStyleguideResponse::CacheMetadata::OrHash
+        ).void
+      end
+      attr_writer :cache_metadata
+
       # HTTP status code
       sig { returns(T.nilable(Integer)) }
       attr_reader :code
@@ -71,6 +87,8 @@ module ContextDev
 
       sig do
         params(
+          cache_metadata:
+            ContextDev::Models::WebExtractStyleguideResponse::CacheMetadata::OrHash,
           code: Integer,
           domain: String,
           key_metadata:
@@ -81,6 +99,10 @@ module ContextDev
         ).returns(T.attached_class)
       end
       def self.new(
+        # Cache outcome for this response. Composite responses are hits only when every
+        # cache-controlled fetch contributing to the output was a hit; age_ms is the
+        # oldest contributing hit.
+        cache_metadata:,
         # HTTP status code
         code: nil,
         # The normalized domain that was processed
@@ -98,6 +120,8 @@ module ContextDev
       sig do
         override.returns(
           {
+            cache_metadata:
+              ContextDev::Models::WebExtractStyleguideResponse::CacheMetadata,
             code: Integer,
             domain: String,
             key_metadata:
@@ -111,6 +135,101 @@ module ContextDev
       def to_hash
       end
 
+      class CacheMetadata < ContextDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              ContextDev::Models::WebExtractStyleguideResponse::CacheMetadata,
+              ContextDev::Internal::AnyHash
+            )
+          end
+
+        # Age of the cached data in milliseconds. Zero for miss and zdr responses.
+        sig { returns(Integer) }
+        attr_accessor :age_ms
+
+        # Whether the response was served from cache, required fresh work, or honored
+        # zero-data-retention cache bypass.
+        sig do
+          returns(
+            ContextDev::Models::WebExtractStyleguideResponse::CacheMetadata::Status::TaggedSymbol
+          )
+        end
+        attr_accessor :status
+
+        # Cache outcome for this response. Composite responses are hits only when every
+        # cache-controlled fetch contributing to the output was a hit; age_ms is the
+        # oldest contributing hit.
+        sig do
+          params(
+            age_ms: Integer,
+            status:
+              ContextDev::Models::WebExtractStyleguideResponse::CacheMetadata::Status::OrSymbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Age of the cached data in milliseconds. Zero for miss and zdr responses.
+          age_ms:,
+          # Whether the response was served from cache, required fresh work, or honored
+          # zero-data-retention cache bypass.
+          status:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              age_ms: Integer,
+              status:
+                ContextDev::Models::WebExtractStyleguideResponse::CacheMetadata::Status::TaggedSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Whether the response was served from cache, required fresh work, or honored
+        # zero-data-retention cache bypass.
+        module Status
+          extend ContextDev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                ContextDev::Models::WebExtractStyleguideResponse::CacheMetadata::Status
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          HIT =
+            T.let(
+              :hit,
+              ContextDev::Models::WebExtractStyleguideResponse::CacheMetadata::Status::TaggedSymbol
+            )
+          MISS =
+            T.let(
+              :miss,
+              ContextDev::Models::WebExtractStyleguideResponse::CacheMetadata::Status::TaggedSymbol
+            )
+          ZDR =
+            T.let(
+              :zdr,
+              ContextDev::Models::WebExtractStyleguideResponse::CacheMetadata::Status::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                ContextDev::Models::WebExtractStyleguideResponse::CacheMetadata::Status::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+
       class KeyMetadata < ContextDev::Internal::Type::BaseModel
         OrHash =
           T.type_alias do

data/rbi/context_dev/models/web_screenshot_response.rbi

@@ -11,6 +11,20 @@ module ContextDev
           )
         end
 
+      # Cache outcome for this response. Composite responses are hits only when every
+      # cache-controlled fetch contributing to the output was a hit; age_ms is the
+      # oldest contributing hit.
+      sig { returns(ContextDev::Models::WebScreenshotResponse::CacheMetadata) }
+      attr_reader :cache_metadata
+
+      sig do
+        params(
+          cache_metadata:
+            ContextDev::Models::WebScreenshotResponse::CacheMetadata::OrHash
+        ).void
+      end
+      attr_writer :cache_metadata
+
       # HTTP status code
       sig { returns(T.nilable(Integer)) }
       attr_reader :code
@@ -91,6 +105,8 @@ module ContextDev
 
       sig do
         params(
+          cache_metadata:
+            ContextDev::Models::WebScreenshotResponse::CacheMetadata::OrHash,
           code: Integer,
           domain: String,
           height: Integer,
@@ -104,6 +120,10 @@ module ContextDev
         ).returns(T.attached_class)
       end
       def self.new(
+        # Cache outcome for this response. Composite responses are hits only when every
+        # cache-controlled fetch contributing to the output was a hit; age_ms is the
+        # oldest contributing hit.
+        cache_metadata:,
         # HTTP status code
         code: nil,
         # The normalized domain that was processed
@@ -128,6 +148,8 @@ module ContextDev
       sig do
         override.returns(
           {
+            cache_metadata:
+              ContextDev::Models::WebScreenshotResponse::CacheMetadata,
             code: Integer,
             domain: String,
             height: Integer,
@@ -144,6 +166,101 @@ module ContextDev
       def to_hash
       end
 
+      class CacheMetadata < ContextDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              ContextDev::Models::WebScreenshotResponse::CacheMetadata,
+              ContextDev::Internal::AnyHash
+            )
+          end
+
+        # Age of the cached data in milliseconds. Zero for miss and zdr responses.
+        sig { returns(Integer) }
+        attr_accessor :age_ms
+
+        # Whether the response was served from cache, required fresh work, or honored
+        # zero-data-retention cache bypass.
+        sig do
+          returns(
+            ContextDev::Models::WebScreenshotResponse::CacheMetadata::Status::TaggedSymbol
+          )
+        end
+        attr_accessor :status
+
+        # Cache outcome for this response. Composite responses are hits only when every
+        # cache-controlled fetch contributing to the output was a hit; age_ms is the
+        # oldest contributing hit.
+        sig do
+          params(
+            age_ms: Integer,
+            status:
+              ContextDev::Models::WebScreenshotResponse::CacheMetadata::Status::OrSymbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Age of the cached data in milliseconds. Zero for miss and zdr responses.
+          age_ms:,
+          # Whether the response was served from cache, required fresh work, or honored
+          # zero-data-retention cache bypass.
+          status:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              age_ms: Integer,
+              status:
+                ContextDev::Models::WebScreenshotResponse::CacheMetadata::Status::TaggedSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Whether the response was served from cache, required fresh work, or honored
+        # zero-data-retention cache bypass.
+        module Status
+          extend ContextDev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                ContextDev::Models::WebScreenshotResponse::CacheMetadata::Status
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          HIT =
+            T.let(
+              :hit,
+              ContextDev::Models::WebScreenshotResponse::CacheMetadata::Status::TaggedSymbol
+            )
+          MISS =
+            T.let(
+              :miss,
+              ContextDev::Models::WebScreenshotResponse::CacheMetadata::Status::TaggedSymbol
+            )
+          ZDR =
+            T.let(
+              :zdr,
+              ContextDev::Models::WebScreenshotResponse::CacheMetadata::Status::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                ContextDev::Models::WebScreenshotResponse::CacheMetadata::Status::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+
       class KeyMetadata < ContextDev::Internal::Type::BaseModel
         OrHash =
           T.type_alias do