SessionSearchQuery class final

A validated, defaulted session_search argument set. Build with SessionSearchQuery.fromArgs — it throws FormatException with a model-readable message for every invalid input (E5: structured error, never a hang and never a bare stack trace).

Constructors

SessionSearchQuery({required SessionSearchMode mode, required SessionSearchScope scope, String query = '', Set<String> kinds = const {}, DateTime? before, DateTime? after, bool regex = false, int maxHits = defaultSessionSearchMaxHits, int continuation = 0})

const

SessionSearchQuery.fromArgs(Map<Object?, Object?> args)

Parses the tool arguments; throws FormatException with a one-line model-readable reason when a value is invalid.

factory

Properties

after → DateTime?

final

before → DateTime?

Keep records strictly older / newer than these instants.

final

continuation → int

Records already examined by earlier calls (the continuation token) — the scan skips them, so a giant session pages deterministically.

final

hashCode → int

The hash code for this object.

no setter, inherited

kinds → Set<String>

Record types to keep (message, compaction, compact_checkpoint, hidden_range, custom, … — the session file's type values). Empty keeps every kind.

final

maxHits → int

final

mode → SessionSearchMode

final

pattern → RegExp?

The compiled matcher, or null in map mode.

no setter

query → String

The search phrase (search mode).

final

regex → bool

Match query as a case-insensitive regular expression instead of a literal keyword.

final

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

scope → SessionSearchScope

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