@auxiora/email-intelligence 1.0.0

package/dist/triage.js

@@ -0,0 +1,109 @@
+import { getLogger } from '@auxiora/logger';
+const logger = getLogger('email-intelligence:triage');
+const URGENT_KEYWORDS = ['urgent', 'asap', 'emergency', 'critical'];
+const ACTION_KEYWORDS = ['please', 'could you', 'can you', 'would you', 'need you to', 'let me know', 'rsvp'];
+export class EmailTriageEngine {
+    config;
+    constructor(config = {}) {
+        this.config = config;
+    }
+    triage(emails) {
+        return emails.map(email => this.triageSingle(email));
+    }
+    triageSingle(email) {
+        const urgent = this.checkUrgent(email);
+        if (urgent)
+            return urgent;
+        const action = this.checkAction(email);
+        if (action)
+            return action;
+        const newsletter = this.checkNewsletter(email);
+        if (newsletter)
+            return newsletter;
+        const spam = this.checkSpam(email);
+        if (spam)
+            return spam;
+        logger.debug('Email triaged as FYI', { emailId: email.id });
+        return {
+            emailId: email.id,
+            priority: 'fyi',
+            reason: 'No specific signals detected',
+            suggestedAction: 'none',
+            confidence: 0.5,
+        };
+    }
+    checkUrgent(email) {
+        const senderDomain = email.from.split('@')[1]?.toLowerCase() ?? '';
+        const senderAddress = email.from.toLowerCase();
+        const subjectLower = email.subject.toLowerCase();
+        // VIP sender
+        if (this.config.urgentSenders?.some(s => senderAddress.includes(s.toLowerCase()))) {
+            return this.makeResult(email.id, 'urgent', 'From VIP sender', 'reply', 0.9);
+        }
+        // VIP domain
+        if (this.config.vipDomains?.some(d => senderDomain === d.toLowerCase())) {
+            return this.makeResult(email.id, 'urgent', 'From VIP domain', 'reply', 0.9);
+        }
+        // High/urgent importance
+        if (email.importance === 'urgent' || email.importance === 'high') {
+            return this.makeResult(email.id, 'urgent', `Marked as ${email.importance} importance`, 'reply', 0.9);
+        }
+        // Urgent keywords in subject
+        if (URGENT_KEYWORDS.some(kw => subjectLower.includes(kw))) {
+            const matched = URGENT_KEYWORDS.find(kw => subjectLower.includes(kw));
+            return this.makeResult(email.id, 'urgent', `Subject contains "${matched}"`, 'reply', 0.9);
+        }
+        return null;
+    }
+    checkAction(email) {
+        if (!email.isDirect)
+            return null;
+        const bodyLower = (email.body ?? email.bodyPreview).toLowerCase();
+        // Check for question marks
+        if (bodyLower.includes('?')) {
+            return this.makeResult(email.id, 'action', 'Contains a question directed to you', 'reply', 0.8);
+        }
+        // Check for action keywords
+        const matched = ACTION_KEYWORDS.find(kw => bodyLower.includes(kw));
+        if (matched) {
+            return this.makeResult(email.id, 'action', `Contains request keyword "${matched}"`, 'reply', 0.7);
+        }
+        return null;
+    }
+    checkNewsletter(email) {
+        if (email.hasUnsubscribe) {
+            return this.makeResult(email.id, 'newsletter', 'Has List-Unsubscribe header', 'unsubscribe', 0.85);
+        }
+        const senderLower = email.from.toLowerCase();
+        if (this.config.newsletterSenders?.some(ns => senderLower.includes(ns.toLowerCase()))) {
+            return this.makeResult(email.id, 'newsletter', 'From known newsletter sender', 'unsubscribe', 0.85);
+        }
+        return null;
+    }
+    checkSpam(email) {
+        const senderLower = email.from.toLowerCase();
+        // Check spam patterns
+        if (this.config.spamPatterns?.some(sp => senderLower.includes(sp.toLowerCase()) || email.subject.toLowerCase().includes(sp.toLowerCase()))) {
+            return this.makeResult(email.id, 'spam', 'Matches spam pattern', 'archive', 0.6);
+        }
+        // Excessive caps in subject (more than 50% uppercase, at least 5 letters)
+        const letters = email.subject.replace(/[^a-zA-Z]/g, '');
+        if (letters.length >= 5) {
+            const upperCount = (email.subject.match(/[A-Z]/g) ?? []).length;
+            if (upperCount / letters.length > 0.5) {
+                return this.makeResult(email.id, 'spam', 'Subject has excessive capitalization', 'archive', 0.6);
+            }
+        }
+        // Body contains 'unsubscribe' but no List-Unsubscribe header
+        const bodyLower = (email.body ?? email.bodyPreview).toLowerCase();
+        if (bodyLower.includes('unsubscribe') && !email.hasUnsubscribe) {
+            return this.makeResult(email.id, 'spam', 'Contains "unsubscribe" without proper header', 'archive', 0.6);
+        }
+        return null;
+    }
+    makeResult(emailId, priority, reason, suggestedAction, confidence) {
+        logger.debug(`Email triaged as ${priority}`, { emailId, reason });
+        return { emailId, priority, reason, suggestedAction, confidence };
+    }
+}
+//# sourceMappingURL=triage.js.map

