SessionSearchOutcome class final

The outcome of one archive search call.

Constructors

SessionSearchOutcome({required List<SessionSearchHit> hits, required int recordsExamined, required int recordsTotal, required bool truncated, int? nextContinuation, SessionArchiveMap? map, String truncationReason = '', String unavailableReason = '', String sizeNote = ''})
const

Properties

hashCode → int
The hash code for this object.
no setterinherited
hits → List<SessionSearchHit>
final
map → SessionArchiveMap?
Set in map mode.
final
nextContinuation → int?
The continuation token for the next call (records already examined), set whenever truncated is true and the stop was clean (result cap or time budget — both resume deterministically; a scan ERROR may have stopped mid-segment, so no token is offered there).
final
recordsExamined → int
Records this call actually looked at (after the continuation skip).
final
recordsTotal → int
Records the whole file chain holds.
final
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
sizeNote → String
Issue #1882 AC3: one-line heavy-file guard (exact size + the hygiene escapes) set by the host when the session file is over the 500 MB warn bound — the scan itself stays streamed/budgeted, the note makes the cost visible. Empty when the file is small.
final
truncated → bool
True when the call stopped early — hit cap, time budget, or a scan error — and more archive remains.
final
truncationReason → String
Why the scan stopped early (result cap, time budget, …) — empty when it ran to the end.
final
unavailableReason → String
Set when the archive could not be searched AT ALL (e.g. no session file backs the host) — the formatter prints it verbatim instead of rendering a completed-but-empty scan, which would dishonestly claim the archive was searched and holds nothing.
final

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited