@realtimex/email-automator 2.21.5 → 2.21.7

package/api/src/routes/index.ts

@@ -10,7 +10,6 @@ import migrateRoutes from './migrate.js';
 import sdkRoutes from './sdk.js';
 import ttsRoutes from './tts.js';
 import agentRoutes from './agent.js';
-import rulePacksRoutes from './rulePacks.js';
 import draftsRoutes from './drafts.js';
 
 
@@ -28,7 +27,6 @@ router.use('/migrate', migrateRoutes);
 router.use('/sdk', sdkRoutes);
 router.use('/tts', ttsRoutes);
 router.use('/agent', agentRoutes);
-router.use('/rule-packs', rulePacksRoutes);
 router.use('/drafts', draftsRoutes);
 
 

package/api/src/services/DefaultRuleService.ts

@@ -0,0 +1,98 @@
+/**
+ * Default Rule Service
+ *
+ * Handles seeding of default system rules for users.
+ */
+
+import { SupabaseClient } from '@supabase/supabase-js';
+import { createLogger } from '../utils/logger.js';
+import { ALL_DEFAULT_RULES } from './defaultRules/index.js';
+
+const logger = createLogger('DefaultRuleService');
+
+export class DefaultRuleService {
+  constructor(private supabase: SupabaseClient) {}
+
+  /**
+   * Ensure all default rules are seeded for the user
+   * Called during sync or onboarding
+   */
+  async ensureDefaultRules(userId: string): Promise<{ success: boolean; installed: boolean }> {
+    try {
+      // Check if user has already been seeded (check if any system-managed rules exist)
+      const { data: existingRules } = await this.supabase
+        .from('rules')
+        .select('id')
+        .eq('user_id', userId)
+        .eq('is_system_managed', true)
+        .limit(1);
+
+      if (existingRules && existingRules.length > 0) {
+        return { success: true, installed: false };
+      }
+
+      logger.info(`Seeding default rules for user ${userId}`);
+
+      let totalRulesCreated = 0;
+
+      for (const rule of ALL_DEFAULT_RULES) {
+        // Check if rule already exists (by rule_template_id)
+        const { data: existingRule } = await this.supabase
+          .from('rules')
+          .select('id')
+          .eq('user_id', userId)
+          .eq('rule_template_id', rule.id)
+          .single();
+
+        if (existingRule) continue;
+
+        const { error } = await this.supabase
+          .from('rules')
+          .insert({
+            user_id: userId,
+            name: rule.name,
+            description: rule.description,
+            intent: rule.intent,
+            priority: rule.priority,
+            condition: rule.condition as any,
+            actions: rule.actions as any,
+            instructions: rule.instructions,
+            is_enabled: rule.is_enabled_by_default, // Default enable state from rule
+            category: rule.category,
+            rule_template_id: rule.id,
+            is_system_managed: true
+          });
+
+        if (error) {
+          logger.error(`Failed to create rule '${rule.id}'`, error);
+          // Continue with other rules instead of failing entirely
+        } else {
+          totalRulesCreated++;
+        }
+      }
+
+      logger.info(`Successfully seeded ${totalRulesCreated} default rules for user ${userId}`);
+      return { success: true, installed: true };
+
+    } catch (error: any) {
+      logger.error('Failed to seed default rules', error);
+      return { success: false, installed: false };
+    }
+  }
+}
+
+/**
+ * Get singleton instance (convenience)
+ */
+let defaultInstance: DefaultRuleService | null = null;
+
+export function getDefaultRuleService(supabase: SupabaseClient): DefaultRuleService {
+  if (!defaultInstance) {
+    defaultInstance = new DefaultRuleService(supabase);
+  }
+  return defaultInstance;
+}
+
+// Export legacy name for backward compatibility during transition
+export const RulePackService = DefaultRuleService;
+export const getRulePackService = getDefaultRuleService;

package/api/src/services/defaultRules/development.ts

