email

Overview ¶

Package email provides the email_send tool for sending emails via SMTP.

This tool is deliberately transport-agnostic: it speaks SMTP directly, which works with any provider (Gmail, SendGrid, Postmark, SES, Mailgun, self-hosted) without requiring provider-specific SDKs.

Implementation notes for contributors:

• Use net/smtp from the standard library for the SMTP client — no deps needed.
• For TLS: use smtp.DialTLS (port 465) or smtp.SendMail with STARTTLS (port 587).
• For Gmail: enable "App Passwords" (2FA must be on) and use port 587.
• For SendGrid/Mailgun: use their SMTP relay — same code, different credentials.
• HTML bodies: set Content-Type: text/html; charset=UTF-8 in the MIME headers.
• Multipart: for both HTML and plain-text, use multipart/alternative.
• Attachments: multipart/mixed wrapping multipart/alternative + base64 parts.
• Start with plain-text only, add HTML + attachments as follow-up.

Env vars:

SMTP_HOST      — SMTP server hostname (e.g. smtp.gmail.com)
SMTP_PORT      — port number (587 for STARTTLS, 465 for TLS)
SMTP_USER      — SMTP username / email address
SMTP_PASSWORD  — SMTP password or app password
SMTP_FROM      — default From address (optional, falls back to SMTP_USER)

See GitHub issue for full implementation spec.