email

type Config struct {
	Provider string `json:"provider,omitempty" yaml:"Provider,omitempty" toml:"Provider,omitempty"` // smtp, gmail_api, sendgrid
	Host     string `json:"host" yaml:"Host,omitempty" toml:"Host,omitempty"`                       // SMTP Host
	Port     int    `json:"port" yaml:"Port,omitempty" toml:"Port,omitempty,omitzero"`              // SMTP Port
	Username string `json:"username" yaml:"Username,omitempty" toml:"Username,omitempty"`
	Password string `json:"password" yaml:"Password,omitempty" toml:"Password,omitempty"`

	// IMAP settings for reading emails
	IMAPHost string `json:"imap_host,omitempty" yaml:"IMAPHost,omitempty" toml:"IMAPHost,omitempty"`
	IMAPPort int    `json:"imap_port,omitempty" yaml:"IMAPPort,omitempty" toml:"IMAPPort,omitempty,omitzero"`

	// IMAPTLSConfig is set by the application from security.CryptoConfig.TLSConfig()
	// to enforce NIST 2030 minimums (TLS 1.2+). Not loaded from config file.
	IMAPTLSConfig *tls.Config `json:"-" yaml:"-" toml:"-"`
}

type Email struct {
	From        string
	Subject     string
	Body        string // Plain text body
	Date        string
	Attachments []string // Summaries of attachments
}

type ReadEmailRequest struct {
	Filter string `json:"filter" jsonschema:"description=Filter instructions (e.g. 'unread', 'security alert')"`
}

type SendEmailRequest struct {
	To      []string `json:"to" jsonschema:"description=Recipient email addresses,required"`
	Subject string   `json:"subject" jsonschema:"description=Email subject,required"`
	Body    string   `json:"body" jsonschema:"description=Email body content,required"`
}

type SendRequest struct {
	To      []string
	Subject string
	Body    string
	IsHTML  bool
}

type Service interface {
	Send(ctx context.Context, req SendRequest) error
	Read(ctx context.Context, filter string) ([]*Email, error)
	// Validate performs a lightweight health check to detect misconfigurations at startup.
	Validate(ctx context.Context) error
}

type ToolProvider struct {
	// contains filtered or unexported fields
}