solutions_backend.sensors.email

Gmail/provider-neutral history sensor built on Common Reports and Solutions Core.

Classes

Fetch bounded text/images while naming every unsupported attachment explicitly.

prepare(message: EmailMessageRecord) -> tuple[AttachmentEvidence, ...]

Drain exact added-message history and emit normalized classification intakes.

initial_cursor() -> dict[str, object]

read(cursor: SensorCursorState) -> SourceBatch

Finite mailbox search adapter used by explicit historical rebuilds.

for_window(window_start: datetime | None, window_end: datetime | None) -> EmailSearchAdapter

Bind one finite Gmail search to the exact durable rebuild window.

initial_cursor() -> dict[str, object]

read(cursor: SensorCursorState) -> SourceBatch

Bases: RuntimeError

A provider page/history gap forbids durable cursor advancement.