@primitivedotdev/sdk 1.3.0 → 1.4.0

package/dist/{index-X7RsDaVi.d.ts → index-BDjVGtc8.d.ts}

@@ -1,4 +1,4 @@
-import { m as ReceivedEmail } from "./errors-7E9sW9eX.js";
+import { m as ReceivedEmail } from "./errors-DyuAXctD.js";
 
 //#region ../packages/api-core/src/api/core/auth.gen.d.ts
 type AuthToken = string | undefined;
@@ -811,6 +811,18 @@ type Account = {
   id: string;
   email: string;
   plan: string;
+  limits: PlanLimits;
+  /**
+   * Granted org entitlement keys (sorted). A headless caller reads its
+   * capabilities here — e.g. an emailless agent seeing only
+   * ["send_mail", "send_to_known_addresses"] knows it is reply-only.
+   *
+   */
+  entitlements: Array<string>;
+  /**
+   * The managed inbox FQDN to reply as, or null if the org has no managed inbox.
+   */
+  managed_inbox_address: string | null;
   created_at: string;
   onboarding_completed?: boolean;
   onboarding_step?: string | null;
@@ -3834,6 +3846,27 @@ type ListEmailsData = {
      * Filter emails created on or before this timestamp
      */
     date_to?: string;
+    /**
+     * Forward-tail cursor. Returns rows that became visible AFTER this
+     * cursor, oldest-first, so a caller can stream new inbound mail by
+     * re-passing the cursor from each response. Mutually exclusive with
+     * `cursor` (which pages history newest-first). Pass the `meta.cursor`
+     * from the previous `since` response; an empty page means caught up.
+     *
+     */
+    since?: string;
+    /**
+     * Long-poll: hold the request up to this many seconds waiting for new
+     * mail past `since`, returning as soon as any arrives (or an empty
+     * page when the wait elapses). Requires `since`. Omitted means no wait
+     * (returns immediately); the server treats an absent value as 0. NOT
+     * given an OpenAPI `default` on purpose: a default makes some
+     * generators (e.g. openapi-python-client) send `wait=0` on every call,
+     * which then fails the `wait` requires `since` check for plain history
+     * listings.
+     *
+     */
+    wait?: number;
   };
   url: '/emails';
 };
