Skip to main content

​
Email

This is a shipped config-backed outbound surface. Email IMAP reply-loop serve runtime is not implemented yet

​
At A Glance

FieldValue
Catalog idemail
Config keyemail
Implementation statusconfig_backed
Transportsmtp_imap
Aliasessmtp, imap
Default send target kindaddress

​
Minimal Config

[email]
enabled = true
smtp_host = "smtp.example.com"
smtp_username_env = "EMAIL_SMTP_USERNAME"
smtp_password_env = "EMAIL_SMTP_PASSWORD"
from_address = "loong@example.com"

​
Smoke Test

loong email-send --target "ops@example.com" --text "hello from loong"

​
Command Surface

OperationCommandUsage or status
smtp sendemail-sendUsage: loong email-send [OPTIONS] —target <TARGET> —text <TEXT>
imap reply loopemail-serveemail IMAP reply-loop serve runtime is not implemented yet

​
Required Fields For Send

RequirementConfig pathsEnv pointer pathsDefault env
channel enabledemail.enabled
email.accounts.<account>.enabled		nonenone
smtp hostemail.smtp_host
email.accounts.<account>.smtp_host		nonenone
smtp usernameemail.smtp_username
email.accounts.<account>.smtp_username		email.smtp_username_env
email.accounts.<account>.smtp_username_env		EMAIL_SMTP_USERNAME
smtp passwordemail.smtp_password
email.accounts.<account>.smtp_password		email.smtp_password_env
email.accounts.<account>.smtp_password_env		EMAIL_SMTP_PASSWORD
from addressemail.from_address
email.accounts.<account>.from_address		nonenone

​
Gateway And Ownership

This surface is a direct-send delivery lane. It does not join multi-channel-serve or the gateway-owned reply-loop contract today.

​
Operator Notes

  • This surface is SMTP send today. The catalog still tracks an IMAP-style serve contract, but it is not a shipped runtime surface yet.
  • The outbound subject is derived from the first non-empty line of the body.
  • Continue to Channel Guides for the full shipped channel matrix.
  • Continue to Channels for the conceptual surface model.
  • Continue to Channel Setup for the shared public setup contract.