# 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 .extract_error import ExtractError
from .extract_result import ExtractResult
from .shared.warning import Warning

__all__ = ["ExtractResponse"]


class ExtractResponse(BaseModel):
    """Extract response."""

    errors: List[ExtractError]
    """Extract errors: requested URLs not in the results."""

    extract_id: str
    """Extract request ID, e.g. `extract_cad0a6d2dec046bd95ae900527d880e7`"""

    results: List[ExtractResult]
    """Successful extract results."""

    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 extract request."""

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