@@ -6247,10 +6280,12 @@ declare const listFunctions: <ThrowOnError extends boolean = false>(options?: Op
  * each delivery and forwards the `Primitive-Signature` header to
  * the handler. Verify the raw request body with
  * `PRIMITIVE_WEBHOOK_SECRET` before parsing JSON; after verification
- * the request body parses to an `email.received` event (see
- * `EmailReceivedEvent` and the Webhook payload section for the full
- * schema). Code is bundled before being uploaded; ship a single
- * self-contained file rather than relying on external imports.
+ * the request body parses to a webhook event whose `event` field is
+ * `email.received` for normal inbound mail, or a machine-mail type
+ * (`email.bounced`, `email.tls_report`, `email.dmarc_report`,
+ * `email.dmarc_failure`) for bounces and reports. Code is bundled
+ * before being uploaded; ship a single self-contained file rather
+ * than relying on external imports.
  *
  * **Code limits.** `code` is capped at 1 MiB UTF-8. `sourceMap`
  * (optional) is capped at 5 MiB UTF-8, stored with each deployment
@@ -6661,6 +6696,12 @@ interface ForwardInput {
 interface SendResult {
   id: string;
   status: SendMailResult["status"];
+  /**
+   * The bare from-address actually written on the wire. Load-bearing on the
+   * server-derived reply path, where `from` is derived from the inbound rather
+   * than anything the caller passed.
+   */
+  from: string;
   queueId: string | null;
   accepted: string[];
   rejected: string[];
@@ -6727,9 +6768,86 @@ declare class AgentResource {
    */
   claimLink(input?: CreateAgentClaimLinkInput, options?: RequestOptions): Promise<AgentClaimLinkResult>;
 }
+/**
+ * One inbound email from the forward tail, plus the cursor positioned just
+ * after it and a bound `reply()`. Persist `cursor` after processing to resume
+ * the stream exactly where you left off; the stream advances one email at a
+ * time, so the cursor is per-email exact.
+ */
+interface InboundEmail {
+  id: string;
+  messageId: string | null;
+  /** SMTP envelope sender (return-path) of the inbound mail. */
+  from: string;
+  to: string;
+  subject: string | null;
+  status: EmailStatus;
+  domain: string;
+  spamScore: number | null;
+  threadId: string | null;
+  createdAt: string;
+  receivedAt: string;
+  /** Forward-tail cursor positioned just after this email (persist to resume). */
+  cursor: string;
+  /** Reply to this email. Reply-only agents may reply to senders that mailed them. */
+  reply(input: ReplyInput, options?: RequestOptions): Promise<SendResult>;
+}
+interface InboxStreamOptions {
+  /** Resume cursor. Omit to stream from the beginning (oldest-first) then tail. */
+  since?: string;
+  /** Per-request long-poll hold in seconds (1-30). Default 30. */
+  waitSeconds?: number;
+  /** Stop the stream when this fires. */
+  signal?: AbortSignal;
+}
+interface WaitForNextOptions {
+  since?: string;
+  waitSeconds?: number;
+  signal?: AbortSignal;
+}
+/**
+ * Inbound mail, grouped under `client.inbox`. Wraps the GET /v1/emails forward
+ * tail (`?since` + `?wait` long-poll) so an agent's receive loop is a single
+ * `for await`, with the cursor advanced for you.
+ */
+declare class InboxResource {
+  private readonly client;
+  constructor(client: PrimitiveApiClient["client"]);
+  /**
+   * Stream inbound emails as they arrive. Long-polls the forward tail, yielding
+   * one email at a time and advancing the cursor. Resumes from `since` (omit to
+   * start oldest-first); stops when `signal` aborts.
+   *
+   *   for await (const email of client.inbox.stream()) {
+   *     await email.reply("got it");
+   *   }
+   */
+  stream(options?: InboxStreamOptions): AsyncGenerator<InboundEmail, void, void>;
+  /**
+   * Resolve with the next inbound email after `since`, or null if none arrives
+   * within the wait window. One-shot form of `stream`; pass your current cursor
+   * as `since` to wait for genuinely new mail.
+   */
+  waitForNext(options?: WaitForNextOptions): Promise<InboundEmail | null>;
+}
+/** Account introspection, grouped under `client.account`. */
+declare class AccountResource {
+  private readonly client;
+  constructor(client: PrimitiveApiClient["client"]);
+  /**
+   * The authenticated account: plan, limits, granted `entitlements` (e.g. an
+   * emailless agent sees only reply-only keys), and `managed_inbox_address`
+   * (the From address to reply as).
+   */
+  get(options?: RequestOptions): Promise<Account>;
+}
 declare class PrimitiveClient extends PrimitiveApiClient {
   /** Agent-account lifecycle operations (create, claim/upgrade). */
   readonly agent: AgentResource;
+  /** Inbound mail: long-poll stream + waitForNext over the forward tail. */
+  readonly inbox: InboxResource;
+  /** Account introspection (plan, limits, entitlements, managed inbox). */
+  readonly account: AccountResource;
   send(input: SendInput, options?: RequestOptions): Promise<SendResult>;
   /**
    * Semantic / hybrid / keyword search across received and sent mail.
@@ -6762,5 +6880,26 @@ declare class PrimitiveClient extends PrimitiveApiClient {
 }
 declare function createPrimitiveClient(options?: PrimitiveClientOptions): PrimitiveClient;
 declare function client(options?: PrimitiveClientOptions): PrimitiveClient;
+interface CreateAgentOptions extends CreateAgentAccountInput {
+  /** Base URL + transport overrides for the returned client. */
+  client?: PrimitiveClientOptions;
+}
+interface CreatedAgent {
+  /** A PrimitiveClient already authenticated with the new agent's API key. */
+  client: PrimitiveClient;
+  /** The provisioned managed inbox FQDN (the address to receive + reply as). */
+  address: string | null;
+  /** The raw create-account result (api_key shown once, org_id, plan, limits). */
+  account: AgentAccountResult;
+}
+/**
+ * Zero-to-receiving in one call: create an emailless agent account (no auth)
+ * and return a PrimitiveClient already wired with its one-time API key, plus
+ * the provisioned managed inbox. From here `result.client.inbox.stream()` and
+ * `result.client.send(...)` work immediately.
+ *
+ *   const { client, address } = await createAgent({ terms_accepted: true });
+ */
+declare function createAgent(options: CreateAgentOptions): Promise<CreatedAgent>;
 //#endregion
-export { getThread as $, InboxStatusFunctionSummary as $a, StorageStats as $c, GetEmailResponses as $i, VerifyAgentClaimError as $l, Cursor as $n, PollCliLoginError as $o, DownloadRawEmailError as $r, SemanticSearchScoreBreakdown as $s, AgentSignupResendResult as $t, createFunction as A, GetSentEmailData as Aa, StartAgentClaimError as Ac, FunctionTestRunDeliveryEndpoint as Ai, UpdateDomainInput as Al, CreateEndpointErrors as An, ListFunctionLogsError as Ao, DeliveryStatus as Ar, ResendCliSignupVerificationResponse as As, updateAccount as At, ResponseStyle as Au, downloadDomainZoneFile as B, GetThreadData as Ba, StartAgentSignupResponses as Bc, GetAccountError as Bi, UpdateFilterError as Bl, CreateFunctionData as Bn, ListFunctionsError as Bo, DomainDnsRecord as Br, SearchEmailsError as Bs, AccountUpdated as Bt, createPrimitiveApiClient as C, GetOrgRoutingTopologyResponse as Ca, SetFunctionSecretData as Cc, FunctionRouteBody as Ci, UpdateAccountErrors as Cl, CreateAgentClaimLinkError as Cn, ListEnvelope as Co, DeleteFunctionResponse as Cr, ResendAgentSignupVerificationInput as Cs, startAgentClaim as Ct, Client as Cu, createAgentClaimLink as D, GetSendPermissionsErrors as Da, SetFunctionSecretResponse as Dc, FunctionSecretWriteResult as Di, UpdateDomainData as Dl, CreateAgentClaimLinkResponses as Dn, ListFiltersResponse as Do, DeleteFunctionSecretErrors as Dr, ResendCliSignupVerificationError as Ds, testEndpoint as Dt, Options$1 as Du, createAgentAccount as E, GetSendPermissionsError as Ea, SetFunctionSecretInput as Ec, FunctionSecretListItem as Ei, UpdateAccountResponses as El, CreateAgentClaimLinkResponse as En, ListFiltersErrors as Eo, DeleteFunctionSecretError as Er, ResendCliSignupVerificationData as Es, startCliSignup as Et, CreateClientConfig as Eu, deleteFilter as F, GetStorageStatsData as Fa, StartAgentSignupData as Fc, FunctionTestRunState as Fi, UpdateEndpointErrors as Fl, CreateFilterError as Fn, ListFunctionSecretsError as Fo, DiscardEmailContentErrors as Fr, RotateWebhookSecretErrors as Fs, verifyAgentClaim as Ft, getFunction as G, GetWebhookSecretData as Ga, StartCliLoginResponse as Gc, GetConversationError as Gi, UpdateFunctionData as Gl, CreateFunctionResponses as Gn, ListSentEmailsError as Go, DownloadAttachmentsResponse as Gr, SemanticSearchData as Gs, AddDomainResponse as Gt, getAccount as H, GetThreadErrors as Ha, StartCliLoginError as Hc, GetAccountResponse as Hi, UpdateFilterInput as Hl, CreateFunctionErrors as Hn, ListFunctionsResponse as Ho, DownloadAttachmentsData as Hr, SearchEmailsResponse as Hs, AddDomainError as Ht, deleteFunction as I, GetStorageStatsError as Ia, StartAgentSignupError as Ic, FunctionTestRunTrace as Ii, UpdateEndpointInput as Il, CreateFilterErrors as In, ListFunctionSecretsErrors as Io, DiscardEmailContentResponse as Ir, RotateWebhookSecretResponse as Is, verifyAgentSignup as It, getInboxStatus as J, GetWebhookSecretResponse as Ja, StartCliSignupError as Jc, GetConversationResponses as Ji, UpdateFunctionInput as Jl, CreateFunctionSecretError as Jn, ListSentEmailsResponses as Jo, DownloadDomainZoneFileError as Jr, SemanticSearchField as Js, AgentAccountUpgradeHint as Jt, getFunctionRouting as K, GetWebhookSecretError as Ka, StartCliLoginResponses as Kc, GetConversationErrors as Ki, UpdateFunctionError as Kl, CreateFunctionResult as Kn, ListSentEmailsErrors as Ko, DownloadAttachmentsResponses as Kr, SemanticSearchError as Ks, AddDomainResponses as Kt, deleteFunctionSecret as L, GetStorageStatsErrors as La, StartAgentSignupErrors as Lc, GateDenial as Li, UpdateEndpointResponse as Ll, CreateFilterInput as Ln, ListFunctionSecretsResponse as Lo, DiscardEmailContentResponses as Lr, RotateWebhookSecretResponses as Ls, verifyCliSignup as Lt, deleteDomain as M, GetSentEmailErrors as Ma, StartAgentClaimInput as Mc, FunctionTestRunOutboundRequest as Mi, UpdateDomainResponses as Ml, CreateEndpointResponse as Mn, ListFunctionLogsResponse as Mo, DiscardContentResult as Mr, ResourceId as Ms, updateEndpoint as Mt, Auth as Mu, deleteEmail as N, GetSentEmailResponse as Na, StartAgentClaimResponse as Nc, FunctionTestRunReply as Ni, UpdateEndpointData as Nl, CreateEndpointResponses as Nn, ListFunctionLogsResponses as No, DiscardEmailContentData as Nr, RotateWebhookSecretData as Ns, updateFilter as Nt, createEndpoint as O, GetSendPermissionsResponse as Oa, SetFunctionSecretResponses as Oc, FunctionTestRun as Oi, UpdateDomainError as Ol, CreateEndpointData as On, ListFiltersResponses as Oo, DeleteFunctionSecretResponse as Or, ResendCliSignupVerificationErrors as Os, testFunction as Ot, RequestOptions$2 as Ou, deleteEndpoint as P, GetSentEmailResponses as Pa, StartAgentClaimResponses as Pc, FunctionTestRunSend as Pi, UpdateEndpointError as Pl, CreateFilterData as Pn, ListFunctionSecretsData as Po, DiscardEmailContentError as Pr, RotateWebhookSecretError as Ps, updateFunction as Pt, getStorageStats as Q, InboxStatusEndpointSummary as Qa, StartCliSignupResponses as Qc, GetEmailResponse as Qi, VerifyAgentClaimData as Ql, CreateFunctionSecretResponses as Qn, PollCliLoginData as Qo, DownloadRawEmailData as Qr, SemanticSearchResult as Qs, AgentOrgRef as Qt, discardEmailContent as R, GetStorageStatsResponse as Ra, StartAgentSignupInput as Rc, GateFix as Ri, UpdateEndpointResponses as Rl, CreateFilterResponse as Rn, ListFunctionSecretsResponses as Ro, DkimSignature as Rr, RoutingTopology as Rs, verifyDomain as Rt, RequestOptions$1 as S, GetOrgRoutingTopologyErrors as Sa, SetFunctionRouteResponses as Sc, FunctionLogRow as Si, UpdateAccountError as Sl, CreateAgentClaimLinkData as Sn, ListEndpointsResponses as So, DeleteFunctionErrors as Sr, ResendAgentSignupVerificationErrors as Ss, setFunctionSecret as St, createClient as Su, cliLogout as T, GetSendPermissionsData as Ta, SetFunctionSecretErrors as Tc, FunctionRouting as Ti, UpdateAccountResponse as Tl, CreateAgentClaimLinkInput as Tn, ListFiltersError as To, DeleteFunctionSecretData as Tr, ResendAgentSignupVerificationResponses as Ts, startCliLogin as Tt, Config as Tu, getConversation as U, GetThreadResponse as Ua, StartCliLoginErrors as Uc, GetAccountResponses as Ui, UpdateFilterResponse as Ul, CreateFunctionInput as Un, ListFunctionsResponses as Uo, DownloadAttachmentsError as Ur, SearchEmailsResponses as Us, AddDomainErrors as Ut, downloadRawEmail as V, GetThreadError as Va, StartCliLoginData as Vc, GetAccountErrors as Vi, UpdateFilterErrors as Vl, CreateFunctionError as Vn, ListFunctionsErrors as Vo, DomainVerifyResult as Vr, SearchEmailsErrors as Vs, AddDomainData as Vt, getEmail as W, GetThreadResponses as Wa, StartCliLoginInput as Wc, GetConversationData as Wi, UpdateFilterResponses as Wl, CreateFunctionResponse as Wn, ListSentEmailsData as Wo, DownloadAttachmentsErrors as Wr, SemanticSearchCoverage as Ws, AddDomainInput as Wt, getSendPermissions as X, InboxStatus as Xa, StartCliSignupInput as Xc, GetEmailError as Xi, UpdateFunctionResponses as Xl, CreateFunctionSecretInput as Xn, ParsedEmailData as Xo, DownloadDomainZoneFileResponse as Xr, SemanticSearchMeta as Xs, AgentClaimResult as Xt, getOrgRoutingTopology as Y, GetWebhookSecretResponses as Ya, StartCliSignupErrors as Yc, GetEmailData as Yi, UpdateFunctionResponse as Yl, CreateFunctionSecretErrors as Yn, PaginationMeta as Yo, DownloadDomainZoneFileErrors as Yr, SemanticSearchInput as Ys, AgentClaimLinkResult as Yt, getSentEmail as Z, InboxStatusDomain as Za, StartCliSignupResponse as Zc, GetEmailErrors as Zi, VerifiedDomain as Zl, CreateFunctionSecretResponse as Zn, PlanLimits as Zo, DownloadDomainZoneFileResponses as Zr, SemanticSearchResponses as Zs, AgentClaimStartResult as Zt, DEFAULT_API_BASE_URL as _, GetInboxStatusErrors as _a, SentEmailSummary as _c, ErrorResponse as _i, UnsetFunctionRouteErrors as _l, CreateAgentAccountError as _n, ListEmailsResponses as _o, DeleteFilterErrors as _r, ReplyToEmailErrors as _s, sdk_gen_d_exports as _t, VerifyDomainError as _u, ReplyInput as a, GetFunctionRoutingData as aa, SendEmailResponses as ac, EmailAuth as ai, TestEndpointResponses as al, CliLogoutError as an, ListDeliveriesErrors as ao, DeleteEmailData as ar, ReplayDeliveryError as as, listFilters as at, VerifyAgentSignupError as au, PrimitiveApiError as b, GetOrgRoutingTopologyData as ba, SetFunctionRouteErrors as bc, FunctionDetail as bi, UnverifiedDomain as bl, CreateAgentAccountResponse as bn, ListEndpointsErrors as bo, DeleteFunctionData as br, ResendAgentSignupVerificationData as bs, sendEmail as bt, VerifyDomainResponses as bu, SendAttachment as c, GetFunctionRoutingResponse as ca, SendMailResult as cc, EmailSearchFacetBucket as ci, TestFunctionErrors as cl, CliLogoutResponse as cn, ListDomainsData as co, DeleteEmailResponse as cr, ReplayDeliveryResponses as cs, listFunctions as ct, VerifyAgentSignupResponse as cu, SendThreadInput as d, GetFunctionTestRunTraceError as da, SendPermissionManagedZone as dc, EmailSearchMeta as di, TestInvocationResult as dl, CliSignupResendResult as dn, ListDomainsResponse as do, DeleteEndpointError as dr, ReplayEmailWebhooksErrors as ds, replayDelivery as dt, VerifyCliSignupError as du, GetFunctionData as ea, SemanticSearchSnippet as ec, DownloadRawEmailErrors as ei, SuccessEnvelope as el, AgentSignupStartResult as en, InboxStatusNextAction as eo, DeleteDomainData as er, PollCliLoginErrors as es, getWebhookSecret as et, VerifyAgentClaimErrors as eu, client as f, GetFunctionTestRunTraceErrors as fa, SendPermissionRule as fc, EmailSearchResult as fi, TestResult as fl, CliSignupStartResult as fn, ListDomainsResponses as fo, DeleteEndpointErrors as fr, ReplayEmailWebhooksResponse as fs, replayEmailWebhooks as ft, VerifyCliSignupErrors as fu, verifyWebhookSignature as g, GetInboxStatusError as ga, SentEmailStatus as gc, Endpoint as gi, UnsetFunctionRouteError as gl, CreateAgentAccountData as gn, ListEmailsResponse as go, DeleteFilterError as gr, ReplyToEmailError as gs, rotateWebhookSecret as gt, VerifyDomainData as gu, VerifyOptions as h, GetInboxStatusData as ha, SentEmailDetail as hc, EmailWebhookStatus as hi, UnsetFunctionRouteData as hl, ConversationMessage as hn, ListEmailsErrors as ho, DeleteFilterData as hr, ReplyToEmailData as hs, resendCliSignupVerification as ht, VerifyCliSignupResponses as hu, PrimitiveClientOptions as i, GetFunctionResponses as ia, SendEmailResponse as ic, EmailAttachment as ii, TestEndpointResponse as il, CliLogoutData as in, ListDeliveriesError as io, DeleteDomainResponses as ir, ReplayDeliveryData as is, listEndpoints as it, VerifyAgentSignupData as iu, createFunctionSecret as j, GetSentEmailError as ja, StartAgentClaimErrors as jc, FunctionTestRunInboundEmail as ji, UpdateDomainResponse as jl, CreateEndpointInput as jn, ListFunctionLogsErrors as jo, DeliverySummary as jr, ResendCliSignupVerificationResponses as js, updateDomain as jt, createConfig as ju, createFilter as k, GetSendPermissionsResponses as ka, StartAgentClaimData as kc, FunctionTestRunDelivery as ki, UpdateDomainErrors as kl, CreateEndpointError as kn, ListFunctionLogsData as ko, DeleteFunctionSecretResponses as kr, ResendCliSignupVerificationInput as ks, unsetFunctionRoute as kt, RequestResult as ku, SendInput as l, GetFunctionRoutingResponses as la, SendPermissionAddress as lc, EmailSearchFacets as li, TestFunctionResponse as ll, CliLogoutResponses as ln, ListDomainsError as lo, DeleteEmailResponses as lr, ReplayEmailWebhooksData as ls, listSentEmails as lt, VerifyAgentSignupResponses as lu, PRIMITIVE_SIGNATURE_HEADER as m, GetFunctionTestRunTraceResponses as ma, SendPermissionsMeta as mc, EmailSummary as mi, ThreadMessage as ml, Conversation as mn, ListEmailsError as mo, DeleteEndpointResponses as mr, ReplayResult as ms, resendAgentSignupVerification as mt, VerifyCliSignupResponse as mu, ForwardInput as n, GetFunctionErrors as na, SendEmailError as nc, DownloadRawEmailResponses as ni, TestEndpointError as nl, CliLoginPollResult as nn, Limit as no, DeleteDomainErrors as nr, PollCliLoginResponse as ns, listDomains as nt, VerifyAgentClaimResponse as nu, RequestOptions as o, GetFunctionRoutingError as oa, SendMailAttachment as oc, EmailDetail as oi, TestFunctionData as ol, CliLogoutErrors as on, ListDeliveriesResponse as oo, DeleteEmailError as or, ReplayDeliveryErrors as os, listFunctionLogs as ot, VerifyAgentSignupErrors as ou, createPrimitiveClient as p, GetFunctionTestRunTraceResponse as pa, SendPermissionYourDomain as pc, EmailStatus as pi, Thread as pl, CliSignupVerifyResult as pn, ListEmailsData as po, DeleteEndpointResponse as pr, ReplayEmailWebhooksResponses as ps, replyToEmail as pt, VerifyCliSignupInput as pu, getFunctionTestRunTrace as q, GetWebhookSecretErrors as qa, StartCliSignupData as qc, GetConversationResponse as qi, UpdateFunctionErrors as ql, CreateFunctionSecretData as qn, ListSentEmailsResponse as qo, DownloadDomainZoneFileData as qr, SemanticSearchErrors as qs, AgentAccountResult as qt, PrimitiveClient as r, GetFunctionResponse as ra, SendEmailErrors as rc, EmailAddress as ri, TestEndpointErrors as rl, CliLoginStartResult as rn, ListDeliveriesData as ro, DeleteDomainResponse as rr, PollCliLoginResponses as rs, listEmails as rt, VerifyAgentClaimResponses as ru, SemanticSearchResponse as s, GetFunctionRoutingErrors as sa, SendMailInput as sc, EmailDetailReply as si, TestFunctionError as sl, CliLogoutInput as sn, ListDeliveriesResponses as so, DeleteEmailErrors as sr, ReplayDeliveryResponse as ss, listFunctionSecrets as st, VerifyAgentSignupInput as su, AgentResource as t, GetFunctionError as ta, SendEmailData as tc, DownloadRawEmailResponse as ti, TestEndpointData as tl, AgentSignupVerifyResult as tn, InboxStatusRecentEmailSummary as to, DeleteDomainError as tr, PollCliLoginInput as ts, listDeliveries as tt, VerifyAgentClaimInput as tu, SendResult as u, GetFunctionTestRunTraceData as ua, SendPermissionAnyRecipient as uc, EmailSearchHighlights as ui, TestFunctionResponses as ul, CliLogoutResult as un, ListDomainsErrors as uo, DeleteEndpointData as ur, ReplayEmailWebhooksError as us, pollCliLogin as ut, VerifyCliSignupData as uu, PrimitiveApiClient as v, GetInboxStatusResponse as va, SetFunctionRouteData as vc, Filter as vi, UnsetFunctionRouteResponse as vl, CreateAgentAccountErrors as vn, ListEndpointsData as vo, DeleteFilterResponse as vr, ReplyToEmailResponse as vs, searchEmails as vt, VerifyDomainErrors as vu, addDomain as w, GetOrgRoutingTopologyResponses as wa, SetFunctionSecretError as wc, FunctionRouteResult as wi, UpdateAccountInput as wl, CreateAgentClaimLinkErrors as wn, ListFiltersData as wo, DeleteFunctionResponses as wr, ResendAgentSignupVerificationResponse as ws, startAgentSignup as wt, ClientOptions as wu, PrimitiveApiErrorDetails as x, GetOrgRoutingTopologyError as xa, SetFunctionRouteResponse as xc, FunctionListItem as xi, UpdateAccountData as xl, CreateAgentAccountResponses as xn, ListEndpointsResponse as xo, DeleteFunctionError as xr, ResendAgentSignupVerificationError as xs, setFunctionRoute as xt, WebhookSecret as xu, PrimitiveApiClientOptions as y, GetInboxStatusResponses as ya, SetFunctionRouteError as yc, FunctionDeployStatus as yi, UnsetFunctionRouteResponses as yl, CreateAgentAccountInput as yn, ListEndpointsError as yo, DeleteFilterResponses as yr, ReplyToEmailResponses as ys, semanticSearch as yt, VerifyDomainResponse as yu, downloadAttachments as z, GetStorageStatsResponses as za, StartAgentSignupResponse as zc, GetAccountData as zi, UpdateFilterData as zl, CreateFilterResponses as zn, ListFunctionsData as zo, Domain as zr, SearchEmailsData as zs, Account as zt };
+export { getFunction as $, GetWebhookSecretData as $a, StartCliLoginResponse as $c, GetConversationError as $i, UpdateFunctionData as $l, CreateFunctionResponses as $n, ListSentEmailsError as $o, DownloadAttachmentsResponse as $r, SemanticSearchData as $s, AddDomainResponse as $t, RequestOptions$1 as A, GetOrgRoutingTopologyErrors as Aa, SetFunctionRouteResponses as Ac, FunctionLogRow as Ai, UpdateAccountError as Al, CreateAgentClaimLinkData as An, ListEndpointsResponses as Ao, DeleteFunctionErrors as Ar, ResendAgentSignupVerificationErrors as As, setFunctionSecret as At, createClient as Au, deleteDomain as B, GetSentEmailErrors as Ba, StartAgentClaimInput as Bc, FunctionTestRunOutboundRequest as Bi, UpdateDomainResponses as Bl, CreateEndpointResponse as Bn, ListFunctionLogsResponse as Bo, DiscardContentResult as Br, ResourceId as Bs, updateEndpoint as Bt, Auth as Bu, VerifyOptions as C, GetInboxStatusData as Ca, SentEmailDetail as Cc, EmailWebhookStatus as Ci, UnsetFunctionRouteData as Cl, ConversationMessage as Cn, ListEmailsErrors as Co, DeleteFilterData as Cr, ReplyToEmailData as Cs, resendCliSignupVerification as Ct, VerifyCliSignupResponses as Cu, PrimitiveApiClientOptions as D, GetInboxStatusResponses as Da, SetFunctionRouteError as Dc, FunctionDeployStatus as Di, UnsetFunctionRouteResponses as Dl, CreateAgentAccountInput as Dn, ListEndpointsError as Do, DeleteFilterResponses as Dr, ReplyToEmailResponses as Ds, semanticSearch as Dt, VerifyDomainResponse as Du, PrimitiveApiClient as E, GetInboxStatusResponse as Ea, SetFunctionRouteData as Ec, Filter as Ei, UnsetFunctionRouteResponse as El, CreateAgentAccountErrors as En, ListEndpointsData as Eo, DeleteFilterResponse as Er, ReplyToEmailResponse as Es, searchEmails as Et, VerifyDomainErrors as Eu, createAgentClaimLink as F, GetSendPermissionsErrors as Fa, SetFunctionSecretResponse as Fc, FunctionSecretWriteResult as Fi, UpdateDomainData as Fl, CreateAgentClaimLinkResponses as Fn, ListFiltersResponse as Fo, DeleteFunctionSecretErrors as Fr, ResendCliSignupVerificationError as Fs, testEndpoint as Ft, Options$1 as Fu, deleteFunctionSecret as G, GetStorageStatsErrors as Ga, StartAgentSignupErrors as Gc, GateDenial as Gi, UpdateEndpointResponse as Gl, CreateFilterInput as Gn, ListFunctionSecretsResponse as Go, DiscardEmailContentResponses as Gr, RotateWebhookSecretResponses as Gs, verifyCliSignup as Gt, deleteEndpoint as H, GetSentEmailResponses as Ha, StartAgentClaimResponses as Hc, FunctionTestRunSend as Hi, UpdateEndpointError as Hl, CreateFilterData as Hn, ListFunctionSecretsData as Ho, DiscardEmailContentError as Hr, RotateWebhookSecretError as Hs, updateFunction as Ht, createEndpoint as I, GetSendPermissionsResponse as Ia, SetFunctionSecretResponses as Ic, FunctionTestRun as Ii, UpdateDomainError as Il, CreateEndpointData as In, ListFiltersResponses as Io, DeleteFunctionSecretResponse as Ir, ResendCliSignupVerificationErrors as Is, testFunction as It, RequestOptions$2 as Iu, downloadDomainZoneFile as J, GetThreadData as Ja, StartAgentSignupResponses as Jc, GetAccountError as Ji, UpdateFilterError as Jl, CreateFunctionData as Jn, ListFunctionsError as Jo, DomainDnsRecord as Jr, SearchEmailsError as Js, AccountUpdated as Jt, discardEmailContent as K, GetStorageStatsResponse as Ka, StartAgentSignupInput as Kc, GateFix as Ki, UpdateEndpointResponses as Kl, CreateFilterResponse as Kn, ListFunctionSecretsResponses as Ko, DkimSignature as Kr, RoutingTopology as Ks, verifyDomain as Kt, createFilter as L, GetSendPermissionsResponses as La, StartAgentClaimData as Lc, FunctionTestRunDelivery as Li, UpdateDomainErrors as Ll, CreateEndpointError as Ln, ListFunctionLogsData as Lo, DeleteFunctionSecretResponses as Lr, ResendCliSignupVerificationInput as Ls, unsetFunctionRoute as Lt, RequestResult as Lu, addDomain as M, GetOrgRoutingTopologyResponses as Ma, SetFunctionSecretError as Mc, FunctionRouteResult as Mi, UpdateAccountInput as Ml, CreateAgentClaimLinkErrors as Mn, ListFiltersData as Mo, DeleteFunctionResponses as Mr, ResendAgentSignupVerificationResponse as Ms, startAgentSignup as Mt, ClientOptions as Mu, cliLogout as N, GetSendPermissionsData as Na, SetFunctionSecretErrors as Nc, FunctionRouting as Ni, UpdateAccountResponse as Nl, CreateAgentClaimLinkInput as Nn, ListFiltersError as No, DeleteFunctionSecretData as Nr, ResendAgentSignupVerificationResponses as Ns, startCliLogin as Nt, Config as Nu, PrimitiveApiError as O, GetOrgRoutingTopologyData as Oa, SetFunctionRouteErrors as Oc, FunctionDetail as Oi, UnverifiedDomain as Ol, CreateAgentAccountResponse as On, ListEndpointsErrors as Oo, DeleteFunctionData as Or, ResendAgentSignupVerificationData as Os, sendEmail as Ot, VerifyDomainResponses as Ou, createAgentAccount as P, GetSendPermissionsError as Pa, SetFunctionSecretInput as Pc, FunctionSecretListItem as Pi, UpdateAccountResponses as Pl, CreateAgentClaimLinkResponse as Pn, ListFiltersErrors as Po, DeleteFunctionSecretError as Pr, ResendCliSignupVerificationData as Ps, startCliSignup as Pt, CreateClientConfig as Pu, getEmail as Q, GetThreadResponses as Qa, StartCliLoginInput as Qc, GetConversationData as Qi, UpdateFilterResponses as Ql, CreateFunctionResponse as Qn, ListSentEmailsData as Qo, DownloadAttachmentsErrors as Qr, SemanticSearchCoverage as Qs, AddDomainInput as Qt, createFunction as R, GetSentEmailData as Ra, StartAgentClaimError as Rc, FunctionTestRunDeliveryEndpoint as Ri, UpdateDomainInput as Rl, CreateEndpointErrors as Rn, ListFunctionLogsError as Ro, DeliveryStatus as Rr, ResendCliSignupVerificationResponse as Rs, updateAccount as Rt, ResponseStyle as Ru, PRIMITIVE_SIGNATURE_HEADER as S, GetFunctionTestRunTraceResponses as Sa, SendPermissionsMeta as Sc, EmailSummary as Si, ThreadMessage as Sl, Conversation as Sn, ListEmailsError as So, DeleteEndpointResponses as Sr, ReplayResult as Ss, resendAgentSignupVerification as St, VerifyCliSignupResponse as Su, DEFAULT_API_BASE_URL as T, GetInboxStatusErrors as Ta, SentEmailSummary as Tc, ErrorResponse as Ti, UnsetFunctionRouteErrors as Tl, CreateAgentAccountError as Tn, ListEmailsResponses as To, DeleteFilterErrors as Tr, ReplyToEmailErrors as Ts, sdk_gen_d_exports as Tt, VerifyDomainError as Tu, deleteFilter as U, GetStorageStatsData as Ua, StartAgentSignupData as Uc, FunctionTestRunState as Ui, UpdateEndpointErrors as Ul, CreateFilterError as Un, ListFunctionSecretsError as Uo, DiscardEmailContentErrors as Ur, RotateWebhookSecretErrors as Us, verifyAgentClaim as Ut, deleteEmail as V, GetSentEmailResponse as Va, StartAgentClaimResponse as Vc, FunctionTestRunReply as Vi, UpdateEndpointData as Vl, CreateEndpointResponses as Vn, ListFunctionLogsResponses as Vo, DiscardEmailContentData as Vr, RotateWebhookSecretData as Vs, updateFilter as Vt, deleteFunction as W, GetStorageStatsError as Wa, StartAgentSignupError as Wc, FunctionTestRunTrace as Wi, UpdateEndpointInput as Wl, CreateFilterErrors as Wn, ListFunctionSecretsErrors as Wo, DiscardEmailContentResponse as Wr, RotateWebhookSecretResponse as Ws, verifyAgentSignup as Wt, getAccount as X, GetThreadErrors as Xa, StartCliLoginError as Xc, GetAccountResponse as Xi, UpdateFilterInput as Xl, CreateFunctionErrors as Xn, ListFunctionsResponse as Xo, DownloadAttachmentsData as Xr, SearchEmailsResponse as Xs, AddDomainError as Xt, downloadRawEmail as Y, GetThreadError as Ya, StartCliLoginData as Yc, GetAccountErrors as Yi, UpdateFilterErrors as Yl, CreateFunctionError as Yn, ListFunctionsErrors as Yo, DomainVerifyResult as Yr, SearchEmailsErrors as Ys, AddDomainData as Yt, getConversation as Z, GetThreadResponse as Za, StartCliLoginErrors as Zc, GetAccountResponses as Zi, UpdateFilterResponse as Zl, CreateFunctionInput as Zn, ListFunctionsResponses as Zo, DownloadAttachmentsError as Zr, SearchEmailsResponses as Zs, AddDomainErrors as Zt, SendThreadInput as _, GetFunctionRoutingResponses as _a, SendPermissionAddress as _c, EmailSearchFacets as _i, TestFunctionResponse as _l, CliLogoutResponses as _n, ListDomainsError as _o, DeleteEmailResponses as _r, ReplayEmailWebhooksData as _s, listSentEmails as _t, VerifyAgentSignupResponses as _u, ForwardInput as a, GetEmailErrors as aa, SemanticSearchResponses as ac, DownloadDomainZoneFileResponses as ai, StartCliSignupResponse as al, AgentClaimStartResult as an, InboxStatusDomain as ao, CreateFunctionSecretResponse as ar, PlanLimits as as, getSentEmail as at, VerifiedDomain as au, createAgent as b, GetFunctionTestRunTraceErrors as ba, SendPermissionRule as bc, EmailSearchResult as bi, TestResult as bl, CliSignupStartResult as bn, ListDomainsResponses as bo, DeleteEndpointErrors as br, ReplayEmailWebhooksResponse as bs, replayEmailWebhooks as bt, VerifyCliSignupErrors as bu, InboxStreamOptions as c, GetFunctionData as ca, SemanticSearchSnippet as cc, DownloadRawEmailErrors as ci, SuccessEnvelope as cl, AgentSignupStartResult as cn, InboxStatusNextAction as co, DeleteDomainData as cr, PollCliLoginErrors as cs, getWebhookSecret as ct, VerifyAgentClaimErrors as cu, ReplyInput as d, GetFunctionResponse as da, SendEmailErrors as dc, EmailAddress as di, TestEndpointErrors as dl, CliLoginStartResult as dn, ListDeliveriesData as do, DeleteDomainResponse as dr, PollCliLoginResponses as ds, listEmails as dt, VerifyAgentClaimResponses as du, GetConversationErrors as ea, SemanticSearchError as ec, DownloadAttachmentsResponses as ei, StartCliLoginResponses as el, AddDomainResponses as en, GetWebhookSecretError as eo, CreateFunctionResult as er, ListSentEmailsErrors as es, getFunctionRouting as et, UpdateFunctionError as eu, RequestOptions as f, GetFunctionResponses as fa, SendEmailResponse as fc, EmailAttachment as fi, TestEndpointResponse as fl, CliLogoutData as fn, ListDeliveriesError as fo, DeleteDomainResponses as fr, ReplayDeliveryData as fs, listEndpoints as ft, VerifyAgentSignupData as fu, SendResult as g, GetFunctionRoutingResponse as ga, SendMailResult as gc, EmailSearchFacetBucket as gi, TestFunctionErrors as gl, CliLogoutResponse as gn, ListDomainsData as go, DeleteEmailResponse as gr, ReplayDeliveryResponses as gs, listFunctions as gt, VerifyAgentSignupResponse as gu, SendInput as h, GetFunctionRoutingErrors as ha, SendMailInput as hc, EmailDetailReply as hi, TestFunctionError as hl, CliLogoutInput as hn, ListDeliveriesResponses as ho, DeleteEmailErrors as hr, ReplayDeliveryResponse as hs, listFunctionSecrets as ht, VerifyAgentSignupInput as hu, CreatedAgent as i, GetEmailError as ia, SemanticSearchMeta as ic, DownloadDomainZoneFileResponse as ii, StartCliSignupInput as il, AgentClaimResult as in, InboxStatus as io, CreateFunctionSecretInput as ir, ParsedEmailData as is, getSendPermissions as it, UpdateFunctionResponses as iu, createPrimitiveApiClient as j, GetOrgRoutingTopologyResponse as ja, SetFunctionSecretData as jc, FunctionRouteBody as ji, UpdateAccountErrors as jl, CreateAgentClaimLinkError as jn, ListEnvelope as jo, DeleteFunctionResponse as jr, ResendAgentSignupVerificationInput as js, startAgentClaim as jt, Client as ju, PrimitiveApiErrorDetails as k, GetOrgRoutingTopologyError as ka, SetFunctionRouteResponse as kc, FunctionListItem as ki, UpdateAccountData as kl, CreateAgentAccountResponses as kn, ListEndpointsResponse as ko, DeleteFunctionError as kr, ResendAgentSignupVerificationError as ks, setFunctionRoute as kt, WebhookSecret as ku, PrimitiveClient as l, GetFunctionError as la, SendEmailData as lc, DownloadRawEmailResponse as li, TestEndpointData as ll, AgentSignupVerifyResult as ln, InboxStatusRecentEmailSummary as lo, DeleteDomainError as lr, PollCliLoginInput as ls, listDeliveries as lt, VerifyAgentClaimInput as lu, SendAttachment as m, GetFunctionRoutingError as ma, SendMailAttachment as mc, EmailDetail as mi, TestFunctionData as ml, CliLogoutErrors as mn, ListDeliveriesResponse as mo, DeleteEmailError as mr, ReplayDeliveryErrors as ms, listFunctionLogs as mt, VerifyAgentSignupErrors as mu, AgentResource as n, GetConversationResponses as na, SemanticSearchField as nc, DownloadDomainZoneFileError as ni, StartCliSignupError as nl, AgentAccountUpgradeHint as nn, GetWebhookSecretResponse as no, CreateFunctionSecretError as nr, ListSentEmailsResponses as ns, getInboxStatus as nt, UpdateFunctionInput as nu, InboundEmail as o, GetEmailResponse as oa, SemanticSearchResult as oc, DownloadRawEmailData as oi, StartCliSignupResponses as ol, AgentOrgRef as on, InboxStatusEndpointSummary as oo, CreateFunctionSecretResponses as or, PollCliLoginData as os, getStorageStats as ot, VerifyAgentClaimData as ou, SemanticSearchResponse as p, GetFunctionRoutingData as pa, SendEmailResponses as pc, EmailAuth as pi, TestEndpointResponses as pl, CliLogoutError as pn, ListDeliveriesErrors as po, DeleteEmailData as pr, ReplayDeliveryError as ps, listFilters as pt, VerifyAgentSignupError as pu, downloadAttachments as q, GetStorageStatsResponses as qa, StartAgentSignupResponse as qc, GetAccountData as qi, UpdateFilterData as ql, CreateFilterResponses as qn, ListFunctionsData as qo, Domain as qr, SearchEmailsData as qs, Account as qt, CreateAgentOptions as r, GetEmailData as ra, SemanticSearchInput as rc, DownloadDomainZoneFileErrors as ri, StartCliSignupErrors as rl, AgentClaimLinkResult as rn, GetWebhookSecretResponses as ro, CreateFunctionSecretErrors as rr, PaginationMeta as rs, getOrgRoutingTopology as rt, UpdateFunctionResponse as ru, InboxResource as s, GetEmailResponses as sa, SemanticSearchScoreBreakdown as sc, DownloadRawEmailError as si, StorageStats as sl, AgentSignupResendResult as sn, InboxStatusFunctionSummary as so, Cursor as sr, PollCliLoginError as ss, getThread as st, VerifyAgentClaimError as su, AccountResource as t, GetConversationResponse as ta, SemanticSearchErrors as tc, DownloadDomainZoneFileData as ti, StartCliSignupData as tl, AgentAccountResult as tn, GetWebhookSecretErrors as to, CreateFunctionSecretData as tr, ListSentEmailsResponse as ts, getFunctionTestRunTrace as tt, UpdateFunctionErrors as tu, PrimitiveClientOptions as u, GetFunctionErrors as ua, SendEmailError as uc, DownloadRawEmailResponses as ui, TestEndpointError as ul, CliLoginPollResult as un, Limit as uo, DeleteDomainErrors as ur, PollCliLoginResponse as us, listDomains as ut, VerifyAgentClaimResponse as uu, WaitForNextOptions as v, GetFunctionTestRunTraceData as va, SendPermissionAnyRecipient as vc, EmailSearchHighlights as vi, TestFunctionResponses as vl, CliLogoutResult as vn, ListDomainsErrors as vo, DeleteEndpointData as vr, ReplayEmailWebhooksError as vs, pollCliLogin as vt, VerifyCliSignupData as vu, verifyWebhookSignature as w, GetInboxStatusError as wa, SentEmailStatus as wc, Endpoint as wi, UnsetFunctionRouteError as wl, CreateAgentAccountData as wn, ListEmailsResponse as wo, DeleteFilterError as wr, ReplyToEmailError as ws, rotateWebhookSecret as wt, VerifyDomainData as wu, createPrimitiveClient as x, GetFunctionTestRunTraceResponse as xa, SendPermissionYourDomain as xc, EmailStatus as xi, Thread as xl, CliSignupVerifyResult as xn, ListEmailsData as xo, DeleteEndpointResponse as xr, ReplayEmailWebhooksResponses as xs, replyToEmail as xt, VerifyCliSignupInput as xu, client as y, GetFunctionTestRunTraceError as ya, SendPermissionManagedZone as yc, EmailSearchMeta as yi, TestInvocationResult as yl, CliSignupResendResult as yn, ListDomainsResponse as yo, DeleteEndpointError as yr, ReplayEmailWebhooksErrors as ys, replayDelivery as yt, VerifyCliSignupError as yu, createFunctionSecret as z, GetSentEmailError as za, StartAgentClaimErrors as zc, FunctionTestRunInboundEmail as zi, UpdateDomainResponse as zl, CreateEndpointInput as zn, ListFunctionLogsErrors as zo, DeliverySummary as zr, ResendCliSignupVerificationResponses as zs, updateDomain as zt, createConfig as zu };

package/dist/{index-DR978rq5.d.ts → index-iZWfb98V.d.ts}

@@ -1,5 +1,5 @@
-import { N as WebhookEvent, j as ValidateEmailAuthResult, l as EmailAuth, u as EmailReceivedEvent } from "./types-yNU-Oiea.js";
-import { m as ReceivedEmail, u as WebhookValidationError } from "./errors-7E9sW9eX.js";
+import { I as WebhookEvent, P as ValidateEmailAuthResult, d as EmailAuth, f as EmailReceivedEvent } from "./types-QT2ss9ho.js";
+import { m as ReceivedEmail, u as WebhookValidationError } from "./errors-DyuAXctD.js";
 
 //#region src/validation.d.ts
 interface ValidationSuccess<T> {
@@ -281,8 +281,8 @@ declare const emailReceivedEventJsonSchema: {
         };
         readonly event: {
           readonly type: "string";
-          readonly const: "email.received";
-          readonly description: "Event type identifier. Always `\"email.received\"` for this event type.";
+          readonly enum: ["email.received", "email.bounced", "email.tls_report", "email.dmarc_report", "email.dmarc_failure"];
+          readonly description: "Event type identifier.\n\n- `email.received` - A normal inbound email.\n- `email.bounced` - A delivery status notification (DSN) reporting that a message delivery failed. Carries `email.analysis.bounce`.\n- `email.tls_report` - An SMTP TLS report (RFC 8460). Carries `email.analysis.tls_report`.\n- `email.dmarc_report` - A DMARC aggregate report (RFC 7489). Carries `email.analysis.dmarc_report`.\n- `email.dmarc_failure` - A DMARC failure (forensic) report.\n\nMachine-generated mail (bounces and the report types above) is delivered under its own event type rather than `email.received`, so an endpoint subscribed only to `email.received` receives just normal inbound mail. The payload shape is otherwise identical across event types; the type-specific details live under `email.analysis`.";
         };
         readonly version: {
           readonly $ref: "#/definitions/WebhookVersion";
@@ -768,9 +768,280 @@ declare const emailReceivedEventJsonSchema: {
           readonly $ref: "#/definitions/ForwardAnalysis";
           readonly description: "Forward detection and analysis results.\n\nOptional. Present when the email was processed by a forward-detection pipeline (always present in Primitive's managed service). When absent, forward detection was not performed on this email.";
         };
+        readonly bounce: {
+          readonly $ref: "#/definitions/BounceAnalysis";
+          readonly description: "Bounce (delivery status notification) analysis.\n\nPresent on `email.bounced` events: the parsed DSN reporting that a message you sent could not be delivered. Absent on all other event types.";
+        };
+        readonly tls_report: {
+          readonly $ref: "#/definitions/TlsReportAnalysis";
+          readonly description: "SMTP TLS report analysis (RFC 8460).\n\nPresent on `email.tls_report` events: a remote MTA's report of TLS negotiation results for mail sent to your domain. Absent on all other event types.";
+        };
+        readonly dmarc_report: {
+          readonly $ref: "#/definitions/DmarcReportAnalysis";
+          readonly description: "DMARC aggregate report analysis (RFC 7489).\n\nPresent on `email.dmarc_report` events: a receiver's periodic aggregate report of DMARC authentication results for your domain. Absent on all other event types.";
+        };
       };
       readonly description: "Email analysis and classification results.\n\nAll properties in this object are optional. Which fields are present depends on the analysis pipeline processing the email. Primitive's managed service populates all fields. Self-hosted or third-party deployments may include some, all, or none of these fields depending on their pipeline configuration.\n\nWhen a field is absent, it means that particular analysis was not performed, not that the analysis produced no results. For example, a missing `spamassassin` field means SpamAssassin was not run, not that the email scored 0.\n\nThese fields may be omitted from the payload entirely but must not be set to null.";
     };
+    readonly BounceAnalysis: {
+      readonly type: "object";
+      readonly properties: {
+        readonly is_bounce: {
+          readonly type: "boolean";
+          readonly const: true;
+          readonly description: "Always `true` on a parsed bounce.";
+        };
+        readonly kind: {
+          readonly type: "string";
+          readonly const: "dsn";
+          readonly description: "The machine-mail kind. Always `dsn` for a bounce.";
+        };
+        readonly type: {
+          readonly type: "string";
+          readonly enum: ["permanent", "transient", "undetermined"];
+          readonly description: "Whether the failure is permanent (hard bounce), transient (soft bounce, may be retried), or undetermined.";
+        };
+        readonly category: {
+          readonly type: "string";
+          readonly enum: ["mailbox_does_not_exist", "domain_does_not_exist", "domain_not_accepting_mail", "mailbox_full", "mailbox_inactive", "message_too_large", "content_rejected", "policy_blocked", "auth_failure", "relay_denied", "rate_limited", "network_error", "recipient_moved", "expired", "undetermined"];
+          readonly description: "Best-effort reason category for the failure.";
+        };
+        readonly classified_by: {
+          readonly type: "string";
+          readonly enum: ["status_code", "smtp_code", "pattern", "provider", "none"];
+          readonly description: "Which signal produced `category` (for transparency and debugging).";
+        };
+        readonly failed_recipient: {
+          readonly type: ["string", "null"];
+          readonly description: "The recipient address that failed, if the report identifies one.";
+        };
+        readonly smtp_code: {
+          readonly type: ["integer", "null"];
+          readonly description: "SMTP reply code (e.g. `550`), if reported.";
+        };
+        readonly status_code: {
+          readonly type: ["string", "null"];
+          readonly description: "Enhanced mail system status code (RFC 3463, e.g. `5.1.1`), if reported.";
+        };
+        readonly diagnostic_code: {
+          readonly type: ["string", "null"];
+          readonly description: "Raw diagnostic text from the reporting MTA, if present.";
+        };
+        readonly reported_by_mta: {
+          readonly type: ["string", "null"];
+          readonly description: "The MTA that generated the report, if identifiable.";
+        };
+        readonly original_message_id: {
+          readonly type: ["string", "null"];
+          readonly description: "Message-ID of the original message that bounced, if recoverable. Match this against the `message_id` of a message you sent to correlate the bounce.";
+        };
+        readonly reasons: {
+          readonly type: "array";
+          readonly items: {
+            readonly type: "string";
+          };
+          readonly description: "Human-readable reason strings extracted from the report.";
+        };
+      };
+      readonly required: ["is_bounce", "kind", "type", "category", "classified_by", "failed_recipient", "smtp_code", "status_code", "diagnostic_code", "reported_by_mta", "original_message_id", "reasons"];
+      readonly description: "Parsed delivery status notification (bounce). Present as `email.analysis.bounce` on `email.bounced` events.";
+    };
+    readonly TlsReportFailure: {
+      readonly type: "object";
+      readonly properties: {
+        readonly result_type: {
+          readonly type: ["string", "null"];
+          readonly description: "Failure result type (e.g. `certificate-expired`, `starttls-not-supported`).";
+        };
+        readonly count: {
+          readonly type: "integer";
+          readonly description: "Number of sessions that hit this failure.";
+        };
+        readonly sending_mta_ip: {
+          readonly type: ["string", "null"];
+        };
+        readonly receiving_mx_hostname: {
+          readonly type: ["string", "null"];
+        };
+      };
+      readonly required: ["result_type", "count", "sending_mta_ip", "receiving_mx_hostname"];
+    };
+    readonly TlsReportPolicy: {
+      readonly type: "object";
+      readonly properties: {
+        readonly policy_domain: {
+          readonly type: ["string", "null"];
+        };
+        readonly policy_type: {
+          readonly type: ["string", "null"];
+          readonly description: "Policy type the sessions were evaluated against (e.g. `sts`, `tlsa`, `no-policy-found`).";
+        };
+        readonly successful_sessions: {
+          readonly type: "integer";
+        };
+        readonly failed_sessions: {
+          readonly type: "integer";
+        };
+        readonly failures: {
+          readonly type: "array";
+          readonly items: {
+            readonly $ref: "#/definitions/TlsReportFailure";
+          };
+        };
+      };
+      readonly required: ["policy_domain", "policy_type", "successful_sessions", "failed_sessions", "failures"];
+    };
+    readonly TlsReportAnalysis: {
+      readonly type: "object";
+      readonly properties: {
+        readonly kind: {
+          readonly type: "string";
+          readonly const: "tls_report";
+        };
+        readonly organization: {
+          readonly type: ["string", "null"];
+          readonly description: "Reporting organization name.";
+        };
+        readonly report_id: {
+          readonly type: ["string", "null"];
+        };
+        readonly contact: {
+          readonly type: ["string", "null"];
+          readonly description: "Reporter contact, if provided.";
+        };
+        readonly date_range: {
+          readonly type: "object";
+          readonly properties: {
+            readonly start: {
+              readonly type: ["string", "null"];
+              readonly description: "ISO 8601 start of the reporting window.";
+            };
+            readonly end: {
+              readonly type: ["string", "null"];
+              readonly description: "ISO 8601 end of the reporting window.";
+            };
+          };
+          readonly required: ["start", "end"];
+        };
+        readonly total_successful_sessions: {
+          readonly type: "integer";
+        };
+        readonly total_failed_sessions: {
+          readonly type: "integer";
+        };
+        readonly policies: {
+          readonly type: "array";
+          readonly items: {
+            readonly $ref: "#/definitions/TlsReportPolicy";
+          };
+        };
+      };
+      readonly required: ["kind", "organization", "report_id", "contact", "date_range", "total_successful_sessions", "total_failed_sessions", "policies"];
+      readonly description: "Parsed SMTP TLS report (RFC 8460). Present as `email.analysis.tls_report` on `email.tls_report` events.";
+    };
+    readonly DmarcRecord: {
+      readonly type: "object";
+      readonly properties: {
+        readonly source_ip: {
+          readonly type: ["string", "null"];
+        };
+        readonly count: {
+          readonly type: "integer";
+        };
+        readonly disposition: {
+          readonly type: ["string", "null"];
+          readonly description: "Disposition applied by the receiver: `none`, `quarantine`, or `reject`.";
+        };
+        readonly dkim: {
+          readonly type: ["string", "null"];
+          readonly description: "DKIM alignment result: `pass` or `fail`.";
+        };
+        readonly spf: {
+          readonly type: ["string", "null"];
+          readonly description: "SPF alignment result: `pass` or `fail`.";
+        };
+        readonly header_from: {
+          readonly type: ["string", "null"];
+        };
+      };
+      readonly required: ["source_ip", "count", "disposition", "dkim", "spf", "header_from"];
+    };
+    readonly DmarcReportAnalysis: {
+      readonly type: "object";
+      readonly properties: {
+        readonly kind: {
+          readonly type: "string";
+          readonly const: "dmarc_report";
+        };
+        readonly organization: {
+          readonly type: ["string", "null"];
+        };
+        readonly report_id: {
+          readonly type: ["string", "null"];
+        };
+        readonly date_range: {
+          readonly type: "object";
+          readonly properties: {
+            readonly start: {
+              readonly type: ["string", "null"];
+              readonly description: "ISO 8601 start of the reporting window.";
+            };
+            readonly end: {
+              readonly type: ["string", "null"];
+              readonly description: "ISO 8601 end of the reporting window.";
+            };
+          };
+          readonly required: ["start", "end"];
+        };
+        readonly policy_published: {
+          readonly type: "object";
+          readonly properties: {
+            readonly domain: {
+              readonly type: ["string", "null"];
+            };
+            readonly p: {
+              readonly type: ["string", "null"];
+              readonly description: "Published domain policy: `none`, `quarantine`, or `reject`.";
+            };
+            readonly sp: {
+              readonly type: ["string", "null"];
+              readonly description: "Published subdomain policy.";
+            };
+            readonly pct: {
+              readonly type: ["integer", "null"];
+              readonly description: "Percentage of messages the policy is applied to.";
+            };
+            readonly adkim: {
+              readonly type: ["string", "null"];
+              readonly description: "DKIM alignment mode: `r` (relaxed) or `s` (strict).";
+            };
+            readonly aspf: {
+              readonly type: ["string", "null"];
+              readonly description: "SPF alignment mode: `r` (relaxed) or `s` (strict).";
+            };
+          };
+          readonly required: ["domain", "p", "sp", "pct", "adkim", "aspf"];
+        };
+        readonly total_count: {
+          readonly type: "integer";
+          readonly description: "Total messages covered by the report.";
+        };
+        readonly dkim_pass_count: {
+          readonly type: "integer";
+        };
+        readonly spf_pass_count: {
+          readonly type: "integer";
+        };
+        readonly records: {
+          readonly type: "array";
+          readonly items: {
+            readonly $ref: "#/definitions/DmarcRecord";
+          };
+        };
+      };
+      readonly required: ["kind", "organization", "report_id", "date_range", "policy_published", "total_count", "dkim_pass_count", "spf_pass_count", "records"];
+      readonly description: "Parsed DMARC aggregate report (RFC 7489). Present as `email.analysis.dmarc_report` on `email.dmarc_report` events.";
+    };
     readonly ForwardAnalysis: {
       readonly type: "object";
       readonly properties: {