Source code for ralph.mcp.multimodal._media_entry_extras

"""MediaEntryExtras — optional extras when adding a media artifact to the manifest."""

from __future__ import annotations

from dataclasses import dataclass
from typing import TYPE_CHECKING

if TYPE_CHECKING:
    from ralph.mcp.multimodal._manifest_entry import ByteLoader




@dataclass(frozen=True)
class MediaEntryExtras:
    """Optional extras when adding a media artifact to the manifest."""

    cache_path: str = ""
    source_path: str = ""
    source_uri: str = ""
    identity_key: str = ""
    byte_loader: ByteLoader | None = None
    # Optional pre-assigned artifact_id so callers that need to
    # persist a cache file BEFORE the manifest assigns the id (for
    # an at-add-time byte_loader that references the cache path)
    # can do so without a chicken-and-egg dependency.
    artifact_id: str = ""



__all__ = ["MediaEntryExtras"]