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 channels send email --target "ops@example.com" --text "hello from loong"

​
Command Surface

OperationCommandUsage or status
smtp sendchannels send emailUsage: loong channels send email [OPTIONS] —target <TARGET> —text <TEXT>
imap reply loopchannels serve emailemail 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 gateway run 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.