agrag.evidence.fetch.fetch

fetch(store:GraphStore, evidence_ids:Sequence[str], *, scope:frozenset[str], max_chars:int, timeout:float | None = None) -> list[FetchOutcome]

Return the text of each evidence id, in the order given.

A span id returns the text of its range. Fetch reads the chunks of one chunk set for the content hash in the id, so the range is never assembled from two sets. A range that no chunk covers is cut to the covered part, which is marked partial. Text is never padded. An id that names no readable evidence gives unavailable. A missing id and an id outside the scope give the same outcome. A chunk reference returns the stored text of that chunk.

The status of a version is current when the id's content hash matches the document's current content hash. Updated and deleted versions are superseded; their text is still returned.

Parameters:

• store (GraphStore) – The graph store to read.
• evidence_ids (Sequence[str]) – Evidence ids to fetch.
• scope (frozenset[str]) – Keys of the documents the caller may read. An empty scope makes every id unavailable.
• max_chars (int) – The most characters returned for each id. Must be positive. Longer text is cut and marked truncated.
• timeout (float | None) – Server-side transaction timeout in seconds for each store read. None uses the server's default.

Returns:

• list[FetchOutcome] – One outcome for each id, in the same order.

Raises:

• ValueError – max_chars is not positive.