context.dev 2.16.0 → 2.17.0

data/rbi/context_dev/models/person_enrich_params.rbi

@@ -64,14 +64,18 @@ module ContextDev
       sig { params(tags: T::Array[String]).void }
       attr_writer :tags
 
-      # 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).
-      sig { returns(T.nilable(Integer)) }
-      attr_reader :timeout_ms
+      # Optional request deadline and behavior on timeout. For GET requests, use
+      # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+      # timeoutOpts object.
+      sig { returns(T.nilable(ContextDev::PersonEnrichParams::TimeoutOpts)) }
+      attr_reader :timeout_opts
 
-      sig { params(timeout_ms: Integer).void }
-      attr_writer :timeout_ms
+      sig do
+        params(
+          timeout_opts: ContextDev::PersonEnrichParams::TimeoutOpts::OrHash
+        ).void
+      end
+      attr_writer :timeout_opts
 
       sig do
         params(
@@ -83,7 +87,7 @@ module ContextDev
           name: ContextDev::PersonEnrichParams::Name::OrHash,
           social_urls: T::Array[String],
           tags: T::Array[String],
-          timeout_ms: Integer,
+          timeout_opts: ContextDev::PersonEnrichParams::TimeoutOpts::OrHash,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
@@ -96,10 +100,10 @@ module ContextDev
         social_urls: nil,
         # 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).
-        timeout_ms: nil,
+        # Optional request deadline and behavior on timeout. For GET requests, use
+        # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+        # timeoutOpts object.
+        timeout_opts: nil,
         request_options: {}
       )
       end
@@ -114,7 +118,7 @@ module ContextDev
             name: ContextDev::PersonEnrichParams::Name,
             social_urls: T::Array[String],
             tags: T::Array[String],
-            timeout_ms: Integer,
+            timeout_opts: ContextDev::PersonEnrichParams::TimeoutOpts,
             request_options: ContextDev::RequestOptions
           }
         )
@@ -327,6 +331,112 @@ module ContextDev
         def to_hash
         end
       end
+
+      class TimeoutOpts < ContextDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              ContextDev::PersonEnrichParams::TimeoutOpts,
+              ContextDev::Internal::AnyHash
+            )
+          end
+
+        # Request deadline in milliseconds. Maximum: 300000 (5 minutes).
+        sig { returns(Integer) }
+        attr_accessor :milliseconds
+
+        # What to do at the deadline. "fail" returns 408 REQUEST_TIMEOUT without charging
+        # credits. "return-partial" returns usable results collected so far; if none are
+        # available, the request still fails without charging credits. Partial results are
+        # not cached as complete results.
+        sig do
+          returns(
+            T.nilable(
+              ContextDev::PersonEnrichParams::TimeoutOpts::Behavior::OrSymbol
+            )
+          )
+        end
+        attr_reader :behavior
+
+        sig do
+          params(
+            behavior:
+              ContextDev::PersonEnrichParams::TimeoutOpts::Behavior::OrSymbol
+          ).void
+        end
+        attr_writer :behavior
+
+        # Optional request deadline and behavior on timeout. For GET requests, use
+        # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+        # timeoutOpts object.
+        sig do
+          params(
+            milliseconds: Integer,
+            behavior:
+              ContextDev::PersonEnrichParams::TimeoutOpts::Behavior::OrSymbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Request deadline in milliseconds. Maximum: 300000 (5 minutes).
+          milliseconds:,
+          # What to do at the deadline. "fail" returns 408 REQUEST_TIMEOUT without charging
+          # credits. "return-partial" returns usable results collected so far; if none are
+          # available, the request still fails without charging credits. Partial results are
+          # not cached as complete results.
+          behavior: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              milliseconds: Integer,
+              behavior:
+                ContextDev::PersonEnrichParams::TimeoutOpts::Behavior::OrSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # What to do at the deadline. "fail" returns 408 REQUEST_TIMEOUT without charging
+        # credits. "return-partial" returns usable results collected so far; if none are
+        # available, the request still fails without charging credits. Partial results are
+        # not cached as complete results.
+        module Behavior
+          extend ContextDev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                ContextDev::PersonEnrichParams::TimeoutOpts::Behavior
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          FAIL =
+            T.let(
+              :fail,
+              ContextDev::PersonEnrichParams::TimeoutOpts::Behavior::TaggedSymbol
+            )
+          RETURN_PARTIAL =
+            T.let(
+              :"return-partial",
+              ContextDev::PersonEnrichParams::TimeoutOpts::Behavior::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                ContextDev::PersonEnrichParams::TimeoutOpts::Behavior::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
     end
   end
 end

data/rbi/context_dev/models/person_enrich_response.rbi

@@ -36,6 +36,14 @@ module ContextDev
       end
       attr_writer :key_metadata
 
+      # True when the timeout ended processing and this response contains the usable
+      # data completed so far. Unfinished fields are omitted.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :partial
+
+      sig { params(partial: T::Boolean).void }
+      attr_writer :partial
+
       sig do
         params(
           match:
@@ -45,7 +53,8 @@ module ContextDev
             ),
           request_id: String,
           key_metadata:
-            ContextDev::Models::PersonEnrichResponse::KeyMetadata::OrHash
+            ContextDev::Models::PersonEnrichResponse::KeyMetadata::OrHash,
+          partial: T::Boolean
         ).returns(T.attached_class)
       end
       def self.new(
@@ -55,7 +64,10 @@ module ContextDev
         # it when contacting support about a failed request.
         request_id:,
         # Credit usage, included whenever a valid API key is provided.
-        key_metadata: nil
+        key_metadata: nil,
+        # True when the timeout ended processing and this response contains the usable
+        # data completed so far. Unfinished fields are omitted.
+        partial: nil
       )
       end
 
@@ -64,7 +76,8 @@ module ContextDev
           {
             match: ContextDev::Models::PersonEnrichResponse::Match::Variants,
             request_id: String,
-            key_metadata: ContextDev::Models::PersonEnrichResponse::KeyMetadata
+            key_metadata: ContextDev::Models::PersonEnrichResponse::KeyMetadata,
+            partial: T::Boolean
           }
         )
       end

