Struct Page 

pub struct Page {
    pub header: String,
    pub body: String,
    pub total_matches: usize,
    pub total_files: usize,
    pub first_index: usize,
    pub last_index: usize,
    pub last_key: Option<(String, u64)>,
    pub has_more: bool,
    pub fingerprint: u64,
}

A rendered page: surface-agnostic header + body, plus the counts and keyset state each caller (CLI / MCP) needs to mint the “next page” cursor and detect a changed result set.

Fields

header: String

body: String

total_matches: usize

total_files: usize

first_index: usize

1-based index of the first/last entry on this page (in matches, or files for -l/-c); 0 when empty.

last_index: usize

last_key: Option<(String, u64)>

Keyset key of the last rendered entry, to seed the next cursor; None when nothing remains.

has_more: bool

fingerprint: u64

Fingerprint of the full result set, for staleness detection across pages.

Implementations

impl Page

pub fn next_cursor( &self, mode: Mode, pattern: String, opts: SearchOptions, page_size: usize, root_hint: Option<String>, ) -> Option<Cursor>

The cursor that fetches the page after this one, or None when this is the last page. Both the CLI and MCP surfaces mint it the same way; root_hint is the only per-surface input (the resolved root for the CLI, None for MCP where the server root is authoritative).

pub fn staleness_note(&self, prev: Option<(usize, u32)>) -> Option<String>

A note for the caller to surface when resuming a cursor whose result set has since changed (fingerprint mismatch), or None. prev is the cursor’s (prev_total, fingerprint); the fingerprint is the low 32 bits, so compare against this page’s truncated to match.