parallel-web 0.1.2__py3-none-any.whl → 0.2.0__py3-none-any.whl

parallel/resources/task_run.py

@@ -31,6 +31,7 @@ from ..lib._parsing._task_run_result import (
     wait_for_result_async as _wait_for_result_async,
     task_run_result_parser,
 )
+from ..types.shared_params.source_policy import SourcePolicy
 
 __all__ = ["TaskRunResource", "AsyncTaskRunResource"]
 
@@ -58,9 +59,10 @@ class TaskRunResource(SyncAPIResource):
     def create(
         self,
         *,
-        input: Union[str, object],
+        input: Union[str, Dict[str, object]],
         processor: str,
         metadata: Optional[Dict[str, Union[str, float, bool]]] | NotGiven = NOT_GIVEN,
+        source_policy: Optional[SourcePolicy] | NotGiven = NOT_GIVEN,
         task_spec: Optional[TaskSpecParam] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -70,7 +72,11 @@ class TaskRunResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskRun:
         """
-        Initiates a single task run.
+        Initiates a task run.
+
+        Returns immediately with a run object in status 'queued'.
+
+        Beta features can be enabled by setting the 'parallel-beta' header.
 
         Args:
           input: Input to the task, either text or a JSON object.
@@ -80,10 +86,16 @@ class TaskRunResource(SyncAPIResource):
           metadata: User-provided metadata stored with the run. Keys and values must be strings with
               a maximum length of 16 and 512 characters respectively.
 
+          source_policy: Source policy for web search results.
+
+              This policy governs which sources are allowed/disallowed in results.
+
           task_spec: Specification for a task.
 
-              For convenience we allow bare strings as input or output schemas, which is
-              equivalent to a text schema with the same description.
+              Auto output schemas can be specified by setting `output_schema={"type":"auto"}`.
+              Not specifying a TaskSpec is the same as setting an auto output schema.
+
+              For convenience bare strings are also accepted as input or output schemas.
 
           extra_headers: Send extra headers
 
@@ -100,6 +112,7 @@ class TaskRunResource(SyncAPIResource):
                     "input": input,
                     "processor": processor,
                     "metadata": metadata,
+                    "source_policy": source_policy,
                     "task_spec": task_spec,
                 },
                 task_run_create_params.TaskRunCreateParams,
@@ -122,7 +135,9 @@ class TaskRunResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskRun:
         """
-        Retrieves a run by run_id.
+        Retrieves run status by run_id.
+
+        The run result is available from the `/result` endpoint.
 
         Args:
           extra_headers: Send extra headers
@@ -156,7 +171,7 @@ class TaskRunResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskRunResult:
         """
-        Retrieves a run by run_id, blocking until the run is completed.
+        Retrieves a run result by run_id, blocking until the run is completed.
 
         Args:
           extra_headers: Send extra headers
@@ -212,7 +227,7 @@ class TaskRunResource(SyncAPIResource):
     def execute(
         self,
         *,
-        input: Union[str, object],
+        input: Union[str, Dict[str, object]],
         processor: str,
         metadata: Optional[Dict[str, Union[str, float, bool]]] | NotGiven = NOT_GIVEN,
         output: Optional[OutputSchema] | NotGiven = NOT_GIVEN,
@@ -227,7 +242,7 @@ class TaskRunResource(SyncAPIResource):
     def execute(
         self,
         *,
-        input: Union[str, object],
+        input: Union[str, Dict[str, object]],
         processor: str,
         metadata: Optional[Dict[str, Union[str, float, bool]]] | NotGiven = NOT_GIVEN,
         output: Type[OutputT],
@@ -241,7 +256,7 @@ class TaskRunResource(SyncAPIResource):
     def execute(
         self,
         *,
-        input: Union[str, object],
+        input: Union[str, Dict[str, object]],
         processor: str,
         metadata: Optional[Dict[str, Union[str, float, bool]]] | NotGiven = NOT_GIVEN,
         output: Optional[OutputSchema] | Type[OutputT] | NotGiven = NOT_GIVEN,
@@ -333,9 +348,10 @@ class AsyncTaskRunResource(AsyncAPIResource):
     async def create(
         self,
         *,
-        input: Union[str, object],
+        input: Union[str, Dict[str, object]],
         processor: str,
         metadata: Optional[Dict[str, Union[str, float, bool]]] | NotGiven = NOT_GIVEN,
+        source_policy: Optional[SourcePolicy] | NotGiven = NOT_GIVEN,
         task_spec: Optional[TaskSpecParam] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -345,7 +361,11 @@ class AsyncTaskRunResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskRun:
         """
-        Initiates a single task run.
+        Initiates a task run.
+
+        Returns immediately with a run object in status 'queued'.
+
+        Beta features can be enabled by setting the 'parallel-beta' header.
 
         Args:
           input: Input to the task, either text or a JSON object.
@@ -355,10 +375,16 @@ class AsyncTaskRunResource(AsyncAPIResource):
           metadata: User-provided metadata stored with the run. Keys and values must be strings with
               a maximum length of 16 and 512 characters respectively.
 
+          source_policy: Source policy for web search results.
+
+              This policy governs which sources are allowed/disallowed in results.
+
           task_spec: Specification for a task.
 
-              For convenience we allow bare strings as input or output schemas, which is
-              equivalent to a text schema with the same description.
+              Auto output schemas can be specified by setting `output_schema={"type":"auto"}`.
+              Not specifying a TaskSpec is the same as setting an auto output schema.
+
+              For convenience bare strings are also accepted as input or output schemas.
 
           extra_headers: Send extra headers
 
@@ -375,6 +401,7 @@ class AsyncTaskRunResource(AsyncAPIResource):
                     "input": input,
                     "processor": processor,
                     "metadata": metadata,
+                    "source_policy": source_policy,
                     "task_spec": task_spec,
                 },
                 task_run_create_params.TaskRunCreateParams,
