@agenticmail/api 0.5.55 → 0.5.56

package/README.md

@@ -104,9 +104,11 @@ When a new email lands in an agent's inbox, the system does several things in re
 
 2. **Spam scoring** — external emails are scored. If the score exceeds the spam threshold, the email is automatically moved to the Spam folder and the notification event includes spam details. If it's a warning (elevated but not spam), the event includes the warning info but the email stays in the inbox.
 
-3. **Rule evaluation** — after spam filtering, the system checks the agent's custom email rules. Rules are checked in priority order and the first match wins. A rule can auto-mark the email as read, delete it, or move it to a specific folder.
+3. **Route classification** — the event is tagged with a route class such as `ignore_spam`, `ignore_newsletter`, `archive_automated`, `project_update`, `deal_escalation`, or `agent_instruction`. The route also includes the suggested action and whether a human gate is required.
 
-4. **Notification sent** — the event is pushed to all of the agent's connected SSE streams.
+4. **Rule evaluation** — after spam filtering, the system checks the agent's custom email rules. Rules are checked in priority order and the first match wins. A rule can auto-mark the email as read, delete it, or move it to a specific folder.
+
+5. **Notification sent** — the event is pushed to all of the agent's connected SSE streams.
 
 ### Connection limits
 

package/dist/index.js

@@ -1492,7 +1492,8 @@ import {
   MailReceiver as MailReceiver2,
   parseEmail as parseEmail3,
   scoreEmail as scoreEmail2,
-  isInternalEmail as isInternalEmail2
+  isInternalEmail as isInternalEmail2,
+  classifyEmailRoute
 } from "@agenticmail/core";
 import { v4 as uuidv42 } from "uuid";
 
@@ -2253,9 +2254,21 @@ function createEventRoutes(accountManager, config, db) {
             try {
               const raw = await receiver.fetchMessage(event.uid);
               const parsed = await parseEmail3(raw);
+              const policyMetadata = agent.metadata && typeof agent.metadata === "object" ? {
+                emailRoutePolicy: agent.metadata.emailRoutePolicy,
+                routePolicy: agent.metadata.routePolicy,
+                mailboxPolicy: agent.metadata.mailboxPolicy
+              } : void 0;
+              const accountRouteContext = {
+                name: agent.name,
+                email: agent.email,
+                role: agent.role,
+                metadata: policyMetadata
+              };
               const isRelay = !!parsed.headers.get("x-agenticmail-relay");
               const internal = !isRelay && isInternalEmail2(parsed);
               if (internal) {
+                event.route = classifyEmailRoute({ email: parsed, account: accountRouteContext });
                 const ruleResult2 = evaluateRules(db, agent.id, parsed);
                 if (ruleResult2) {
                   const actions = ruleResult2.actions;
@@ -2273,6 +2286,7 @@ function createEventRoutes(accountManager, config, db) {
                 return;
               }
               const spamResult = scoreEmail2(parsed);
+              event.route = classifyEmailRoute({ email: parsed, spam: spamResult, account: accountRouteContext });
               try {
                 db.prepare(
                   "INSERT INTO spam_log (id, agent_id, message_uid, score, flags, category, is_spam) VALUES (?, ?, ?, ?, ?, ?, ?)"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agenticmail/api",
-  "version": "0.5.55",
+  "version": "0.5.56",
   "description": "REST API server for AgenticMail — email and SMS endpoints for AI agents",
   "type": "module",
   "main": "dist/index.js",