Email Triage Agent

Детерминированная сортировка электронной почты для Hermes Agent. Он классифицирует сообщения как P0–P3 или REVIEW, генерирует общий контракт pif.event.v1 и позволяет Hermes доставлять результат через существующий шлюз Feishu.

Детерминированный MCP для сортировки почты Hermes: при неопределенности сохраняем, V1 никогда не удаляет и не отправляет, учётные данные 飞书 по-прежнему управляются Hermes.

Почему / Философия дизайна

• Сокращайте информацию, не создавайте новую.

• P0 — немедленно; P1 ожидает дайджеста; P2/P3 — только аудит.

• Конфликты аутентификации отправителя и низкая уверенность становятся REVIEW/HOLD.

• Обратная связь от человека обновляет внешний журнал правил JSONL, но никогда не веса модели.

• Опциональный адаптер подключается к реальным почтовым ящикам через IMAP только для чтения. Он никогда не выполняет операции Delete, Send, Move или Seen.

Related MCP server: inbox-to-action-mcp

Локальный запуск

npm ci
npm test
npm run demo

Команды адаптера реального почтового ящика:

node src/adapter-cli.js test --account qq-main
node src/adapter-cli.js poll --accounts qq-main

Учётные данные — это ссылки на элементы связки ключей macOS или переменные окружения; буквальные пароли и токены отклоняются при проверке конфигурации. См. руководство по адаптеру почтового ящика только для чтения.

Разовая классификация:

node src/cli.js --json '{"sender":"no-reply@accounts.google.com","subject":"New login detected","auth":{"spf":"pass","dkim":"pass","dmarc":"pass"},"protectedSender":true}'

Добавление в Hermes на macOS

Hermes обнаруживает инструменты stdio MCP из ~/.hermes/config.yaml. Клонируйте и установите, затем используйте абсолютный путь:

git clone https://github.com/roclee2692/email-triage-agent.git ~/Projects/email-triage-agent
cd ~/Projects/email-triage-agent && npm ci
hermes mcp add email-firewall --command node --args "$HOME/Projects/email-triage-agent/src/mcp.js"
hermes mcp test email-firewall

Hermes регистрирует инструменты с именами, такими как mcp_email_firewall_triage_email. Серверу никогда не нужны секреты Feishu: Hermes уже владеет каналом Feishu и отображает или планирует возвращённое сообщение.

Инструменты

• triage_email

• render_feishu_email

• record_email_feedback

• get_email_policy

• poll_email_accounts

• test_email_account

• acknowledge_email_events

Сопутствующий репозиторий — crypto-market-sentinel. Оба возвращают одинаковый конверт событий, поэтому один промпт Hermes может применять одну и ту же политику срочности/дайджеста/аудита.

См. настройку Hermes на macOS и общий контракт событий PIF.

Лицензия

MIT. См. LICENSE.