import { email } from '@mindstudio-ai/agent';email.send posts one message from your app’s own verified sender; everything else in this namespace is what happens after that send: what reached each recipient, how a campaign performed, and who has unsubscribed. It reads and writes your app’s own outbound mail, scoped to the app by its request token, so you can build an email admin screen inside your own app and never open a dashboard.
messages is the per-recipient delivery log, newest first. It includes mail that never reached the provider (unsubscribed, over the daily cap, sender not allowed), which is where most "it didn’t send" reports actually land. message opens one entry with its bounce diagnostics. stats rolls up counts, rates, and a timeseries over a window; batches and batch do the same per marketing blast. suppressions reads the unsubscribe list; suppress and unsuppress edit it. One caveat the types make explicit: an address can also sit on a platform-wide suppression list from a hard bounce elsewhere, so unsuppress reports whether mail will reach the address rather than assuming it will.