from uuid import UUID

from pydantic import BaseModel


class BulkDownloadRequest(BaseModel):
    """A request to assemble a Download Package (ADR-0060).

    The front end creates the app-owned Task first and writes the **selection
    config** into ``task.inputs`` (a JSON object of
    ``{portfolio_id, property_ids?, select_all?}`` — so a large hand-picked set
    never travels in an HTTP body), then passes only the ``task_id`` here. The
    backend reads the selection from ``task.inputs``.
    """

    task_id: UUID