Skip to content

common_reports

common-reports — domain-agnostic report build + deliver.

Two domains, one package (the agents_core “one package, many domains” shape):

builders/ fluent HtmlBuilder -> immutable Document tree -> Renderer views (email / standalone-interactive / ghost). One canonical tree, many views. emails/ EmailClient: read . monitor . write (SMTP / IMAP / Gmail-DWD).

Law (CONTEXT.md): contracts/ <- schemas/ <- domains/. contracts/ import nothing but stdlib + pydantic. Heavy SDKs (plotly, google-api) are optional extras loaded lazily — so import common_reports is light and never touches the network.

HtmlBuilder/col are eager (pure stdlib contracts). EmailClient and the plotly-backed renderers are lazy (loaded on first attribute access).