Files
email_agent/.env.example
Sam Rolfe 1d88f962f6 Phase 2: Gmail IMAP fetch (IPv4), FR-2 source address, real mail in dashboard (AUD-67)
- internal/mailfetch: stdlib-only read-only IMAP client (LOGIN, SELECT,
  UID SEARCH, UID FETCH) that always dials tcp4; IPv6 to Gmail is broken
  from .13 and caused a socket EOF.
- MIME parsing to text, RFC2047 header decoding, FR-2 source address:
  X-Pm-Original-To -> To -> Received 'for <addr>' -> Return-Path, never
  Delivered-To. The matched header is recorded for audit.
- store: Message upsert/list/count + LogAction; schema migration v2 adds
  imap_uid and imap_uidvalidity.
- server: dashboard and /partials/inbox render real mail grouped by
  category with a recommended action; POST /actions/fetch runs a scan
  (CSRF-checked); nav counts; 'Check mail' button.
- config: GMAIL_USER, GMAIL_APP_PASSWORD, IMAP host/port/lookback/max.
- cmd: -fetch runs one scan and exits (n8n/CLI entry point, FR-1).
- compose/.env.example expose the Gmail + IMAP settings.
- tests: FR-2 precedence, MIME bodies, IMAP literal/parser, store
  upsert/migration, inbox rendering.

Co-Authored-By: Paperclip <noreply@paperclip.ing>
2026-10-11 20:59:53 +11:00

39 lines
1.4 KiB
Plaintext

# Email Agent — environment variable names (values are NOT committed).
#
# Copy to `.env` for local Docker Compose use. In production these come from
# ~/.config/environment.d/10-secrets.conf (or the host environment) and are
# passed through by docker-compose.
#
# Secret values must never be committed to git.
# --- Runtime ---------------------------------------------------------------
EMAIL_AGENT_ENV=production
EMAIL_AGENT_PORT=8790
EMAIL_AGENT_ADDR=:8790
EMAIL_AGENT_DB_PATH=/data/email_agent.db
EMAIL_AGENT_LOG_LEVEL=info
EMAIL_AGENT_PUBLIC_BASE_URL=https://mail.lab.audasmedia.com.au
# --- Session / auth --------------------------------------------------------
# Session cookie signing key. Generate with: python3 -c 'import secrets;print(secrets.token_hex(32))'
EMAIL_AGENT_SESSION_SECRET=change-me
# Login password for the single user (Sam). If unset, the session secret above
# doubles as the password.
EMAIL_AGENT_PASSWORD=
# --- Gmail IMAP (Phase 2) ---------------------------------------------------
# App password only (AGENTS.md §9). Values live in the host environment, never here.
GMAIL_USER=
GMAIL_APP_PASSWORD=
EMAIL_AGENT_IMAP_HOST=imap.gmail.com
EMAIL_AGENT_IMAP_PORT=993
EMAIL_AGENT_IMAP_LOOKBACK_DAYS=14
EMAIL_AGENT_IMAP_MAX_MESSAGES=100
# --- Integrations (used from later phases) ---------------------------------
JEV_BASE_URL=
JEV_API_KEY=
OMNIROUTE_BASE_URL=
OMNIROUTE_API_KEY=
HUB_TOKEN=