feat(answers): route people and company research with faster answers (#1336)

Stainless-Generated-From: a404076

Author: stlc-bot

src/context/dev/resources/web.py

@@ -82,12 +82,14 @@ def answers(
         for a short task or `ultra` for deeper research.
 
         Args:
-          task: Research task. Name a domain to have it read before searching.
+          task: Research task. The agent selects company/profile lookups, web searches, or page
+              reads. Include domains or URLs to focus the research.
 
           json_format: Example answer object, not JSON Schema. Up to 8 levels, 500 values, and 16000
               characters; unknowns may be null.
 
-          mode: `fast` for short tasks; `ultra` for deeper research (default).
+          mode: `fast` prioritizes speed, with extra verification for people and companies;
+              `ultra` supports deeper research (default).
 
           tags: Labels for filtering usage in the dashboard.
 
@@ -1480,12 +1482,14 @@ async def answers(
         for a short task or `ultra` for deeper research.
 
         Args:
-          task: Research task. Name a domain to have it read before searching.
+          task: Research task. The agent selects company/profile lookups, web searches, or page
+              reads. Include domains or URLs to focus the research.
 
           json_format: Example answer object, not JSON Schema. Up to 8 levels, 500 values, and 16000
               characters; unknowns may be null.
 
-          mode: `fast` for short tasks; `ultra` for deeper research (default).
+          mode: `fast` prioritizes speed, with extra verification for people and companies;
+              `ultra` supports deeper research (default).
 
           tags: Labels for filtering usage in the dashboard.
 

src/context/dev/types/web_answers_params.py

@@ -13,7 +13,11 @@
 
 class WebAnswersParams(TypedDict, total=False):
     task: Required[str]
-    """Research task. Name a domain to have it read before searching."""
+    """Research task.
+
+    The agent selects company/profile lookups, web searches, or page reads. Include
+    domains or URLs to focus the research.
+    """
 
     json_format: Dict[str, object]
     """Example answer object, not JSON Schema.
@@ -22,7 +26,10 @@ class WebAnswersParams(TypedDict, total=False):
     """
 
     mode: Literal["fast", "ultra"]
-    """`fast` for short tasks; `ultra` for deeper research (default)."""
+    """
+    `fast` prioritizes speed, with extra verification for people and companies;
+    `ultra` supports deeper research (default).
+    """
 
     tags: SequenceNotStr[str]
     """Labels for filtering usage in the dashboard."""

src/context/dev/types/web_answers_response.py

@@ -22,9 +22,10 @@ class WebAnswersResponse(BaseModel):
     """The answer, in the shape requested by json_format."""
 
     sources: List[str]
-    """URLs that supplied search results or readable page content, in first-seen order.
-
-    Unreadable pages are excluded.
+    """
+    Public evidence URLs from searches, pages, or company/profile records, in
+    first-seen order. A listed URL may identify a record without its page being
+    read.
     """
 
     key_metadata: Optional[KeyMetadata] = None