Files
Memoh/internal/handlers/email_bindings.go
T
BBQ cc5f00355f feat: add email service with multi-adapter support (#146)
* feat: add email service with multi-adapter support

Implement a full-stack email service with global provider management,
per-bot bindings with granular read/write permissions, outbox audit
storage, and MCP tool integration for direct mailbox access.

Backend:
- Email providers: CRUD with dynamic config schema (generic SMTP/IMAP, Mailgun)
- Generic adapter: go-mail (SMTP) + go-imap/v2 (IMAP IDLE real-time push via
  UnilateralDataHandler + UID-based tracking + periodic check fallback)
- Mailgun adapter: mailgun-go/v5 with dual inbound mode (webhook + poll)
- Bot email bindings: per-bot provider binding with independent r/w permissions
- Outbox: outbound email audit log with status tracking
- Trigger: inbound emails push notification to bot_inbox (from/subject only,
  LLM reads full content on demand via MCP tools)
- MailboxReader interface: on-demand IMAP queries for listing/reading emails
- MCP tools: email_accounts, email_send, email_list (paginated mailbox),
  email_read (by UID) — all with multi-binding and provider_id selection
- Webhook: /email/mailgun/webhook/:config_id (JWT-skipped, signature-verified)
- DB migration: 0019_add_email (email_providers, bot_email_bindings, email_outbox)

Frontend:
- Email Providers page: /email-providers with MasterDetailSidebarLayout
- Dynamic config form rendered from ordered provider meta schema with i18n keys
- Bot detail: Email tab with bindings management + outbox audit table
- Sidebar navigation entry
- Full i18n support (en + zh)
- Auto-generated SDK from Swagger

Closes #17

* feat(email): trigger bot conversation immediately on inbound email

Instead of only storing an inbox item and waiting for the next chat,
the email trigger now proactively invokes the conversation resolver
so the bot processes new emails right away — aligned with the
schedule/heartbeat trigger pattern.

* fix: lint

---------

Co-authored-by: Acbox <acbox0328@gmail.com>
2026-02-28 21:03:59 +08:00

142 lines
4.6 KiB
Go

package handlers
import (
"log/slog"
"net/http"
"strings"
"github.com/labstack/echo/v4"
"github.com/memohai/memoh/internal/email"
)
type EmailBindingsHandler struct {
service *email.Service
manager *email.Manager
logger *slog.Logger
}
func NewEmailBindingsHandler(log *slog.Logger, service *email.Service, manager *email.Manager) *EmailBindingsHandler {
return &EmailBindingsHandler{
service: service,
manager: manager,
logger: log.With(slog.String("handler", "email_bindings")),
}
}
func (h *EmailBindingsHandler) Register(e *echo.Echo) {
g := e.Group("/bots/:bot_id/email-bindings")
g.POST("", h.Create)
g.GET("", h.List)
g.PUT("/:id", h.Update)
g.DELETE("/:id", h.Delete)
}
// Create godoc
// @Summary Bind an email provider to a bot
// @Tags email-bindings
// @Accept json
// @Produce json
// @Param bot_id path string true "Bot ID"
// @Param request body email.CreateBindingRequest true "Binding configuration"
// @Success 201 {object} email.BindingResponse
// @Failure 400 {object} ErrorResponse
// @Failure 500 {object} ErrorResponse
// @Router /bots/{bot_id}/email-bindings [post]
func (h *EmailBindingsHandler) Create(c echo.Context) error {
botID := strings.TrimSpace(c.Param("bot_id"))
if botID == "" {
return echo.NewHTTPError(http.StatusBadRequest, "bot_id is required")
}
var req email.CreateBindingRequest
if err := c.Bind(&req); err != nil {
return echo.NewHTTPError(http.StatusBadRequest, err.Error())
}
if strings.TrimSpace(req.EmailProviderID) == "" {
return echo.NewHTTPError(http.StatusBadRequest, "email_provider_id is required")
}
if strings.TrimSpace(req.EmailAddress) == "" {
return echo.NewHTTPError(http.StatusBadRequest, "email_address is required")
}
resp, err := h.service.CreateBinding(c.Request().Context(), botID, req)
if err != nil {
return echo.NewHTTPError(http.StatusInternalServerError, err.Error())
}
// Refresh provider connections after binding change
_ = h.manager.RefreshProvider(c.Request().Context(), req.EmailProviderID)
return c.JSON(http.StatusCreated, resp)
}
// List godoc
// @Summary List email bindings for a bot
// @Tags email-bindings
// @Produce json
// @Param bot_id path string true "Bot ID"
// @Success 200 {array} email.BindingResponse
// @Failure 500 {object} ErrorResponse
// @Router /bots/{bot_id}/email-bindings [get]
func (h *EmailBindingsHandler) List(c echo.Context) error {
botID := strings.TrimSpace(c.Param("bot_id"))
if botID == "" {
return echo.NewHTTPError(http.StatusBadRequest, "bot_id is required")
}
items, err := h.service.ListBindings(c.Request().Context(), botID)
if err != nil {
return echo.NewHTTPError(http.StatusInternalServerError, err.Error())
}
return c.JSON(http.StatusOK, items)
}
// Update godoc
// @Summary Update an email binding
// @Tags email-bindings
// @Accept json
// @Produce json
// @Param bot_id path string true "Bot ID"
// @Param id path string true "Binding ID"
// @Param request body email.UpdateBindingRequest true "Updated binding"
// @Success 200 {object} email.BindingResponse
// @Failure 400 {object} ErrorResponse
// @Failure 500 {object} ErrorResponse
// @Router /bots/{bot_id}/email-bindings/{id} [put]
func (h *EmailBindingsHandler) Update(c echo.Context) error {
id := strings.TrimSpace(c.Param("id"))
if id == "" {
return echo.NewHTTPError(http.StatusBadRequest, "id is required")
}
var req email.UpdateBindingRequest
if err := c.Bind(&req); err != nil {
return echo.NewHTTPError(http.StatusBadRequest, err.Error())
}
resp, err := h.service.UpdateBinding(c.Request().Context(), id, req)
if err != nil {
return echo.NewHTTPError(http.StatusInternalServerError, err.Error())
}
_ = h.manager.RefreshProvider(c.Request().Context(), resp.EmailProviderID)
return c.JSON(http.StatusOK, resp)
}
// Delete godoc
// @Summary Remove an email binding
// @Tags email-bindings
// @Param bot_id path string true "Bot ID"
// @Param id path string true "Binding ID"
// @Success 204 "No Content"
// @Failure 500 {object} ErrorResponse
// @Router /bots/{bot_id}/email-bindings/{id} [delete]
func (h *EmailBindingsHandler) Delete(c echo.Context) error {
id := strings.TrimSpace(c.Param("id"))
if id == "" {
return echo.NewHTTPError(http.StatusBadRequest, "id is required")
}
// Get binding info before delete for refresh
binding, _ := h.service.GetBinding(c.Request().Context(), id)
if err := h.service.DeleteBinding(c.Request().Context(), id); err != nil {
return echo.NewHTTPError(http.StatusInternalServerError, err.Error())
}
if binding.EmailProviderID != "" {
_ = h.manager.RefreshProvider(c.Request().Context(), binding.EmailProviderID)
}
return c.NoContent(http.StatusNoContent)
}