Email Triage Agent

Deterministische E-Mail-Triage für Hermes Agent. Es klassifiziert Nachrichten in P0–P3 oder REVIEW, emittiert den gemeinsamen pif.event.v1-Vertrag und lässt Hermes das Ergebnis über sein bestehendes Feishu-Gateway zustellen.

确定性的 Hermes 邮件分诊 MCP：不确定就保留，V1 永不删除、永不发信，飞书凭证继续由 Hermes 管理。

Warum / 设计理念

• Informationen reduzieren, nicht mehr davon erzeugen.

• P0 ist sofort; P1 wartet auf einen Digest; P2/P3 sind nur für Audits.

• Absender-Authentifizierungskonflikte und geringe Konfidenz werden zu REVIEW/HOLD.

• Menschliches Feedback aktualisiert eine externe JSONL-Regelspur, niemals Modellgewichte.

• Der optionale Adapter verbindet sich mit echten Postfächern über schreibgeschütztes IMAP. Er führt niemals Delete-, Send-, Move- oder Seen-Änderungen aus.

Related MCP server: inbox-to-action-mcp

Lokale Ausführung

npm ci
npm test
npm run demo

Befehle für den echten Postfach-Adapter:

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

Anmeldeinformationen sind Verweise auf macOS-Schlüsselbund-Einträge oder Umgebungsvariablen; Literale Passwörter und Tokens werden von der Konfigurationsvalidierung abgelehnt. Siehe den Leitfaden für den schreibgeschützten Postfach-Adapter.

Einmalige Klassifizierung:

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

Zu Hermes auf macOS hinzufügen

Hermes entdeckt stdio-MCP-Tools aus ~/.hermes/config.yaml. Klonen und installieren, dann einen absoluten Pfad verwenden:

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 registriert Tools mit Namen wie mcp_email_firewall_triage_email. Der Server benötigt niemals Feishu-Geheimnisse: Hermes besitzt bereits den Feishu-Kanal und präsentiert oder plant die zurückgegebene Nachricht.

Werkzeuge

• triage_email

• render_feishu_email

• record_email_feedback

• get_email_policy

• poll_email_accounts

• test_email_account

• acknowledge_email_events

Das Begleit-Repository ist crypto-market-sentinel. Beide geben denselben Ereignisumschlag zurück, sodass ein einziger Hermes-Prompt dieselbe dringend/Digest/Audit-Richtlinie anwenden kann.

Siehe Hermes macOS Setup und den gemeinsamen PIF-Ereignisvertrag.

Lizenz

MIT. Siehe LICENSE.