Datasources

class DatasourcesResponse:
    success: bool
    error: Optional[str]
    datasources: List[Datasource]

class Datasource:
    id: str                              # e.g., "valyu/valyu-arxiv"
    name: str
    description: str
    category: str
    type: Optional[str]
    modality: Optional[List[str]]
    topics: Optional[List[str]]
    languages: Optional[List[str]]
    source: Optional[str]
    example_queries: Optional[List[str]] # Sample queries for few-shot prompting
    pricing: Optional[DatasourcePricing] # .cpm = cost per million tokens
    response_schema: Optional[dict]
    update_frequency: Optional[str]
    size: Optional[int]
    coverage: Optional[DatasourceCoverage]  # .start_date / .end_date

class DatasourceCategoriesResponse:
    success: bool
    error: Optional[str]
    categories: List[DatasourceCategory]

class DatasourceCategory:
    id: str
    name: str
    description: Optional[str]
    dataset_count: int