@@ -0,0 +1,135 @@
+/**
+ * Development Rules
+ *
+ * Rules for software engineers and technical teams:
+ * - System alert prioritization
+ * - CI/CD and monitoring notifications
+ * - Code review highlights
+ * - Project management tool organization
+ */
+
+import { DefaultRule } from './types.js';
+
+export const DEVELOPMENT_RULES: DefaultRule[] = [
+  {
+    id: 'system-alerts-prioritizer',
+    category: 'development',
+    name: '🚨 System Alerts Prioritizer',
+    intent: 'Prioritize critical system alerts and incidents',
+    description: 'Stars critical alerts from AWS, Datadog, Sentry, PagerDuty while archiving info-level notifications',
+    condition: {
+      or: [
+        {
+          sender_domain: 'aws.amazon.com',
+          contains_keywords: ['critical', 'down', 'outage', 'incident']
+        },
+        {
+          sender_domain: 'datadoghq.com',
+          contains_keywords: ['alert', 'critical', 'error rate']
+        },
+        {
+          sender_domain: 'sentry.io',
+          contains_keywords: ['new issue', 'regression', 'error']
+        },
+        {
+          sender_domain: 'pagerduty.com',
+          contains_keywords: ['triggered', 'incident']
+        }
+      ]
+    },
+    actions: ['star', 'important', 'pin'],
+    priority: 100,
+    is_enabled_by_default: true
+  },
+  {
+    id: 'system-info-organizer',
+    category: 'development',
+    name: '⚠️ System Info Organizer',
+    intent: 'Archive non-critical system notifications',
+    description: 'Archives info and warning level alerts from monitoring tools',
+    condition: {
+      or: [
+        {
+          sender_domain: 'aws.amazon.com',
+          not: {
+            contains_keywords: ['critical', 'down', 'outage']
+          }
+        },
+        {
+          sender_domain: 'datadoghq.com',
+          contains_keywords: ['info', 'warning', 'recovered']
+        },
+        {
+          sender_domain: 'circleci.com'
+        },
+        {
+          sender_domain: 'github.com',
+          contains_keywords: ['build', 'workflow']
+        }
+      ]
+    },
+    actions: ['label:Logs', 'archive'],
+    priority: 20,
+    is_enabled_by_default: true
+  },
+  {
+    id: 'project-management-organizer',
+    category: 'development',
+    name: '🔨 Project Management Organizer',
+    intent: 'Organize Jira, GitHub, and project management notifications',
+    description: 'Archives project management notifications unless you\'re directly assigned',
+    condition: {
+      or: [
+        {
+          sender_domain: 'atlassian.net',
+          not: {
+            contains_keywords: ['assigned to you', 'mentioned you']
+          }
+        },
+        {
+          sender_domain: 'github.com',
+          not: {
+            contains_keywords: ['assigned', 'review requested', '@']
+          }
+        },
+        {
+          sender_domain: 'asana.com',
+          not: {
+            contains_keywords: ['assigned to you']
+          }
+        },
+        {
+          sender_domain: 'trello.com'
+        },
+        {
+          sender_domain: 'monday.com'
+        }
+      ]
+    },
+    actions: ['label:Tools', 'archive'],
+    priority: 15,
+    is_enabled_by_default: true
+  },
+  {
+    id: 'code-reviews-highlighter',
+    category: 'development',
+    name: '👀 Code Review Highlighter',
+    intent: 'Highlight pull request reviews and assignments',
+    description: 'Stars GitHub/GitLab notifications where your review is requested',
+    condition: {
+      or: [
+        {
+          sender_domain: 'github.com',
+          contains_keywords: ['review requested', 'requested your review']
+        },
+        {
+          sender_domain: 'gitlab.com',
+          contains_keywords: ['review', 'merge request']
+        }
+      ]
+    },
+    actions: ['star'],
+    priority: 80,
+    is_enabled_by_default: true
+  }
+];

package/api/src/services/defaultRules/emailOrg.ts

