Skip to main content
Version: latest

agrag.common.data_models.evidence.FetchOutcome

Bases: BaseModel

The result of fetching one evidence id.

Attributes:

  • evidence_id (str) – The id that was requested, as given.
  • status (FetchStatus) – The outcome of the fetch.
  • text (str | None) – The returned text, or None when no text is returned.
  • reference (EvidenceReference | None) – The decoded reference, or None for a malformed id.
  • document_key (str | None) – The key of the document, when the document is readable.
  • content_hash (str | None) – The full content hash of the version the text came from.
  • status_of_version (VersionStatus | None) – Whether that version is current, when text is returned.
  • covered_range (tuple[int, int] | None) – The offsets of the returned text, when it is a text range. A partial range gives the covered part only.
  • partial (bool) – True when the requested range was not fully covered by chunks.
  • detail (str | None) – A short message for a malformed or failed id. It is None for an unavailable id, because the reason stays on the server side.

content_hash​

content_hash: str | None = None

covered_range​

covered_range: tuple[int, int] | None = None

detail​

detail: str | None = None

document_key​

document_key: str | None = None

evidence_id​

evidence_id: str

partial​

partial: bool = False

reference​

reference: EvidenceReference | None = None

status​

status: FetchStatus

status_of_version​

status_of_version: VersionStatus | None = None

text​

text: str | None = None