@@ -397,7 +424,9 @@ class AsyncTaskRunResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskRun:
         """
-        Retrieves a run by run_id.
+        Retrieves run status by run_id.
+
+        The run result is available from the `/result` endpoint.
 
         Args:
           extra_headers: Send extra headers
@@ -431,7 +460,7 @@ class AsyncTaskRunResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskRunResult:
         """
-        Retrieves a run by run_id, blocking until the run is completed.
+        Retrieves a run result by run_id, blocking until the run is completed.
 
         Args:
           extra_headers: Send extra headers
@@ -489,7 +518,7 @@ class AsyncTaskRunResource(AsyncAPIResource):
     async def execute(
         self,
         *,
-        input: Union[str, object],
+        input: Union[str, Dict[str, object]],
         processor: str,
         metadata: Optional[Dict[str, Union[str, float, bool]]] | NotGiven = NOT_GIVEN,
         output: Optional[OutputSchema] | NotGiven = NOT_GIVEN,
@@ -502,7 +531,7 @@ class AsyncTaskRunResource(AsyncAPIResource):
     async def execute(
         self,
         *,
-        input: Union[str, object],
+        input: Union[str, Dict[str, object]],
         processor: str,
         metadata: Optional[Dict[str, Union[str, float, bool]]] | NotGiven = NOT_GIVEN,
         output: Type[OutputT],
@@ -514,7 +543,7 @@ class AsyncTaskRunResource(AsyncAPIResource):
     async def execute(
         self,
         *,
-        input: Union[str, object],
+        input: Union[str, Dict[str, object]],
         processor: str,
         metadata: Optional[Dict[str, Union[str, float, bool]]] | NotGiven = NOT_GIVEN,
         output: Optional[OutputSchema] | Type[OutputT] | NotGiven = NOT_GIVEN,

parallel/types/__init__.py

@@ -2,11 +2,26 @@
 
 from __future__ import annotations
 
+from .shared import (
+    Warning as Warning,
+    ErrorObject as ErrorObject,
+    SourcePolicy as SourcePolicy,
+    ErrorResponse as ErrorResponse,
+)
+from .citation import Citation as Citation
 from .task_run import TaskRun as TaskRun
+from .task_spec import TaskSpec as TaskSpec
+from .auto_schema import AutoSchema as AutoSchema
+from .field_basis import FieldBasis as FieldBasis
+from .json_schema import JsonSchema as JsonSchema
+from .text_schema import TextSchema as TextSchema
 from .task_run_result import TaskRunResult as TaskRunResult
 from .task_spec_param import TaskSpecParam as TaskSpecParam
+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 .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 .task_run_create_params import TaskRunCreateParams as TaskRunCreateParams
 from .task_run_result_params import TaskRunResultParams as TaskRunResultParams

parallel/types/auto_schema.py

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["AutoSchema"]
+
+
+class AutoSchema(BaseModel):
+    type: Optional[Literal["auto"]] = None
+    """The type of schema being defined. Always `auto`."""

parallel/types/auto_schema_param.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, TypedDict
+
+__all__ = ["AutoSchemaParam"]
+
+
+class AutoSchemaParam(TypedDict, total=False):
+    type: Literal["auto"]
+    """The type of schema being defined. Always `auto`."""

parallel/types/beta/__init__.py

@@ -0,0 +1,30 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from .webhook import Webhook as Webhook
+from .mcp_server import McpServer as McpServer
+from .task_group import TaskGroup as TaskGroup
+from .error_event import ErrorEvent as ErrorEvent
+from .mcp_tool_call import McpToolCall as McpToolCall
+from .search_result import SearchResult as SearchResult
+from .webhook_param import WebhookParam as WebhookParam
+from .beta_run_input import BetaRunInput as BetaRunInput
+from .task_run_event import TaskRunEvent as TaskRunEvent
+from .mcp_server_param import McpServerParam as McpServerParam
+from .task_group_status import TaskGroupStatus as TaskGroupStatus
+from .web_search_result import WebSearchResult as WebSearchResult
+from .beta_search_params import BetaSearchParams as BetaSearchParams
+from .parallel_beta_param import ParallelBetaParam as ParallelBetaParam
+from .beta_run_input_param import BetaRunInputParam as BetaRunInputParam
+from .beta_task_run_result import BetaTaskRunResult as BetaTaskRunResult
+from .task_run_create_params import TaskRunCreateParams as TaskRunCreateParams
+from .task_run_result_params import TaskRunResultParams as TaskRunResultParams
+from .task_group_run_response import TaskGroupRunResponse as TaskGroupRunResponse
+from .task_group_create_params import TaskGroupCreateParams as TaskGroupCreateParams
+from .task_group_events_params import TaskGroupEventsParams as TaskGroupEventsParams
+from .task_run_events_response import TaskRunEventsResponse as TaskRunEventsResponse
+from .task_group_add_runs_params import TaskGroupAddRunsParams as TaskGroupAddRunsParams
+from .task_group_events_response import TaskGroupEventsResponse as TaskGroupEventsResponse
+from .task_group_get_runs_params import TaskGroupGetRunsParams as TaskGroupGetRunsParams
+from .task_group_get_runs_response import TaskGroupGetRunsResponse as TaskGroupGetRunsResponse

parallel/types/beta/beta_run_input.py

@@ -0,0 +1,63 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, List, Union, Optional
+
+from .webhook import Webhook
+from ..._models import BaseModel
+from ..task_spec import TaskSpec
+from .mcp_server import McpServer
+from ..shared.source_policy import SourcePolicy
+
+__all__ = ["BetaRunInput"]
+
+
+class BetaRunInput(BaseModel):
+    input: Union[str, Dict[str, object]]
+    """Input to the task, either text or a JSON object."""
+
+    processor: str
+    """Processor to use for the task."""
+
+    enable_events: Optional[bool] = None
+    """Controls tracking of task run execution progress.
+
+    When set to true, progress events are recorded and can be accessed via the
+    [Task Run events](https://platform.parallel.ai/api-reference) endpoint. When
+    false, no progress events are tracked. Note that progress tracking cannot be
+    enabled after a run has been created. The flag is set to true by default for
+    premium processors (pro and above). This feature is not available via the Python
+    SDK. To enable this feature in your API requests, specify the `parallel-beta`
+    header with `events-sse-2025-07-24` value.
+    """
+
+    mcp_servers: Optional[List[McpServer]] = None
+    """
+    Optional list of MCP servers to use for the run. This feature is not available
+    via the Python SDK. To enable this feature in your API requests, specify the
+    `parallel-beta` header with `mcp-server-2025-07-17` value.
+    """
+
+    metadata: Optional[Dict[str, Union[str, float, bool]]] = None
+    """User-provided metadata stored with the run.
+
+    Keys and values must be strings with a maximum length of 16 and 512 characters
+    respectively.
+    """
+
+    source_policy: Optional[SourcePolicy] = None
+    """Source policy for web search results.
+
+    This policy governs which sources are allowed/disallowed in results.
+    """
+
+    task_spec: Optional[TaskSpec] = None
+    """Specification for a task.
+
+    Auto output schemas can be specified by setting `output_schema={"type":"auto"}`.
+    Not specifying a TaskSpec is the same as setting an auto output schema.
+
+    For convenience bare strings are also accepted as input or output schemas.
+    """
+
+    webhook: Optional[Webhook] = None
+    """Webhooks for Task Runs."""

parallel/types/beta/beta_run_input_param.py

@@ -0,0 +1,65 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, Union, Iterable, Optional
+from typing_extensions import Required, TypedDict
+
+from .webhook_param import WebhookParam
+from ..task_spec_param import TaskSpecParam
+from .mcp_server_param import McpServerParam
+from ..shared_params.source_policy import SourcePolicy
+
+__all__ = ["BetaRunInputParam"]
+
+
+class BetaRunInputParam(TypedDict, total=False):
+    input: Required[Union[str, Dict[str, object]]]
+    """Input to the task, either text or a JSON object."""
+
+    processor: Required[str]
+    """Processor to use for the task."""
+
+    enable_events: Optional[bool]
+    """Controls tracking of task run execution progress.
+
+    When set to true, progress events are recorded and can be accessed via the
+    [Task Run events](https://platform.parallel.ai/api-reference) endpoint. When
+    false, no progress events are tracked. Note that progress tracking cannot be
+    enabled after a run has been created. The flag is set to true by default for
+    premium processors (pro and above). This feature is not available via the Python
+    SDK. To enable this feature in your API requests, specify the `parallel-beta`
+    header with `events-sse-2025-07-24` value.
+    """
+
+    mcp_servers: Optional[Iterable[McpServerParam]]
+    """
+    Optional list of MCP servers to use for the run. This feature is not available
+    via the Python SDK. To enable this feature in your API requests, specify the
+    `parallel-beta` header with `mcp-server-2025-07-17` value.
+    """
+
+    metadata: Optional[Dict[str, Union[str, float, bool]]]
+    """User-provided metadata stored with the run.
+
+    Keys and values must be strings with a maximum length of 16 and 512 characters
+    respectively.
+    """
+
+    source_policy: Optional[SourcePolicy]
+    """Source policy for web search results.
+
+    This policy governs which sources are allowed/disallowed in results.
+    """
+
+    task_spec: Optional[TaskSpecParam]
+    """Specification for a task.
+
+    Auto output schemas can be specified by setting `output_schema={"type":"auto"}`.
+    Not specifying a TaskSpec is the same as setting an auto output schema.
+
+    For convenience bare strings are also accepted as input or output schemas.
+    """
+
+    webhook: Optional[WebhookParam]
+    """Webhooks for Task Runs."""

parallel/types/beta/beta_search_params.py

@@ -0,0 +1,47 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import List, Optional
+from typing_extensions import Literal, TypedDict
+
+from ..shared_params.source_policy import SourcePolicy
+
+__all__ = ["BetaSearchParams"]
+
+
+class BetaSearchParams(TypedDict, total=False):
+    max_chars_per_result: Optional[int]
+    """
+    Upper bound on the number of characters to include in excerpts for each search
+    result.
+    """
+
+    max_results: Optional[int]
+    """Upper bound on the number of results to return.
+
+    May be limited by the processor. Defaults to 10 if not provided.
+    """
+
+    objective: Optional[str]
+    """Natural-language description of what the web search is trying to find.
+
+    May include guidance about preferred sources or freshness. At least one of
+    objective or search_queries must be provided.
+    """
+
+    processor: Literal["base", "pro"]
+    """Search processor."""
+
+    search_queries: Optional[List[str]]
+    """Optional list of traditional keyword search queries to guide the search.
+
+    May contain search operators. At least one of objective or search_queries must
+    be provided.
+    """
+
+    source_policy: Optional[SourcePolicy]
+    """Source policy for web search results.
+
+    This policy governs which sources are allowed/disallowed in results.
+    """

parallel/types/beta/beta_task_run_result.py

@@ -0,0 +1,74 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, List, Union, Optional
+from typing_extensions import Literal, Annotated, TypeAlias
+
+from ..._utils import PropertyInfo
+from ..._models import BaseModel
+from ..task_run import TaskRun
+from ..field_basis import FieldBasis
+from .mcp_tool_call import McpToolCall
+
+__all__ = ["BetaTaskRunResult", "Output", "OutputBetaTaskRunTextOutput", "OutputBetaTaskRunJsonOutput"]
+
+
+class OutputBetaTaskRunTextOutput(BaseModel):
+    basis: List[FieldBasis]
+    """Basis for the output."""
+
+    content: str
+    """Text output from the task."""
+
+    type: Literal["text"]
+    """
+    The type of output being returned, as determined by the output schema of the
+    task spec.
+    """
+
+    beta_fields: Optional[Dict[str, object]] = None
+    """Always None."""
+
+    mcp_tool_calls: Optional[List[McpToolCall]] = None
+    """MCP tool calls made by the task."""
+
+
+class OutputBetaTaskRunJsonOutput(BaseModel):
+    basis: List[FieldBasis]
+    """Basis for the output."""
+
+    content: Dict[str, object]
+    """
+    Output from the task as a native JSON object, as determined by the output schema
+    of the task spec.
+    """
+
+    type: Literal["json"]
+    """
+    The type of output being returned, as determined by the output schema of the
+    task spec.
+    """
+
+    beta_fields: Optional[Dict[str, object]] = None
+    """Always None."""
+
+    mcp_tool_calls: Optional[List[McpToolCall]] = None
+    """MCP tool calls made by the task."""
+
+    output_schema: Optional[Dict[str, object]] = None
+    """Output schema for the Task Run.
+
+    Populated only if the task was executed with an auto schema.
+    """
+
+
+Output: TypeAlias = Annotated[
+    Union[OutputBetaTaskRunTextOutput, OutputBetaTaskRunJsonOutput], PropertyInfo(discriminator="type")
+]
+
+
+class BetaTaskRunResult(BaseModel):
+    output: Output
+    """Output from the task conforming to the output schema."""
+
+    run: TaskRun
+    """Status of a task run."""

parallel/types/beta/error_event.py

@@ -0,0 +1,16 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+from ..shared.error_object import ErrorObject
+
+__all__ = ["ErrorEvent"]
+
+
+class ErrorEvent(BaseModel):
+    error: ErrorObject
+    """An error message."""
+
+    type: Literal["error"]
+    """Event type; always 'error'."""

parallel/types/beta/mcp_server.py

@@ -0,0 +1,25 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Dict, List, Optional
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+
+__all__ = ["McpServer"]
+
+
+class McpServer(BaseModel):
+    name: str
+    """Name of the MCP server."""
+
+    url: str
+    """URL of the MCP server."""
+
+    allowed_tools: Optional[List[str]] = None
+    """List of allowed tools for the MCP server."""
+
+    headers: Optional[Dict[str, str]] = None
+    """Headers for the MCP server."""
+
+    type: Optional[Literal["url"]] = None
+    """Type of MCP server being configured. Always `url`."""

parallel/types/beta/mcp_server_param.py

@@ -0,0 +1,25 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, List, Optional
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["McpServerParam"]
+
+
+class McpServerParam(TypedDict, total=False):
+    name: Required[str]
+    """Name of the MCP server."""
+
+    url: Required[str]
+    """URL of the MCP server."""
+
+    allowed_tools: Optional[List[str]]
+    """List of allowed tools for the MCP server."""
+
+    headers: Optional[Dict[str, str]]
+    """Headers for the MCP server."""
+
+    type: Literal["url"]
+    """Type of MCP server being configured. Always `url`."""

parallel/types/beta/mcp_tool_call.py

@@ -0,0 +1,27 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ..._models import BaseModel
+
+__all__ = ["McpToolCall"]
+
+
+class McpToolCall(BaseModel):
+    arguments: str
+    """Arguments used to call the MCP tool."""
+
+    server_name: str
+    """Name of the MCP server."""
+
+    tool_call_id: str
+    """Identifier for the tool call."""
+
+    tool_name: str
+    """Name of the tool being called."""
+
+    content: Optional[str] = None
+    """Output received from the tool call, if successful."""
+
+    error: Optional[str] = None
+    """Error message if the tool call failed."""

parallel/types/beta/parallel_beta_param.py

@@ -0,0 +1,12 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Union
+from typing_extensions import Literal, TypeAlias
+
+__all__ = ["ParallelBetaParam"]
+
+ParallelBetaParam: TypeAlias = Union[
+    Literal["mcp-server-2025-07-17", "events-sse-2025-07-24", "webhook-2025-08-12"], str
+]

parallel/types/beta/search_result.py

@@ -0,0 +1,16 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+
+from ..._models import BaseModel
+from .web_search_result import WebSearchResult
+
+__all__ = ["SearchResult"]
+
+
+class SearchResult(BaseModel):
+    results: List[WebSearchResult]
+    """A list of WebSearchResult objects, ordered by decreasing relevance."""
+
+    search_id: str
+    """Search ID. Example: `search_cad0a6d2-dec0-46bd-95ae-900527d880e7`"""