package/dist/triage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triage.js","sourceRoot":"","sources":["../src/triage.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,52 @@
+export interface EmailMessage {
+    id: string;
+    from: string;
+    to: string[];
+    cc?: string[];
+    subject: string;
+    bodyPreview: string;
+    body?: string;
+    receivedDateTime: string;
+    importance: 'low' | 'normal' | 'high' | 'urgent';
+    isRead: boolean;
+    hasAttachments: boolean;
+    conversationId: string;
+    categories?: string[];
+    /** Whether user is in TO (direct) or CC */
+    isDirect: boolean;
+    /** List-Unsubscribe header present */
+    hasUnsubscribe?: boolean;
+}
+export type TriagePriority = 'urgent' | 'action' | 'fyi' | 'spam' | 'newsletter';
+export interface TriageResult {
+    emailId: string;
+    priority: TriagePriority;
+    reason: string;
+    suggestedAction: 'reply' | 'archive' | 'flag' | 'unsubscribe' | 'none';
+    confidence: number;
+}
+export interface SmartReplyDraft {
+    emailId: string;
+    replyBody: string;
+    tone: 'formal' | 'casual' | 'brief';
+    confidence: number;
+}
+export interface FollowUp {
+    id: string;
+    emailId: string;
+    promiseText: string;
+    detectedAt: number;
+    dueDate?: number;
+    status: 'pending' | 'completed' | 'overdue';
+    reminderSent: boolean;
+}
+export interface ThreadSummary {
+    conversationId: string;
+    summary: string;
+    messageCount: number;
+    participants: string[];
+    keyPoints: string[];
+    actionItems: string[];
+    latestTimestamp: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;IACjD,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,2CAA2C;IAC3C,QAAQ,EAAE,OAAO,CAAC;IAClB,sCAAsC;IACtC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,YAAY,CAAC;AAEjF,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC;IACvE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;IAC5C,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@auxiora/email-intelligence",
+  "version": "1.0.0",
+  "description": "Email intelligence: triage, smart reply, follow-up tracking, thread summarization",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@auxiora/logger": "1.0.0",
+    "@auxiora/audit": "1.0.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/follow-up.ts

@@ -0,0 +1,94 @@
+import * as crypto from 'node:crypto';
+import { getLogger } from '@auxiora/logger';
+import type { EmailMessage, FollowUp } from './types.js';
+
+const logger = getLogger('email-intelligence:follow-up');
+
+const PROMISE_PATTERNS = [
+  /i[''\u2019]ll send/i,
+  /i will send/i,
+  /i[''\u2019]ll get back/i,
+  /i will get back/i,
+  /i[''\u2019]ll follow up/i,
+  /i will follow up/i,
+  /let me check/i,
+  /i[''\u2019]ll look into/i,
+  /i will look into/i,
+];
+
+const DAY_NAMES = ['sunday', 'monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday'];
+
+export class FollowUpTracker {
+  detectPromises(sentEmail: EmailMessage): FollowUp[] {
+    const body = sentEmail.body ?? sentEmail.bodyPreview;
+    const sentences = body.split(/[.!?\n]+/).map(s => s.trim()).filter(Boolean);
+    const followUps: FollowUp[] = [];
+    const now = Date.now();
+
+    for (const sentence of sentences) {
+      for (const pattern of PROMISE_PATTERNS) {
+        if (pattern.test(sentence)) {
+          const dueDate = this.extractDueDate(sentence, now);
+          followUps.push({
+            id: crypto.randomUUID(),
+            emailId: sentEmail.id,
+            promiseText: sentence,
+            detectedAt: now,
+            dueDate,
+            status: 'pending',
+            reminderSent: false,
+          });
+          break; // One match per sentence
+        }
+      }
+    }
+
+    logger.debug(`Detected ${followUps.length} promises`, { emailId: sentEmail.id });
+    return followUps;
+  }
+
+  checkOverdue(followUps: FollowUp[]): FollowUp[] {
+    const now = Date.now();
+    return followUps.filter(fu =>
+      fu.status === 'pending' && fu.dueDate !== undefined && fu.dueDate < now
+    );
+  }
+
+  markCompleted(followUps: FollowUp[], id: string): FollowUp[] {
+    return followUps.map(fu =>
+      fu.id === id ? { ...fu, status: 'completed' as const } : fu
+    );
+  }
+
+  private extractDueDate(sentence: string, now: number): number | undefined {
+    const lower = sentence.toLowerCase();
+
+    // "by end of day" / "by end of week"
+    if (lower.includes('by end of day') || lower.includes('by eod')) {
+      const date = new Date(now);
+      date.setHours(23, 59, 59, 999);
+      return date.getTime();
+    }
+
+    if (lower.includes('by end of week') || lower.includes('by eow')) {
+      const date = new Date(now);
+      const daysUntilFriday = (5 - date.getDay() + 7) % 7 || 7;
+      date.setDate(date.getDate() + daysUntilFriday);
+      date.setHours(23, 59, 59, 999);
+      return date.getTime();
+    }
+
+    // "by Monday", "by Tuesday", etc.
+    for (let i = 0; i < DAY_NAMES.length; i++) {
+      if (lower.includes(`by ${DAY_NAMES[i]}`)) {
+        const date = new Date(now);
+        const daysUntil = (i - date.getDay() + 7) % 7 || 7;
+        date.setDate(date.getDate() + daysUntil);
+        date.setHours(23, 59, 59, 999);
+        return date.getTime();
+      }
+    }
+
+    return undefined;
+  }
+}

package/src/index.ts

@@ -0,0 +1,13 @@
+export type {
+  EmailMessage,
+  TriagePriority,
+  TriageResult,
+  SmartReplyDraft,
+  FollowUp,
+  ThreadSummary,
+} from './types.js';
+
+export { EmailTriageEngine, type TriageConfig } from './triage.js';
+export { SmartReplyGenerator } from './smart-reply.js';
+export { FollowUpTracker } from './follow-up.js';
+export { ThreadSummarizer } from './thread-summarizer.js';

package/src/smart-reply.ts

@@ -0,0 +1,100 @@
+import { getLogger } from '@auxiora/logger';
+import type { EmailMessage, SmartReplyDraft } from './types.js';
+
+const logger = getLogger('email-intelligence:smart-reply');
+
+export class SmartReplyGenerator {
+  generateQuickReplies(email: EmailMessage): SmartReplyDraft[] {
+    logger.debug('Generating quick replies', { emailId: email.id });
+
+    const bodyLower = (email.body ?? email.bodyPreview).toLowerCase();
+    const isMeetingInvite = this.isMeetingInvite(email);
+    const question = this.extractQuestion(email);
+
+    const replies: SmartReplyDraft[] = [];
+
+    // 1. Brief acknowledgment
+    if (isMeetingInvite) {
+      replies.push({
+        emailId: email.id,
+        replyBody: 'Thanks for the invite. I\'ll be there.',
+        tone: 'brief',
+        confidence: 0.7,
+      });
+    } else if (question) {
+      replies.push({
+        emailId: email.id,
+        replyBody: 'Got it, will review and get back to you shortly.',
+        tone: 'brief',
+        confidence: 0.6,
+      });
+    } else {
+      replies.push({
+        emailId: email.id,
+        replyBody: 'Thanks, received.',
+        tone: 'brief',
+        confidence: 0.7,
+      });
+    }
+
+    // 2. Detailed response template
+    if (isMeetingInvite) {
+      replies.push({
+        emailId: email.id,
+        replyBody: `Thank you for the meeting invitation regarding "${email.subject}". I have reviewed the details and will attend as scheduled. Please let me know if any preparation is needed on my end.`,
+        tone: 'formal',
+        confidence: 0.6,
+      });
+    } else if (question) {
+      replies.push({
+        emailId: email.id,
+        replyBody: `Thank you for your email regarding "${email.subject}". Regarding your question: "${question}" - I will look into this and provide a detailed response.`,
+        tone: 'formal',
+        confidence: 0.5,
+      });
+    } else if (this.isRequest(bodyLower)) {
+      replies.push({
+        emailId: email.id,
+        replyBody: `Thank you for your email regarding "${email.subject}". I have noted the request and will take the necessary action. I will follow up once completed.`,
+        tone: 'formal',
+        confidence: 0.5,
+      });
+    } else {
+      replies.push({
+        emailId: email.id,
+        replyBody: `Thank you for your email regarding "${email.subject}". I have reviewed the information and will follow up if needed.`,
+        tone: 'formal',
+        confidence: 0.5,
+      });
+    }
+
+    // 3. Decline/defer
+    replies.push({
+      emailId: email.id,
+      replyBody: 'Thanks for reaching out. I\'ll get back to you on this.',
+      tone: 'formal',
+      confidence: 0.6,
+    });
+
+    return replies;
+  }
+
+  private isMeetingInvite(email: EmailMessage): boolean {
+    const subjectLower = email.subject.toLowerCase();
+    const bodyLower = (email.body ?? email.bodyPreview).toLowerCase();
+    const meetingKeywords = ['meeting', 'invite', 'invitation', 'calendar', 'schedule', 'call', 'sync'];
+    return meetingKeywords.some(kw => subjectLower.includes(kw) || bodyLower.includes(kw));
+  }
+
+  private extractQuestion(email: EmailMessage): string | null {
+    const body = email.body ?? email.bodyPreview;
+    const sentences = body.split(/[.!?\n]+/).map(s => s.trim()).filter(Boolean);
+    const questionSentence = sentences.find(s => s.includes('?'));
+    return questionSentence ? questionSentence.replace(/\?$/, '').trim() + '?' : null;
+  }
+
+  private isRequest(bodyLower: string): boolean {
+    const requestKeywords = ['please', 'could you', 'can you', 'would you', 'need you to', 'kindly'];
+    return requestKeywords.some(kw => bodyLower.includes(kw));
+  }
+}

package/src/thread-summarizer.ts

@@ -0,0 +1,103 @@
+import { getLogger } from '@auxiora/logger';
+import type { EmailMessage, ThreadSummary } from './types.js';
+
+const logger = getLogger('email-intelligence:thread-summarizer');
+
+const ACTION_ITEM_PREFIXES = ['action:', 'todo:', 'task:'];
+const ACTION_ITEM_KEYWORDS = ['need to', 'should', 'must', 'will'];
+
+export class ThreadSummarizer {
+  summarize(messages: EmailMessage[]): ThreadSummary {
+    if (messages.length === 0) {
+      throw new Error('Cannot summarize an empty thread');
+    }
+
+    const conversationId = messages[0].conversationId;
+    const participants = this.extractParticipants(messages);
+    const keyPoints = this.extractKeyPoints(messages);
+    const actionItems = this.extractActionItems(messages);
+    const latestTimestamp = this.getLatestTimestamp(messages);
+    const subject = messages[0].subject;
+
+    const participantList = participants.length <= 3
+      ? participants.join(', ')
+      : `${participants.slice(0, 3).join(', ')} and ${participants.length - 3} others`;
+
+    const summary = `${messages.length} messages between ${participantList}. Topic: ${subject}. ${keyPoints.length} key points, ${actionItems.length} action items.`;
+
+    logger.debug('Thread summarized', { conversationId, messageCount: messages.length });
+
+    return {
+      conversationId,
+      summary,
+      messageCount: messages.length,
+      participants,
+      keyPoints,
+      actionItems,
+      latestTimestamp,
+    };
+  }
+
+  private extractParticipants(messages: EmailMessage[]): string[] {
+    const participants = new Set<string>();
+    for (const msg of messages) {
+      participants.add(msg.from);
+      for (const to of msg.to) {
+        participants.add(to);
+      }
+      if (msg.cc) {
+        for (const cc of msg.cc) {
+          participants.add(cc);
+        }
+      }
+    }
+    return [...participants];
+  }
+
+  private extractKeyPoints(messages: EmailMessage[]): string[] {
+    const keyPoints: string[] = [];
+    for (const msg of messages) {
+      const body = msg.body ?? msg.bodyPreview;
+      const sentences = body.split(/[.\n]+/).map(s => s.trim()).filter(Boolean);
+      for (const sentence of sentences) {
+        // Questions
+        if (sentence.includes('?')) {
+          keyPoints.push(sentence);
+          continue;
+        }
+        // Sentences with action verbs or dates
+        if (/\b(decided|agreed|confirmed|approved|rejected|deadline|due|scheduled)\b/i.test(sentence)) {
+          keyPoints.push(sentence);
+        }
+      }
+    }
+    return keyPoints;
+  }
+
+  private extractActionItems(messages: EmailMessage[]): string[] {
+    const actionItems: string[] = [];
+    for (const msg of messages) {
+      const body = msg.body ?? msg.bodyPreview;
+      const lines = body.split('\n').map(l => l.trim()).filter(Boolean);
+      for (const line of lines) {
+        const lineLower = line.toLowerCase();
+        // Lines starting with action/todo/task prefixes
+        if (ACTION_ITEM_PREFIXES.some(prefix => lineLower.startsWith(prefix))) {
+          actionItems.push(line);
+          continue;
+        }
+        // Lines containing action keywords
+        if (ACTION_ITEM_KEYWORDS.some(kw => lineLower.includes(kw))) {
+          actionItems.push(line);
+        }
+      }
+    }
+    return actionItems;
+  }
+
+  private getLatestTimestamp(messages: EmailMessage[]): string {
+    return messages.reduce((latest, msg) =>
+      msg.receivedDateTime > latest ? msg.receivedDateTime : latest
+    , messages[0].receivedDateTime);
+  }
+}

package/src/triage.ts

@@ -0,0 +1,147 @@
+import { getLogger } from '@auxiora/logger';
+import type { EmailMessage, TriageResult, TriagePriority } from './types.js';
+
+const logger = getLogger('email-intelligence:triage');
+
+export interface TriageConfig {
+  urgentSenders?: string[];
+  vipDomains?: string[];
+  spamPatterns?: string[];
+  newsletterSenders?: string[];
+}
+
+const URGENT_KEYWORDS = ['urgent', 'asap', 'emergency', 'critical'];
+const ACTION_KEYWORDS = ['please', 'could you', 'can you', 'would you', 'need you to', 'let me know', 'rsvp'];
+
+export class EmailTriageEngine {
+  private config: TriageConfig;
+
+  constructor(config: TriageConfig = {}) {
+    this.config = config;
+  }
+
+  triage(emails: EmailMessage[]): TriageResult[] {
+    return emails.map(email => this.triageSingle(email));
+  }
+
+  triageSingle(email: EmailMessage): TriageResult {
+    const urgent = this.checkUrgent(email);
+    if (urgent) return urgent;
+
+    const action = this.checkAction(email);
+    if (action) return action;
+
+    const newsletter = this.checkNewsletter(email);
+    if (newsletter) return newsletter;
+
+    const spam = this.checkSpam(email);
+    if (spam) return spam;
+
+    logger.debug('Email triaged as FYI', { emailId: email.id });
+    return {
+      emailId: email.id,
+      priority: 'fyi',
+      reason: 'No specific signals detected',
+      suggestedAction: 'none',
+      confidence: 0.5,
+    };
+  }
+
+  private checkUrgent(email: EmailMessage): TriageResult | null {
+    const senderDomain = email.from.split('@')[1]?.toLowerCase() ?? '';
+    const senderAddress = email.from.toLowerCase();
+    const subjectLower = email.subject.toLowerCase();
+
+    // VIP sender
+    if (this.config.urgentSenders?.some(s => senderAddress.includes(s.toLowerCase()))) {
+      return this.makeResult(email.id, 'urgent', 'From VIP sender', 'reply', 0.9);
+    }
+
+    // VIP domain
+    if (this.config.vipDomains?.some(d => senderDomain === d.toLowerCase())) {
+      return this.makeResult(email.id, 'urgent', 'From VIP domain', 'reply', 0.9);
+    }
+
+    // High/urgent importance
+    if (email.importance === 'urgent' || email.importance === 'high') {
+      return this.makeResult(email.id, 'urgent', `Marked as ${email.importance} importance`, 'reply', 0.9);
+    }
+
+    // Urgent keywords in subject
+    if (URGENT_KEYWORDS.some(kw => subjectLower.includes(kw))) {
+      const matched = URGENT_KEYWORDS.find(kw => subjectLower.includes(kw))!;
+      return this.makeResult(email.id, 'urgent', `Subject contains "${matched}"`, 'reply', 0.9);
+    }
+
+    return null;
+  }
+
+  private checkAction(email: EmailMessage): TriageResult | null {
+    if (!email.isDirect) return null;
+
+    const bodyLower = (email.body ?? email.bodyPreview).toLowerCase();
+
+    // Check for question marks
+    if (bodyLower.includes('?')) {
+      return this.makeResult(email.id, 'action', 'Contains a question directed to you', 'reply', 0.8);
+    }
+
+    // Check for action keywords
+    const matched = ACTION_KEYWORDS.find(kw => bodyLower.includes(kw));
+    if (matched) {
+      return this.makeResult(email.id, 'action', `Contains request keyword "${matched}"`, 'reply', 0.7);
+    }
+
+    return null;
+  }
+
+  private checkNewsletter(email: EmailMessage): TriageResult | null {
+    if (email.hasUnsubscribe) {
+      return this.makeResult(email.id, 'newsletter', 'Has List-Unsubscribe header', 'unsubscribe', 0.85);
+    }
+
+    const senderLower = email.from.toLowerCase();
+    if (this.config.newsletterSenders?.some(ns => senderLower.includes(ns.toLowerCase()))) {
+      return this.makeResult(email.id, 'newsletter', 'From known newsletter sender', 'unsubscribe', 0.85);
+    }
+
+    return null;
+  }
+
+  private checkSpam(email: EmailMessage): TriageResult | null {
+    const senderLower = email.from.toLowerCase();
+
+    // Check spam patterns
+    if (this.config.spamPatterns?.some(sp => senderLower.includes(sp.toLowerCase()) || email.subject.toLowerCase().includes(sp.toLowerCase()))) {
+      return this.makeResult(email.id, 'spam', 'Matches spam pattern', 'archive', 0.6);
+    }
+
+    // Excessive caps in subject (more than 50% uppercase, at least 5 letters)
+    const letters = email.subject.replace(/[^a-zA-Z]/g, '');
+    if (letters.length >= 5) {
+      const upperCount = (email.subject.match(/[A-Z]/g) ?? []).length;
+      if (upperCount / letters.length > 0.5) {
+        return this.makeResult(email.id, 'spam', 'Subject has excessive capitalization', 'archive', 0.6);
+      }
+    }
+
+    // Body contains 'unsubscribe' but no List-Unsubscribe header
+    const bodyLower = (email.body ?? email.bodyPreview).toLowerCase();
+    if (bodyLower.includes('unsubscribe') && !email.hasUnsubscribe) {
+      return this.makeResult(email.id, 'spam', 'Contains "unsubscribe" without proper header', 'archive', 0.6);
+    }
+
+    return null;
+  }
+
+  private makeResult(
+    emailId: string,
+    priority: TriagePriority,
+    reason: string,
+    suggestedAction: TriageResult['suggestedAction'],
+    confidence: number,
+  ): TriageResult {
+    logger.debug(`Email triaged as ${priority}`, { emailId, reason });
+    return { emailId, priority, reason, suggestedAction, confidence };
+  }
+}