secrets_path (email_imap.py)

Provider-agnostic email — IMAP read + SMTP draft/send (the last Milestone A connector gap; Gmail/Workspace users already have `gog`). Opt-in first-party capability (`jigga capabilities install email-imap`), BYO credentials: host/port/username/app-password collected by the setup w

# Source: https://github.com/JIGGAI/JIGGA | License: MIT | Copyright 2026 JIGG AI
# Provided via justclaw.it.com; keep this notice with the code.
"""Provider-agnostic email — IMAP read + SMTP draft/send (the last Milestone A
connector gap; Gmail/Workspace users already have `gog`).

Opt-in first-party capability (`jigga capabilities install email-imap`), BYO
credentials: host/port/username/app-password collected by the setup wizard into
`~/.jigga/secrets/email_imap.json` (0600). stdlib only (imaplib / smtplib /
email).

Actions:
- `email.search` — friendly filters (`unread`, `today`, `from:x`, `subject:x`,
  free text) mapped to IMAP criteria; returns headers, newest first.
- `email.get` — one message's plain-text body (truncated).
- `email.draft` — file-first: drafts land in `~/.jigga/ema

... (truncated -- full source via MCP)