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

Stainless-Generated-From: 953f3ff34aa60ea20a1310a056867cbe05305e9c

Author: stlc-bot

src/context/dev/resources/people.py

@@ -149,7 +149,8 @@ def search(
 
           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.
 
           tags: Labels for filtering usage in the dashboard.
 
@@ -304,7 +305,8 @@ async def search(
 
           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.
 
           tags: Labels for filtering usage in the dashboard.
 

src/context/dev/types/person_search_params.py

@@ -26,7 +26,8 @@ class PersonSearchParams(TypedDict, total=False):
     """`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.
+    candidate against every criterion in the query. Complex `ultra` searches can
+    take up to 60 seconds to complete, so allow for that in your client timeout.
     """
 
     tags: SequenceNotStr[str]