data/rbi/context_dev/models/utility_prefetch_params.rbi

@@ -37,14 +37,18 @@ module ContextDev
       sig { params(tags: T::Array[String]).void }
       attr_writer :tags
 
-      # 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).
-      sig { returns(T.nilable(Integer)) }
-      attr_reader :timeout_ms
+      # Optional request deadline and behavior on timeout. For GET requests, use
+      # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+      # timeoutOpts object.
+      sig { returns(T.nilable(ContextDev::UtilityPrefetchParams::TimeoutOpts)) }
+      attr_reader :timeout_opts
 
-      sig { params(timeout_ms: Integer).void }
-      attr_writer :timeout_ms
+      sig do
+        params(
+          timeout_opts: ContextDev::UtilityPrefetchParams::TimeoutOpts::OrHash
+        ).void
+      end
+      attr_writer :timeout_opts
 
       sig do
         params(
@@ -55,7 +59,7 @@ module ContextDev
             ),
           type: ContextDev::UtilityPrefetchParams::Type::OrSymbol,
           tags: T::Array[String],
-          timeout_ms: Integer,
+          timeout_opts: ContextDev::UtilityPrefetchParams::TimeoutOpts::OrHash,
           request_options: ContextDev::RequestOptions::OrHash
         ).returns(T.attached_class)
       end
@@ -67,10 +71,10 @@ module ContextDev
         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).
-        timeout_ms: nil,
+        # Optional request deadline and behavior on timeout. For GET requests, use
+        # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+        # timeoutOpts object.
+        timeout_opts: nil,
         request_options: {}
       )
       end
@@ -85,7 +89,7 @@ module ContextDev
               ),
             type: ContextDev::UtilityPrefetchParams::Type::OrSymbol,
             tags: T::Array[String],
-            timeout_ms: Integer,
+            timeout_opts: ContextDev::UtilityPrefetchParams::TimeoutOpts,
             request_options: ContextDev::RequestOptions
           }
         )
@@ -197,6 +201,101 @@ module ContextDev
         def self.values
         end
       end
