# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.

from typing import List, Optional

from .._models import BaseModel
from .usage_item import UsageItem
from .shared.warning import Warning
from .web_search_result import WebSearchResult

__all__ = ["SearchResult"]


class SearchResult(BaseModel):
    """Search response."""

    results: List[WebSearchResult]
    """A list of search results, ordered by decreasing relevance."""

    search_id: str
    """Search ID. Example: `search_cad0a6d2dec046bd95ae900527d880e7`"""

    session_id: str
    """
    Session identifier, echoed back from the request if provided, otherwise
    generated by the server. Should be passed to future search and extract calls
    made by the agent as part of the same larger task.
    """

    usage: Optional[List[UsageItem]] = None
    """Usage metrics for the search request."""

    warnings: Optional[List[Warning]] = None
    """Warnings for the search request, if any."""