@@ -0,0 +1,154 @@
+/**
+ * Email Organization Rules
+ *
+ * Rules for keeping inbox clean through automated organization:
+ * - Newsletter management
+ * - Cold outreach filtering
+ * - CC/FYI organization
+ * - Receipt labeling
+ */
+
+import { DefaultRule } from './types.js';
+
+export const EMAIL_ORG_RULES: DefaultRule[] = [
+  {
+    id: 'newsletters-auto-archive',
+    category: 'email_organization',
+    name: '📚 Newsletter Sweeper',
+    intent: 'Keep newsletters organized and out of main inbox',
+    description: 'Automatically archives newsletters and mass-marketing emails so you can read them later without inbox clutter',
+    condition: {
+      category: 'newsletter',
+      confidence_gt: 0.7
+    },
+    actions: ['archive'],
+    priority: 10,
+    is_enabled_by_default: true
+  },
+  {
+    id: 'cold-outreach-filter',
+    category: 'email_organization',
+    name: '❄️ Cold Outreach Filter',
+    intent: 'Filter unsolicited sales and marketing emails',
+    description: 'Identifies and archives cold emails from unknown senders with sales language',
+    condition: {
+      or: [
+        {
+          // High-confidence promotional emails that are first contact
+          category: 'promotional',
+          confidence_gt: 0.85,
+          is_first_contact: true
+        },
+        {
+          // Spam category (very high confidence)
+          category: 'spam',
+          confidence_gt: 0.9
+        }
+      ]
+    },
+    actions: ['archive'],
+    priority: 20,
+    is_enabled_by_default: true
+  },
+  {
+    id: 'cc-fyi-organizer',
+    category: 'email_organization',
+    name: '👀 CC/FYI Organizer',
+    intent: 'Keep inbox focused on direct communications',
+    description: 'Archives emails where you\'re CC\'d in group threads, keeping your inbox for direct messages',
+    condition: {
+      recipient_type: 'cc',
+      recipient_count_gt: 3  // Group emails (more than 3 recipients)
+    },
+    actions: ['archive'],
+    priority: 5,
+    is_enabled_by_default: true
+  },
+  {
+    id: 'receipts-organizer',
+    category: 'email_organization',
+    name: '🧾 Receipt Organizer',
+    intent: 'Auto-label receipts for easy tax and expense retrieval',
+    description: 'Labels transactional emails (receipts, invoices, confirmations) for easy searching',
+    condition: {
+      category: 'transactional',
+      contains_keywords: ['receipt', 'invoice', 'payment', 'order confirmation', 'purchase'],
+      confidence_gt: 0.75
+    },
+    actions: ['label:Finance/Receipts'],
+    priority: 15,
+    is_enabled_by_default: true
+  },
+  {
+    id: 'social-notifications-archiver',
+    category: 'email_organization',
+    name: '🔔 Social Media Archiver',
+    intent: 'Archive social media notifications',
+    description: 'Automatically archives LinkedIn, Twitter, and other social notifications',
+    condition: {
+      category: 'social',
+      confidence_gt: 0.8
+    },
+    actions: ['archive'],
+    priority: 5,
+    is_enabled_by_default: true
+  },
+  {
+    id: 'calendar-responses-cleaner',
+    category: 'email_organization',
+    name: '📅 Calendar Response Cleaner',
+    intent: 'Clean up calendar accept/decline notifications',
+    description: 'Deletes automatic calendar responses that don\'t contain custom messages',
+    condition: {
+      contains_keywords: ['accepted:', 'declined:', 'tentative:'],
+      not: {
+        recipient_type: 'to'  // Don't delete if you're the only recipient
+      }
+    },
+    actions: ['delete'],
+    priority: 10,
+    is_enabled_by_default: false  // Disabled by default - deletion is aggressive
+  },
+  {
+    id: 'drive-shares-organizer',
+    category: 'email_organization',
+    name: '📂 Drive Share Organizer',
+    intent: 'Archive Google Drive/Docs share notifications',
+    description: 'Archives notifications about shared documents (usually redundant)',
+    condition: {
+      sender_domain: 'google.com',
+      contains_keywords: ['shared', 'document', 'commented on', 'mentioned you in']
+    },
+    actions: ['label:Drive', 'archive'],
+    priority: 5,
+    is_enabled_by_default: true
+  },
+  {
+    id: 'meeting-recordings-archiver',
+    category: 'email_organization',
+    name: '📹 Meeting Recording Archiver',
+    intent: 'Archive meeting recordings and transcripts',
+    description: 'Automatically archives Zoom, Teams, and AI note-taker recordings',
+    condition: {
+      or: [
+        {
+          sender_domain: 'zoom.us',
+          contains_keywords: ['recording', 'cloud recording']
+        },
+        {
+          sender_domain: 'microsoft.com',
+          contains_keywords: ['recording', 'teams recording']
+        },
+        {
+          sender_domain: 'fireflies.ai'
+        },
+        {
+          sender_domain: 'otter.ai'
+        }
+      ]
+    },
+    actions: ['label:Recordings', 'archive'],
+    priority: 10,
+    is_enabled_by_default: true
+  }
+];

