Files
email_agent/.env.example
Builder e5cce1c93a Phase 7 follow-up: 1-month body retention and actions_log cap (AUD-75)
Implements the AGENTS.md §7 data rule: keep message bodies for one month, and
size-cap the append-only action log.

- internal/store/retention.go: Store.Retain clears messages.body_text older
  than the window (metadata stays) and deletes actions_log rows beyond the
  newest N, in one transaction.
- internal/config: EMAIL_AGENT_RETENTION_DAYS (30) and
  EMAIL_AGENT_ACTIONS_LOG_MAX_ROWS (50000).
- cmd/email-agent: bounded -retain flag for the n8n schedule.
- Tests for body clearing, metadata retention, log cap, and disabled policy.
2026-10-13 10:41:01 +11:00

74 lines
3.0 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
# --- Gmail SMTP (Phase 5 replies) -------------------------------------------
# Submission uses STARTTLS on 587 and forces IPv4, like IMAP.
EMAIL_AGENT_SMTP_HOST=smtp.gmail.com
EMAIL_AGENT_SMTP_PORT=587
# --- Integrations (used from later phases) ---------------------------------
# JEV is the TypeSafe System One HTTP API. JEV_BASE_URL defaults to the
# documented host https://api.typesafe.ai when unset.
JEV_BASE_URL=
JEV_API_KEY=
JEV_MODEL=jev-latest
# Classifier bounds (FR-3): in-flight JEV requests, and messages per run.
EMAIL_AGENT_CLASSIFY_CONCURRENCY=4
EMAIL_AGENT_CLASSIFY_MAX_MESSAGES=200
# OmniRoute is the house AI gateway; all non-JEV models go through it. The
# default base URL is the gateway on .13 (http://192.168.20.13:20129/v1).
OMNIROUTE_BASE_URL=
OMNIROUTE_API_KEY=
OMNIROUTE_MODEL=auto/best-chat
# --- Hub (Phase 7, FR-12) ---------------------------------------------------
# HUB_TOKEN is the shared bearer token the Hub sends to /capabilities and /ask.
# The Hub side uses HUB_PROJECT_EMAIL_AGENT_TOKEN with the same value.
HUB_TOKEN=
HUB_BASE_URL=http://192.168.20.13:8788
HUB_NOTIFY_TIMEOUT=5s
# --- Daily summary (Phase 7, FR-10) -----------------------------------------
# Delivery goes through the house Apprise API on .35. Set APPRISE_KEY for a
# stored Apprise configuration, or APPRISE_URLS for the stateless form.
APPRISE_URL=http://192.168.20.35:8210
APPRISE_KEY=
APPRISE_URLS=
APPRISE_TOKEN=
EMAIL_AGENT_SUMMARY_TO=samuelrolfe@gmail.com
# --- Retention (AGENTS.md §7) -----------------------------------------------
# `email-agent -retain` clears message bodies older than RETENTION_DAYS
# (metadata stays) and caps the append-only actions_log at MAX_ROWS.
EMAIL_AGENT_RETENTION_DAYS=30
EMAIL_AGENT_ACTIONS_LOG_MAX_ROWS=50000