+
+      class TimeoutOpts < ContextDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              ContextDev::UtilityPrefetchParams::TimeoutOpts,
+              ContextDev::Internal::AnyHash
+            )
+          end
+
+        # Request deadline in milliseconds. Maximum: 300000 (5 minutes).
+        sig { returns(Integer) }
+        attr_accessor :milliseconds
+
+        # What to do at the deadline. This endpoint supports "fail": return 408
+        # REQUEST_TIMEOUT without charging credits.
+        sig do
+          returns(
+            T.nilable(
+              ContextDev::UtilityPrefetchParams::TimeoutOpts::Behavior::OrSymbol
+            )
+          )
+        end
+        attr_reader :behavior
+
+        sig do
+          params(
+            behavior:
+              ContextDev::UtilityPrefetchParams::TimeoutOpts::Behavior::OrSymbol
+          ).void
+        end
+        attr_writer :behavior
+
+        # Optional request deadline and behavior on timeout. For GET requests, use
+        # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+        # timeoutOpts object.
+        sig do
+          params(
+            milliseconds: Integer,
+            behavior:
+              ContextDev::UtilityPrefetchParams::TimeoutOpts::Behavior::OrSymbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Request deadline in milliseconds. Maximum: 300000 (5 minutes).
+          milliseconds:,
+          # What to do at the deadline. This endpoint supports "fail": return 408
+          # REQUEST_TIMEOUT without charging credits.
+          behavior: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              milliseconds: Integer,
+              behavior:
+                ContextDev::UtilityPrefetchParams::TimeoutOpts::Behavior::OrSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # What to do at the deadline. This endpoint supports "fail": return 408
+        # REQUEST_TIMEOUT without charging credits.
+        module Behavior
+          extend ContextDev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                ContextDev::UtilityPrefetchParams::TimeoutOpts::Behavior
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          FAIL =
+            T.let(
+              :fail,
+              ContextDev::UtilityPrefetchParams::TimeoutOpts::Behavior::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                ContextDev::UtilityPrefetchParams::TimeoutOpts::Behavior::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
     end
   end
 end

data/rbi/context_dev/models/web_answers_params.rbi

@@ -0,0 +1,234 @@
+# typed: strong
+
+module ContextDev
+  module Models
+    class WebAnswersParams < ContextDev::Internal::Type::BaseModel
+      extend ContextDev::Internal::Type::RequestParameters::Converter
+      include ContextDev::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(ContextDev::WebAnswersParams, ContextDev::Internal::AnyHash)
+        end
+
+      # What to research and answer, in plain language. Naming a domain in the task (for
+      # example "pricing on context.dev") makes the agent read that site before it
+      # searches.
+      sig { returns(String) }
+      attr_accessor :task
+
+      # An example object with placeholder values (for example {"pricing_page_url": "",
+      # "plans": [{"name": "", "price": 0}]}). Object keys and value types are
+      # preserved; unknown values may be null. Empty arrays accept any JSON items.
+      # Defaults to {"result": ""}. Maximum 8 levels, 500 values, and 16000 characters.
+      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+      attr_reader :json_format
+
+      sig { params(json_format: T::Hash[Symbol, T.anything]).void }
+      attr_writer :json_format
+
+      # Research level: fast uses a smaller model and research budget for 10 credits;
+      # ultra uses deeper reasoning and research for 100 credits. Defaults to ultra.
+      # Only successful requests consume credits.
+      sig { returns(T.nilable(ContextDev::WebAnswersParams::Mode::OrSymbol)) }
+      attr_reader :mode
+
+      sig { params(mode: ContextDev::WebAnswersParams::Mode::OrSymbol).void }
+      attr_writer :mode
+
+      # Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_reader :tags
+
+      sig { params(tags: T::Array[String]).void }
+      attr_writer :tags
+
+      # Optional request deadline and behavior on timeout. For GET requests, use
+      # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+      # timeoutOpts object.
+      sig { returns(T.nilable(ContextDev::WebAnswersParams::TimeoutOpts)) }
+      attr_reader :timeout_opts
+
+      sig do
+        params(
+          timeout_opts: ContextDev::WebAnswersParams::TimeoutOpts::OrHash
+        ).void
+      end
+      attr_writer :timeout_opts
+
+      sig do
+        params(
+          task: String,
+          json_format: T::Hash[Symbol, T.anything],
+          mode: ContextDev::WebAnswersParams::Mode::OrSymbol,
+          tags: T::Array[String],
+          timeout_opts: ContextDev::WebAnswersParams::TimeoutOpts::OrHash,
+          request_options: ContextDev::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # What to research and answer, in plain language. Naming a domain in the task (for
+        # example "pricing on context.dev") makes the agent read that site before it
+        # searches.
+        task:,
+        # An example object with placeholder values (for example {"pricing_page_url": "",
+        # "plans": [{"name": "", "price": 0}]}). Object keys and value types are
+        # preserved; unknown values may be null. Empty arrays accept any JSON items.
+        # Defaults to {"result": ""}. Maximum 8 levels, 500 values, and 16000 characters.
+        json_format: nil,
+        # Research level: fast uses a smaller model and research budget for 10 credits;
+        # ultra uses deeper reasoning and research for 100 credits. Defaults to ultra.
+        # Only successful requests consume credits.
+        mode: nil,
+        # Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.
+        tags: nil,
+        # Optional request deadline and behavior on timeout. For GET requests, use
+        # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+        # timeoutOpts object.
+        timeout_opts: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            task: String,
+            json_format: T::Hash[Symbol, T.anything],
+            mode: ContextDev::WebAnswersParams::Mode::OrSymbol,
+            tags: T::Array[String],
+            timeout_opts: ContextDev::WebAnswersParams::TimeoutOpts,
+            request_options: ContextDev::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # Research level: fast uses a smaller model and research budget for 10 credits;
+      # ultra uses deeper reasoning and research for 100 credits. Defaults to ultra.
+      # Only successful requests consume credits.
+      module Mode
+        extend ContextDev::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, ContextDev::WebAnswersParams::Mode) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        FAST = T.let(:fast, ContextDev::WebAnswersParams::Mode::TaggedSymbol)
+        ULTRA = T.let(:ultra, ContextDev::WebAnswersParams::Mode::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[ContextDev::WebAnswersParams::Mode::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+
+      class TimeoutOpts < ContextDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              ContextDev::WebAnswersParams::TimeoutOpts,
+              ContextDev::Internal::AnyHash
+            )
+          end
+
+        # Request deadline in milliseconds. Maximum: 300000 (5 minutes).
+        sig { returns(Integer) }
+        attr_accessor :milliseconds
+
+        # What to do at the deadline. "fail" returns 408 REQUEST_TIMEOUT without charging
+        # credits. "return-partial" returns usable results collected so far; if none are
+        # available, the request still fails without charging credits. Partial results are
+        # not cached as complete results.
+        sig do
+          returns(
+            T.nilable(
+              ContextDev::WebAnswersParams::TimeoutOpts::Behavior::OrSymbol
+            )
+          )
+        end
+        attr_reader :behavior
+
+        sig do
+          params(
+            behavior:
+              ContextDev::WebAnswersParams::TimeoutOpts::Behavior::OrSymbol
+          ).void
+        end
+        attr_writer :behavior
+
+        # Optional request deadline and behavior on timeout. For GET requests, use
+        # timeoutOpts[milliseconds]=30000&timeoutOpts[behavior]=fail or a JSON-encoded
+        # timeoutOpts object.
+        sig do
+          params(
+            milliseconds: Integer,
+            behavior:
+              ContextDev::WebAnswersParams::TimeoutOpts::Behavior::OrSymbol
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Request deadline in milliseconds. Maximum: 300000 (5 minutes).
+          milliseconds:,
+          # What to do at the deadline. "fail" returns 408 REQUEST_TIMEOUT without charging
+          # credits. "return-partial" returns usable results collected so far; if none are
+          # available, the request still fails without charging credits. Partial results are
+          # not cached as complete results.
+          behavior: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              milliseconds: Integer,
+              behavior:
+                ContextDev::WebAnswersParams::TimeoutOpts::Behavior::OrSymbol
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # What to do at the deadline. "fail" returns 408 REQUEST_TIMEOUT without charging
+        # credits. "return-partial" returns usable results collected so far; if none are
+        # available, the request still fails without charging credits. Partial results are
+        # not cached as complete results.
+        module Behavior
+          extend ContextDev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, ContextDev::WebAnswersParams::TimeoutOpts::Behavior)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          FAIL =
+            T.let(
+              :fail,
+              ContextDev::WebAnswersParams::TimeoutOpts::Behavior::TaggedSymbol
+            )
+          RETURN_PARTIAL =
+            T.let(
+              :"return-partial",
+              ContextDev::WebAnswersParams::TimeoutOpts::Behavior::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                ContextDev::WebAnswersParams::TimeoutOpts::Behavior::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end