package/api/src/services/defaultRules/index.ts

@@ -0,0 +1,28 @@
+/**
+ * Default Rules Index
+ *
+ * Exports all default rules organized by category.
+ * Rules are now flat arrays grouped by category instead of packs.
+ */
+
+import { DefaultRule } from './types.js';
+import { EMAIL_ORG_RULES } from './emailOrg.js';
+import { PRIORITY_RULES } from './priority.js';
+import { DEVELOPMENT_RULES } from './development.js';
+import { SALES_BUSINESS_RULES } from './salesBusiness.js';
+import { OPERATIONS_RULES } from './operations.js';
+
+/**
+ * All default rules available in the system.
+ * This is a flat array that can be filtered/searched as needed.
+ */
+export const ALL_DEFAULT_RULES: DefaultRule[] = [
+  ...EMAIL_ORG_RULES,
+  ...PRIORITY_RULES,
+  ...DEVELOPMENT_RULES,
+  ...SALES_BUSINESS_RULES,
+  ...OPERATIONS_RULES,
+];
+
+// Re-export types for convenience
+export type { DefaultRule, RuleCategory, EmailCategory, EmailAction, EnhancedRuleCondition } from './types.js';

package/api/src/services/defaultRules/operations.ts

@@ -0,0 +1,134 @@
+/**
+ * Operations Rules
+ *
+ * Rules for support, operations, and customer success teams:
+ * - Support ticket organization
+ * - System monitoring alerts
+ * - Internal announcements
+ */
+
+import { DefaultRule } from './types.js';
+
+export const OPERATIONS_RULES: DefaultRule[] = [
+  {
+    id: 'support-tickets-organizer',
+    category: 'operations',
+    name: '🎫 Support Ticket Organizer',
+    intent: 'Organize customer support tickets and cases',
+    description: 'Labels support tickets from Zendesk, Intercom, and other support tools',
+    condition: {
+      or: [
+        {
+          sender_domain: 'zendesk.com'
+        },
+        {
+          sender_domain: 'intercom.io'
+        },
+        {
+          sender_domain: 'freshdesk.com'
+        },
+        {
+          contains_keywords: ['ticket', 'case created', 'support request', 'customer inquiry']
+        },
+        {
+          category: 'support',
+          confidence_gt: 0.7
+        }
+      ]
+    },
+    actions: ['label:Support'],
+    priority: 80,
+    is_enabled_by_default: true
+  },
+  {
+    id: 'urgent-tickets-highlighter',
+    category: 'operations',
+    name: '🚨 Urgent Ticket Highlighter',
+    intent: 'Highlight high-priority and urgent customer issues',
+    description: 'Stars urgent support tickets that need immediate attention',
+    condition: {
+      category: 'support',
+      or: [
+        {
+          contains_keywords: ['urgent', 'emergency', 'critical', 'down', 'not working']
+        },
+        {
+          ai_priority: 'High'
+        }
+      ]
+    },
+    actions: ['star', 'important'],
+    priority: 100,
+    is_enabled_by_default: true
+  },
+  {
+    id: 'system-monitoring-organizer',
+    category: 'operations',
+    name: '⚠️ System Alerts Organizer',
+    intent: 'Organize system monitoring and uptime alerts',
+    description: 'Labels system alerts while starring critical incidents',
+    condition: {
+      or: [
+        {
+          sender_domain: 'pingdom.com'
+        },
+        {
+          sender_domain: 'uptimerobot.com'
+        },
+        {
+          sender_domain: 'statuspage.io'
+        },
+        {
+          sender_domain: 'datadog.com'
+        }
+      ]
+    },
+    actions: ['label:Monitoring'],
+    priority: 70,
+    is_enabled_by_default: true
+  },
+  {
+    id: 'critical-system-alerts-highlighter',
+    category: 'operations',
+    name: '🔥 Critical Alert Highlighter',
+    intent: 'Highlight critical system incidents',
+    description: 'Stars critical alerts that indicate system downtime or major issues',
+    condition: {
+      or: [
+        {
+          sender_domain: 'pingdom.com',
+          contains_keywords: ['down', 'offline']
+        },
+        {
+          sender_domain: 'datadog.com',
+          contains_keywords: ['critical', 'incident']
+        }
+      ]
+    },
+    actions: ['star', 'important', 'pin'],
+    priority: 100,
+    is_enabled_by_default: true
+  },
+  {
+    id: 'internal-announcements',
+    category: 'operations',
+    name: '🏢 Internal Announcements',
+    intent: 'Keep internal company announcements in inbox',
+    description: 'Keeps HR, team, and company-wide announcements visible (doesn\'t archive)',
+    condition: {
+      or: [
+        {
+          category: 'internal',
+          confidence_gt: 0.7
+        },
+        {
+          sender_domain: 'company.com',  // This should be customizable
+          contains_keywords: ['all-hands', 'team announcement', 'company update']
+        }
+      ]
+    },
+    actions: [],  // No actions - keep in inbox
+    priority: 50,
+    is_enabled_by_default: true
+  }
+];

