feat(api): Add Search and Extract v1 and associated types

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 22
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/parallel-web%2Fparallel-sdk-728ba63c23bc2eb4fe37b429fb084ed7600ae50c8c652aeb0c787216c3ece07a.yml
-openapi_spec_hash: 3568175d488fc927f1710b3ebca87cfc
-config_hash: a398d153133d8884bed4e5256a0ae818
+configured_endpoints: 23
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/parallel-web%2Fparallel-sdk-44048676c9b07d49ed9dbee5fad53d145eddaea5ba682b6557681c5a7e04f8ed.yml
+openapi_spec_hash: e239787937742b1bc15e7f211fe3c518
+config_hash: 42d4e6039ef223ba2a824414a94da176

api.md

@@ -4,6 +4,28 @@
 from parallel.types import ErrorObject, ErrorResponse, SourcePolicy, Warning
 ```
 
+# Parallel
+
+Types:
+
+```python
+from parallel.types import (
+    ExcerptSettings,
+    ExtractError,
+    ExtractResponse,
+    ExtractResult,
+    FetchPolicy,
+    SearchResult,
+    UsageItem,
+    WebSearchResult,
+)
+```
+
+Methods:
+
+- <code title="post /v1/extract">client.<a href="./src/parallel/_client.py">extract</a>(\*\*<a href="src/parallel/types/client_extract_params.py">params</a>) -> <a href="./src/parallel/types/extract_response.py">ExtractResponse</a></code>
+- <code title="post /v1/search">client.<a href="./src/parallel/_client.py">search</a>(\*\*<a href="src/parallel/types/client_search_params.py">params</a>) -> <a href="./src/parallel/types/search_result.py">SearchResult</a></code>
+
 # TaskRun
 
 Types:

src/parallel/_client.py

@@ -5,13 +5,13 @@ Types:
 ```python
 from parallel.types.beta import (
     ExcerptSettings,
-    ExtractError,
     ExtractResponse,
     ExtractResult,
-    FetchPolicy,
     SearchResult,
-    UsageItem,
     WebSearchResult,
+    ExtractError,
+    FetchPolicy,
+    UsageItem,
 )
 ```
 

src/parallel/resources/beta/api.md

@@ -38,14 +38,17 @@
 
 
 class TaskGroupResource(SyncAPIResource):
-    """
-    The Task Group API is currently in beta and enables batch execution of many independent Task runs with group-level monitoring and failure handling.
+    """The Task API executes web research and extraction tasks.
+
+    Clients submit a natural-language objective with an optional input schema; the service plans retrieval, fetches relevant URLs, and returns outputs that conform to a provided or inferred JSON schema. Supports deep research style queries and can return rich structured JSON outputs. Processors trade-off between cost, latency, and quality. Each processor supports calibrated confidences.
+    - Output metadata: citations, excerpts, reasoning, and confidence per field
+
+    Task Groups enable batch execution of many independent Task runs with group-level monitoring and failure handling.
      - Submit hundreds or thousands of Tasks as a single group
     - Observe group progress and receive results as they complete
     - Real-time updates via Server-Sent Events (SSE)
     - Add tasks to an existing group while it is running
     - Group-level retry and error aggregation
-    Status: beta and subject to change.
     """
 
     @cached_property
@@ -332,14 +335,17 @@ def get_runs(
 
 
 class AsyncTaskGroupResource(AsyncAPIResource):
-    """
-    The Task Group API is currently in beta and enables batch execution of many independent Task runs with group-level monitoring and failure handling.
+    """The Task API executes web research and extraction tasks.
+
+    Clients submit a natural-language objective with an optional input schema; the service plans retrieval, fetches relevant URLs, and returns outputs that conform to a provided or inferred JSON schema. Supports deep research style queries and can return rich structured JSON outputs. Processors trade-off between cost, latency, and quality. Each processor supports calibrated confidences.
+    - Output metadata: citations, excerpts, reasoning, and confidence per field
+
+    Task Groups enable batch execution of many independent Task runs with group-level monitoring and failure handling.
      - Submit hundreds or thousands of Tasks as a single group
     - Observe group progress and receive results as they complete
     - Real-time updates via Server-Sent Events (SSE)
     - Add tasks to an existing group while it is running
     - Group-level retry and error aggregation
-    Status: beta and subject to change.
     """
 
     @cached_property

src/parallel/resources/beta/beta.py

@@ -37,6 +37,13 @@ class TaskRunResource(SyncAPIResource):
 
     Clients submit a natural-language objective with an optional input schema; the service plans retrieval, fetches relevant URLs, and returns outputs that conform to a provided or inferred JSON schema. Supports deep research style queries and can return rich structured JSON outputs. Processors trade-off between cost, latency, and quality. Each processor supports calibrated confidences.
     - Output metadata: citations, excerpts, reasoning, and confidence per field
+
+    Task Groups enable batch execution of many independent Task runs with group-level monitoring and failure handling.
+     - Submit hundreds or thousands of Tasks as a single group
+    - Observe group progress and receive results as they complete
+    - Real-time updates via Server-Sent Events (SSE)
+    - Add tasks to an existing group while it is running
+    - Group-level retry and error aggregation
     """
 
     @cached_property
@@ -265,6 +272,13 @@ class AsyncTaskRunResource(AsyncAPIResource):
 
     Clients submit a natural-language objective with an optional input schema; the service plans retrieval, fetches relevant URLs, and returns outputs that conform to a provided or inferred JSON schema. Supports deep research style queries and can return rich structured JSON outputs. Processors trade-off between cost, latency, and quality. Each processor supports calibrated confidences.
     - Output metadata: citations, excerpts, reasoning, and confidence per field
+
+    Task Groups enable batch execution of many independent Task runs with group-level monitoring and failure handling.
+     - Submit hundreds or thousands of Tasks as a single group
+    - Observe group progress and receive results as they complete
+    - Real-time updates via Server-Sent Events (SSE)
+    - Add tasks to an existing group while it is running
+    - Group-level retry and error aggregation
     """
 
     @cached_property

src/parallel/resources/beta/task_group.py

@@ -41,6 +41,13 @@ class TaskRunResource(SyncAPIResource):
 
     Clients submit a natural-language objective with an optional input schema; the service plans retrieval, fetches relevant URLs, and returns outputs that conform to a provided or inferred JSON schema. Supports deep research style queries and can return rich structured JSON outputs. Processors trade-off between cost, latency, and quality. Each processor supports calibrated confidences.
     - Output metadata: citations, excerpts, reasoning, and confidence per field
+
+    Task Groups enable batch execution of many independent Task runs with group-level monitoring and failure handling.
+     - Submit hundreds or thousands of Tasks as a single group
+    - Observe group progress and receive results as they complete
+    - Real-time updates via Server-Sent Events (SSE)
+    - Add tasks to an existing group while it is running
+    - Group-level retry and error aggregation
     """
 
     @cached_property
@@ -340,6 +347,13 @@ class AsyncTaskRunResource(AsyncAPIResource):
 
     Clients submit a natural-language objective with an optional input schema; the service plans retrieval, fetches relevant URLs, and returns outputs that conform to a provided or inferred JSON schema. Supports deep research style queries and can return rich structured JSON outputs. Processors trade-off between cost, latency, and quality. Each processor supports calibrated confidences.
     - Output metadata: citations, excerpts, reasoning, and confidence per field
+
+    Task Groups enable batch execution of many independent Task runs with group-level monitoring and failure handling.
+     - Submit hundreds or thousands of Tasks as a single group
+    - Observe group progress and receive results as they complete
+    - Real-time updates via Server-Sent Events (SSE)
+    - Add tasks to an existing group while it is running
+    - Group-level retry and error aggregation
     """
 
     @cached_property

src/parallel/resources/beta/task_run.py

@@ -20,8 +20,18 @@
 from .auto_schema_param import AutoSchemaParam as AutoSchemaParam
 from .json_schema_param import JsonSchemaParam as JsonSchemaParam
 from .text_schema_param import TextSchemaParam as TextSchemaParam
+from .web_search_result import WebSearchResult as WebSearchResult
+from .fetch_policy_param import FetchPolicyParam as FetchPolicyParam
+from .client_search_params import ClientSearchParams as ClientSearchParams
 from .task_run_json_output import TaskRunJsonOutput as TaskRunJsonOutput
 from .task_run_text_output import TaskRunTextOutput as TaskRunTextOutput
 from .parsed_task_run_result import ParsedTaskRunResult as ParsedTaskRunResult
+from .usage_item import UsageItem as UsageItem
+from .extract_error import ExtractError as ExtractError
+from .search_result import SearchResult as SearchResult
+from .extract_result import ExtractResult as ExtractResult
+from .extract_response import ExtractResponse as ExtractResponse
+from .client_extract_params import ClientExtractParams as ClientExtractParams
+from .excerpt_settings_param import ExcerptSettingsParam as ExcerptSettingsParam
 from .task_run_create_params import TaskRunCreateParams as TaskRunCreateParams
 from .task_run_result_params import TaskRunResultParams as TaskRunResultParams

src/parallel/resources/task_run.py

@@ -7,22 +7,33 @@
 
 from ..._types import SequenceNotStr
 from ..._utils import PropertyInfo
-from .fetch_policy_param import FetchPolicyParam
+from ..fetch_policy_param import FetchPolicyParam
 from .parallel_beta_param import ParallelBetaParam
 from .excerpt_settings_param import ExcerptSettingsParam
 
-__all__ = ["BetaExtractParams", "Excerpts"]
+__all__ = ["BetaExtractParams", "Excerpts", "FullContent", "FullContentFullContentSettings"]
 
 
 class BetaExtractParams(TypedDict, total=False):
     urls: Required[SequenceNotStr[str]]
 
     excerpts: Excerpts
-    """Include excerpts from each URL relevant to the search objective and queries."""
+    """Include excerpts from each URL relevant to the search objective and queries.
+
+    Note that if neither objective nor search_queries is provided, excerpts are
+    redundant with full content.
+    """
 
     fetch_policy: Optional[FetchPolicyParam]
     """Policy for live fetching web results."""
 
+    full_content: FullContent
+    """Include full content from each URL.
+
+    Note that if neither objective nor search_queries is provided, excerpts are
+    redundant with full content.
+    """
+
     objective: Optional[str]
     """If provided, focuses extracted content on the specified search objective."""
 
@@ -34,3 +45,17 @@ class BetaExtractParams(TypedDict, total=False):
 
 
 Excerpts: TypeAlias = Union[bool, ExcerptSettingsParam]
+
+
+class FullContentFullContentSettings(TypedDict, total=False):
+    """Optional settings for returning full content."""
+
+    max_chars_per_result: Optional[int]
+    """
+    Optional limit on the number of characters to include in the full content for
+    each url. Full content always starts at the beginning of the page and is
+    truncated at the limit if necessary.
+    """
+
+
+FullContent: TypeAlias = Union[bool, FullContentFullContentSettings]