docs(people): note that complex ultra people searches can take up to 60 seconds (#2206)

Stainless-Generated-From: 2a32bddde7809f3d33143d2340e32390190b5c15

Author: stlc-bot

lib/context_dev/models/person_search_params.rb

@@ -29,7 +29,8 @@ class PersonSearchParams < ContextDev::Internal::Type::BaseModel
       # @!attribute mode
       #   `fast` matches people on basic criteria (e.g. their role, location or
       #   background); `ultra` plans a deeper search, judges each candidate against every
-      #   criterion in the query and explains each match.
+      #   criterion in the query. Complex `ultra` searches can take up to 60 seconds to
+      #   complete, so allow for that in your client timeout.
       #
       #   @return [Symbol, ContextDev::Models::PersonSearchParams::Mode, nil]
       optional :mode, enum: -> { ContextDev::PersonSearchParams::Mode }
@@ -87,7 +88,8 @@ class Filters < ContextDev::Internal::Type::BaseModel
 
       # `fast` matches people on basic criteria (e.g. their role, location or
       # background); `ultra` plans a deeper search, judges each candidate against every
-      # criterion in the query and explains each match.
+      # criterion in the query. Complex `ultra` searches can take up to 60 seconds to
+      # complete, so allow for that in your client timeout.
       module Mode
         extend ContextDev::Internal::Type::Enum
 

rbi/context_dev/models/person_search_params.rbi

@@ -34,7 +34,8 @@ module ContextDev
 
       # `fast` matches people on basic criteria (e.g. their role, location or
       # background); `ultra` plans a deeper search, judges each candidate against every
-      # criterion in the query and explains each match.
+      # criterion in the query. Complex `ultra` searches can take up to 60 seconds to
+      # complete, so allow for that in your client timeout.
       sig { returns(T.nilable(ContextDev::PersonSearchParams::Mode::OrSymbol)) }
       attr_reader :mode
 
@@ -68,7 +69,8 @@ module ContextDev
         filters: nil,
         # `fast` matches people on basic criteria (e.g. their role, location or
         # background); `ultra` plans a deeper search, judges each candidate against every
-        # criterion in the query and explains each match.
+        # criterion in the query. Complex `ultra` searches can take up to 60 seconds to
+        # complete, so allow for that in your client timeout.
         mode: nil,
         # Labels for filtering usage in the dashboard.
         tags: nil,
@@ -154,7 +156,8 @@ module ContextDev
 
       # `fast` matches people on basic criteria (e.g. their role, location or
       # background); `ultra` plans a deeper search, judges each candidate against every
-      # criterion in the query and explains each match.
+      # criterion in the query. Complex `ultra` searches can take up to 60 seconds to
+      # complete, so allow for that in your client timeout.
       module Mode
         extend ContextDev::Internal::Type::Enum
 

rbi/context_dev/resources/people.rbi

@@ -68,7 +68,8 @@ module ContextDev
         filters: nil,
         # `fast` matches people on basic criteria (e.g. their role, location or
         # background); `ultra` plans a deeper search, judges each candidate against every
-        # criterion in the query and explains each match.
+        # criterion in the query. Complex `ultra` searches can take up to 60 seconds to
+        # complete, so allow for that in your client timeout.
         mode: nil,
         # Labels for filtering usage in the dashboard.
         tags: nil,