package/api/src/services/defaultRules/priority.ts

@@ -0,0 +1,114 @@
+/**
+ * Priority Alert Rules
+ *
+ * Rules for highlighting important and urgent communications:
+ * - VIP client/customer prioritization
+ * - Direct questions requiring responses
+ * - Legal documents and contracts
+ * - Travel itineraries
+ */
+
+import { DefaultRule } from './types.js';
+
+export const PRIORITY_RULES: DefaultRule[] = [
+  {
+    id: 'vip-clients-prioritizer',
+    category: 'priority_alerts',
+    name: '⭐ VIP Client Prioritizer',
+    intent: 'Star and prioritize emails from key clients and partners',
+    description: 'Automatically highlights emails from VIP contacts and important clients',
+    condition: {
+      or: [
+        {
+          sender_is_vip: true  // From VIP list (requires VIP management feature)
+        },
+        {
+          category: 'client',
+          ai_priority: 'High'
+        }
+      ]
+    },
+    actions: ['star', 'important'],
+    priority: 100,
+    is_enabled_by_default: true
+  },
+  {
+    id: 'direct-questions-highlighter',
+    category: 'priority_alerts',
+    name: '⚡ Direct Questions Highlighter',
+    intent: 'Highlight emails that require your direct input',
+    description: 'Identifies emails where you\'re the only recipient and a response is clearly needed',
+    condition: {
+      recipient_type: 'to',
+      recipient_count_gt: 0,  // Only sent to you
+      contains_keywords: ['?', 'your input', 'your thoughts', 'need your', 'awaiting your', 'question', 'wondering', 'can you', 'could you'],
+      not: {
+        category: 'newsletter'  // Exclude automated newsletters
+      }
+    },
+    actions: ['important'],
+    priority: 90,
+    is_enabled_by_default: true
+  },
+  {
+    id: 'travel-itineraries-organizer',
+    category: 'priority_alerts',
+    name: '✈️ Travel Organizer',
+    intent: 'Organize flight confirmations, hotel bookings, and itineraries',
+    description: 'Labels travel-related emails for easy access before trips',
+    condition: {
+      or: [
+        {
+          sender_domain: 'delta.com'
+        },
+        {
+          sender_domain: 'united.com'
+        },
+        {
+          sender_domain: 'aa.com'
+        },
+        {
+          sender_domain: 'hilton.com'
+        },
+        {
+          sender_domain: 'marriott.com'
+        },
+        {
+          sender_domain: 'airbnb.com'
+        },
+        {
+          contains_keywords: ['itinerary', 'flight confirmation', 'booking confirmation', 'reservation confirmed']
+        }
+      ]
+    },
+    actions: ['label:Travel', 'star'],
+    priority: 70,
+    is_enabled_by_default: true
+  },
+  {
+    id: 'legal-contracts-highlighter',
+    category: 'priority_alerts',
+    name: '⚖️ Legal & Contracts Highlighter',
+    intent: 'Highlight important legal documents and contracts',
+    description: 'Stars emails containing contracts, NDAs, and legal documents requiring signature',
+    condition: {
+      or: [
+        {
+          sender_domain: 'docusign.com'
+        },
+        {
+          sender_domain: 'hellosign.com'
+        },
+        {
+          sender_domain: 'pandadoc.com'
+        },
+        {
+          contains_keywords: ['nda', 'agreement', 'contract', 'sign', 'signature required', 'proposal', 'quote']
+        }
+      ]
+    },
+    actions: ['label:Legal', 'star'],
+    priority: 95,
+    is_enabled_by_default: true
+  }
+];