# Provider runbooks ## SMTP | Symptom | Classification | Action | |---|---|---| | Final `2xx` after `DATA` | `CONFIRMED_ACCEPTED` / `PROVIDER_ACCEPTED` | None; this is acceptance, not inbox delivery | | `4yz` | `TRANSIENT_PROVIDER` | Retry under budget and deadline | | `5yz` | `PERMANENT_PROVIDER` or `INVALID_RECIPIENT` | Stop, or invalidate the contact point | | Connection lost after `DATA` | `AMBIGUOUS_SUBMISSION` | Reconcile or escalate; do not resend automatically | Connection, read, write and pool-acquire timeouts are all finite. There is no unbounded timeout. ## Amazon SES `MessageId` is acceptance evidence. SES itself documents that it can accept a request and then not send, so `MessageId` is never mapped to `DELIVERED`. | Event | Normalized | |---|---| | `Send` | reinforces `PROVIDER_ACCEPTED` | | `Delivery` | `DELIVERY_CONFIRMED` / `NETWORK_OR_CARRIER_ACCEPTED` | | `DeliveryDelay` | delay fact | | `Bounce` (permanent) | `BOUNCED_HARD` plus hard-bounce suppression | | `Bounce` (transient) | `BOUNCED_SOFT`; retry policy input, not a suppression reason | | `Complaint` | complaint fact plus suppression | | `Reject` | `PROVIDER_REJECTED` | | `RenderingFailure` | `TEMPLATE_FAILURE` | ## Removed provider families Twilio, FCM, APNs, Web Push and Webhook adapters were removed because nothing assembled them; their runbooks went with them. The last commit that had both is named in `docs/capability-status.md` (제거된 코드). A deployment that adds one of these providers back writes its runbook here with it.