catalist-support-agent 1.0.0

package/dist/intake/normalizer.js

@@ -0,0 +1,309 @@
+/**
+ * Message Normalizer
+ *
+ * Transforms channel-specific message formats into a unified InboundMessage interface.
+ * Handles content extraction, sender identification, and metadata normalization.
+ */
+import { createHash } from 'crypto';
+import { createMessageId } from '../types.js';
+import { IntakeError } from '../errors.js';
+import { scanMessageContent } from '../brand/index.js';
+// =============================================================================
+// Normalizer Class
+// =============================================================================
+export class MessageNormalizer {
+    /**
+     * Normalize a Postmark inbound email
+     */
+    normalizePostmarkEmail(email) {
+        const messageId = createMessageId(email.MessageID);
+        // Extract sender info
+        const sender = {
+            email: email.FromFull?.Email || email.From,
+            name: email.FromFull?.Name || email.FromName,
+        };
+        // Build email metadata
+        const metadata = {
+            type: 'email',
+            messageId: email.MessageID,
+            inReplyTo: email.InReplyTo,
+            references: email.References?.split(/\s+/).filter(Boolean),
+            headers: this.headersToRecord(email.Headers),
+            fromAddress: sender.email || '',
+            toAddresses: email.ToFull?.map((t) => t.Email) || [email.To],
+            ccAddresses: email.CcFull?.map((c) => c.Email),
+        };
+        // Extract content (prefer stripped reply, fall back to full body)
+        const text = email.StrippedTextReply || email.TextBody || '';
+        const html = email.HtmlBody;
+        // Normalize attachments
+        const attachments = this.normalizePostmarkAttachments(email.Attachments);
+        return {
+            id: messageId,
+            channel: 'email',
+            direction: 'inbound',
+            content: {
+                text,
+                html,
+                subject: email.Subject,
+            },
+            sender,
+            receivedAt: new Date(email.Date).toISOString(),
+            metadata,
+            attachments,
+        };
+    }
+    /**
+     * Normalize a Twilio inbound SMS
+     */
+    normalizeTwilioSms(sms) {
+        const messageId = createMessageId(sms.MessageSid);
+        // Extract sender info
+        const sender = {
+            phone: sms.From,
+        };
+        // Build SMS metadata
+        const metadata = {
+            type: 'sms',
+            messageSid: sms.MessageSid,
+            fromNumber: sms.From,
+            toNumber: sms.To,
+            numSegments: sms.NumSegments ? parseInt(sms.NumSegments, 10) : undefined,
+        };
+        // Handle MMS attachments
+        const attachments = this.normalizeTwilioMedia(sms);
+        return {
+            id: messageId,
+            channel: 'sms',
+            direction: 'inbound',
+            content: {
+                text: sms.Body || '',
+            },
+            sender,
+            receivedAt: new Date().toISOString(),
+            metadata,
+            attachments,
+        };
+    }
+    /**
+     * Normalize a Slack message event
+     */
+    normalizeSlackMessage(event, teamId) {
+        const messageId = createMessageId(`${event.channel}-${event.ts}`);
+        // Extract sender info
+        const sender = {
+            slackUserId: event.user,
+        };
+        // Build Slack metadata
+        const metadata = {
+            type: 'slack',
+            teamId,
+            channelId: event.channel,
+            userId: event.user,
+            threadTs: event.thread_ts,
+            eventTs: event.event_ts,
+        };
+        // Handle Slack file attachments
+        const attachments = this.normalizeSlackFiles(event.files);
+        return {
+            id: messageId,
+            channel: 'slack',
+            direction: 'inbound',
+            content: {
+                text: event.text || '',
+            },
+            sender,
+            receivedAt: new Date(parseFloat(event.ts) * 1000).toISOString(),
+            metadata,
+            attachments,
+        };
+    }
+    /**
+     * Convert Postmark headers array to record
+     */
+    headersToRecord(headers) {
+        if (!headers || headers.length === 0) {
+            return undefined;
+        }
+        const record = {};
+        for (const header of headers) {
+            record[header.Name] = header.Value;
+        }
+        return record;
+    }
+    /**
+     * Normalize Postmark attachments
+     */
+    normalizePostmarkAttachments(attachments) {
+        if (!attachments || attachments.length === 0) {
+            return undefined;
+        }
+        return attachments.map((att, index) => ({
+            id: att.ContentID || `attachment-${index}`,
+            filename: att.Name,
+            contentType: att.ContentType,
+            size: att.ContentLength,
+        }));
+    }
+    /**
+     * Normalize Twilio MMS media
+     */
+    normalizeTwilioMedia(sms) {
+        const numMedia = parseInt(sms.NumMedia || '0', 10);
+        if (numMedia === 0) {
+            return undefined;
+        }
+        const attachments = [];
+        for (let i = 0; i < numMedia; i++) {
+            const urlKey = `MediaUrl${i}`;
+            const typeKey = `MediaContentType${i}`;
+            const url = sms[urlKey];
+            const contentType = sms[typeKey];
+            if (url) {
+                attachments.push({
+                    id: `media-${i}`,
+                    filename: `media-${i}`,
+                    contentType: contentType || 'application/octet-stream',
+                    size: 0, // Size not provided by Twilio
+                    url,
+                });
+            }
+        }
+        return attachments.length > 0 ? attachments : undefined;
+    }
+    /**
+     * Normalize Slack file attachments
+     */
+    normalizeSlackFiles(files) {
+        if (!files || files.length === 0) {
+            return undefined;
+        }
+        return files.map((file) => ({
+            id: file.id,
+            filename: file.name,
+            contentType: file.mimetype,
+            size: file.size,
+            url: file.url_private_download || file.url_private,
+        }));
+    }
+}
+// =============================================================================
+// Utility Functions
+// =============================================================================
+/**
+ * Generate a content hash for deduplication
+ */
+export function generateContentHash(message) {
+    const content = [
+        message.channel,
+        message.sender.email || message.sender.phone || message.sender.slackUserId,
+        message.content.text,
+        message.content.subject,
+    ]
+        .filter(Boolean)
+        .join('|');
+    return createHash('sha256').update(content).digest('hex').substring(0, 32);
+}
+/**
+ * Extract conversation thread identifier from message
+ */
+export function extractThreadIdentifier(message) {
+    if (message.metadata.type === 'email') {
+        // Use References header for email threading
+        const references = message.metadata.references;
+        if (references && references.length > 0) {
+            return references[0]; // First reference is usually the original message
+        }
+        return message.metadata.inReplyTo;
+    }
+    if (message.metadata.type === 'slack') {
+        // Use thread_ts for Slack threading
+        return message.metadata.threadTs;
+    }
+    // SMS doesn't have built-in threading - use sender identifier
+    if (message.metadata.type === 'sms') {
+        return message.metadata.fromNumber;
+    }
+    return undefined;
+}
+/**
+ * Get sender identifier for customer matching
+ */
+export function getSenderIdentifier(message) {
+    if (message.sender.email) {
+        return { type: 'email', value: message.sender.email.toLowerCase() };
+    }
+    if (message.sender.phone) {
+        return { type: 'phone', value: normalizePhoneNumber(message.sender.phone) };
+    }
+    if (message.sender.slackUserId) {
+        return { type: 'slack', value: message.sender.slackUserId };
+    }
+    return undefined;
+}
+/**
+ * Normalize phone number to E.164 format
+ */
+export function normalizePhoneNumber(phone) {
+    // Remove all non-digit characters except leading +
+    const cleaned = phone.replace(/[^\d+]/g, '');
+    // If it starts with +, assume it's already E.164
+    if (cleaned.startsWith('+')) {
+        return cleaned;
+    }
+    // If it's 10 digits, assume US number
+    if (cleaned.length === 10) {
+        return `+1${cleaned}`;
+    }
+    // If it's 11 digits starting with 1, add +
+    if (cleaned.length === 11 && cleaned.startsWith('1')) {
+        return `+${cleaned}`;
+    }
+    // Return with + prefix
+    return cleaned.startsWith('+') ? cleaned : `+${cleaned}`;
+}
+/**
+ * Validate message content is not empty
+ */
+export function validateMessageContent(message) {
+    const hasContent = message.content.text?.trim() || message.content.html?.trim() || message.content.subject?.trim();
+    if (!hasContent) {
+        throw new IntakeError('Message has no content', message.channel, 'normalization', {
+            messageId: message.id,
+        });
+    }
+}
+/**
+ * Check message for forbidden terms and annotate
+ */
+export function scanAndAnnotateMessage(message) {
+    const scanResult = scanMessageContent(message.content);
+    return {
+        message,
+        hasForbiddenTerms: scanResult.hasForbiddenTerms,
+        detectedTerms: scanResult.detectedTerms,
+    };
+}
+// =============================================================================
+// Singleton
+// =============================================================================
+let normalizer = null;
+export function getMessageNormalizer() {
+    if (!normalizer) {
+        normalizer = new MessageNormalizer();
+    }
+    return normalizer;
+}
+// =============================================================================
+// High-Level Normalization Functions
+// =============================================================================
+export function normalizePostmarkEmail(email) {
+    return getMessageNormalizer().normalizePostmarkEmail(email);
+}
+export function normalizeTwilioSms(sms) {
+    return getMessageNormalizer().normalizeTwilioSms(sms);
+}
+export function normalizeSlackMessage(event, teamId) {
+    return getMessageNormalizer().normalizeSlackMessage(event, teamId);
+}
+//# sourceMappingURL=normalizer.js.map

package/dist/intake/normalizer.js.map

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

package/dist/intake/postmark.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Postmark Inbound Email Handler
+ *
+ * Receives incoming emails via Postmark webhook, validates signatures,
+ * and normalizes email content into the standard message format.
+ */
+import type { InboundMessage } from '../types.js';
+import { type PostmarkInboundEmail } from './normalizer.js';
+export interface PostmarkWebhookPayload extends PostmarkInboundEmail {
+    OriginalRecipient?: string;
+    Tag?: string;
+}
+export interface PostmarkProcessResult {
+    success: boolean;
+    message?: InboundMessage;
+    contentHash?: string;
+    hasForbiddenTerms: boolean;
+    detectedTerms: string[];
+    error?: string;
+}
+/**
+ * Validate Postmark webhook signature
+ *
+ * Note: Postmark uses a webhook token that's included in the URL
+ * rather than signature-based validation. However, we can validate
+ * the token if configured.
+ */
+export declare function validatePostmarkWebhook(payload: unknown, webhookToken?: string): payload is PostmarkWebhookPayload;
+/**
+ * Generate HMAC signature for webhook validation (if using custom signing)
+ */
+export declare function generatePostmarkSignature(body: string, secret: string): string;
+/**
+ * Process an inbound Postmark email
+ */
+export declare function processPostmarkEmail(payload: PostmarkWebhookPayload): Promise<PostmarkProcessResult>;
+/**
+ * Full webhook handler for Postmark inbound emails
+ */
+export declare function handlePostmarkInbound(rawBody: string, webhookToken?: string): Promise<PostmarkProcessResult>;
+/**
+ * Check if email is likely an auto-reply or out-of-office
+ */
+export declare function isAutoReply(email: PostmarkInboundEmail): boolean;
+/**
+ * Check if email is likely spam or marketing
+ */
+export declare function isLikelySpam(email: PostmarkInboundEmail): boolean;
+/**
+ * Classify email for processing
+ */
+export declare function classifyEmail(email: PostmarkInboundEmail): {
+    shouldProcess: boolean;
+    reason?: string;
+    classification: 'support' | 'auto_reply' | 'spam_marketing' | 'unknown';
+};
+/**
+ * Extract thread information from email headers
+ */
+export declare function extractEmailThread(email: PostmarkInboundEmail): {
+    isReply: boolean;
+    originalMessageId?: string;
+    threadMessageIds: string[];
+};
+/**
+ * Extract quoted content from email body
+ */
+export declare function extractQuotedContent(body: string): {
+    newContent: string;
+    quotedContent?: string;
+};
+//# sourceMappingURL=postmark.d.ts.map

package/dist/intake/postmark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postmark.d.ts","sourceRoot":"","sources":["../../src/intake/postmark.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAKL,KAAK,oBAAoB,EAC1B,MAAM,iBAAiB,CAAC;AAMzB,MAAM,WAAW,sBAAuB,SAAQ,oBAAoB;IAElE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,IAAI,sBAAsB,CAmBnC;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9E;AAMD;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAsChC;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,qBAAqB,CAAC,CAuBhC;AAMD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAkDhE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CA4CjE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,oBAAoB,GAAG;IAC1D,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,SAAS,GAAG,YAAY,GAAG,gBAAgB,GAAG,SAAS,CAAC;CACzE,CA+BA;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,oBAAoB,GAAG;IAC/D,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B,CAYA;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAuBA"}

package/dist/intake/postmark.js

@@ -0,0 +1,276 @@
+/**
+ * Postmark Inbound Email Handler
+ *
+ * Receives incoming emails via Postmark webhook, validates signatures,
+ * and normalizes email content into the standard message format.
+ */
+import { createHmac } from 'crypto';
+import { config } from '../config.js';
+import { IntakeError, WebhookValidationError } from '../errors.js';
+import { normalizePostmarkEmail, generateContentHash, validateMessageContent, scanAndAnnotateMessage, } from './normalizer.js';
+// =============================================================================
+// Signature Validation
+// =============================================================================
+/**
+ * Validate Postmark webhook signature
+ *
+ * Note: Postmark uses a webhook token that's included in the URL
+ * rather than signature-based validation. However, we can validate
+ * the token if configured.
+ */
+export function validatePostmarkWebhook(payload, webhookToken) {
+    // If webhook token is configured, validate it was provided
+    if (config.postmark.webhookToken && webhookToken !== config.postmark.webhookToken) {
+        return false;
+    }
+    // Validate required fields exist
+    if (!payload || typeof payload !== 'object') {
+        return false;
+    }
+    const email = payload;
+    // Must have From and MessageID at minimum
+    if (!email.From || !email.MessageID) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Generate HMAC signature for webhook validation (if using custom signing)
+ */
+export function generatePostmarkSignature(body, secret) {
+    return createHmac('sha256', secret).update(body).digest('hex');
+}
+// =============================================================================
+// Email Processing
+// =============================================================================
+/**
+ * Process an inbound Postmark email
+ */
+export async function processPostmarkEmail(payload) {
+    try {
+        // Normalize the email into standard message format
+        const message = normalizePostmarkEmail(payload);
+        // Validate content exists
+        validateMessageContent(message);
+        // Generate content hash for deduplication
+        const contentHash = generateContentHash(message);
+        // Scan for forbidden terms
+        const { hasForbiddenTerms, detectedTerms } = scanAndAnnotateMessage(message);
+        return {
+            success: true,
+            message,
+            contentHash,
+            hasForbiddenTerms,
+            detectedTerms,
+        };
+    }
+    catch (error) {
+        if (error instanceof IntakeError) {
+            return {
+                success: false,
+                hasForbiddenTerms: false,
+                detectedTerms: [],
+                error: error.message,
+            };
+        }
+        return {
+            success: false,
+            hasForbiddenTerms: false,
+            detectedTerms: [],
+            error: error instanceof Error ? error.message : 'Unknown error processing email',
+        };
+    }
+}
+/**
+ * Full webhook handler for Postmark inbound emails
+ */
+export async function handlePostmarkInbound(rawBody, webhookToken) {
+    // Parse JSON body
+    let payload;
+    try {
+        payload = JSON.parse(rawBody);
+    }
+    catch {
+        return {
+            success: false,
+            hasForbiddenTerms: false,
+            detectedTerms: [],
+            error: 'Invalid JSON payload',
+        };
+    }
+    // Validate webhook
+    if (!validatePostmarkWebhook(payload, webhookToken)) {
+        throw new WebhookValidationError('email', {
+            context: { reason: 'Invalid webhook token or missing required fields' },
+        });
+    }
+    // Process the email
+    return processPostmarkEmail(payload);
+}
+// =============================================================================
+// Spam/Auto-Reply Detection
+// =============================================================================
+/**
+ * Check if email is likely an auto-reply or out-of-office
+ */
+export function isAutoReply(email) {
+    const subject = email.Subject?.toLowerCase() ?? '';
+    const headers = email.Headers ?? [];
+    // Check common auto-reply headers
+    const autoReplyHeaders = ['Auto-Submitted', 'X-Auto-Response-Suppress', 'X-Autoreply'];
+    for (const header of headers) {
+        if (autoReplyHeaders.includes(header.Name)) {
+            return true;
+        }
+    }
+    // Check subject line patterns
+    const autoReplyPatterns = [
+        /^(re:\s*)?out of (the )?office/i,
+        /^(re:\s*)?automatic reply/i,
+        /^(re:\s*)?auto(matic)?[:\s-]?reply/i,
+        /^(re:\s*)?away from/i,
+        /vacation/i,
+        /\boof\b/i,
+        /do not reply/i,
+        /undeliverable/i,
+        /delivery (status )?notification/i,
+        /mail delivery (failed|failure)/i,
+    ];
+    for (const pattern of autoReplyPatterns) {
+        if (pattern.test(subject)) {
+            return true;
+        }
+    }
+    // Check From address patterns
+    const from = email.From.toLowerCase();
+    const noReplyPatterns = [
+        /noreply/,
+        /no-reply/,
+        /donotreply/,
+        /do-not-reply/,
+        /mailer-daemon/,
+        /postmaster/,
+    ];
+    for (const pattern of noReplyPatterns) {
+        if (pattern.test(from)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Check if email is likely spam or marketing
+ */
+export function isLikelySpam(email) {
+    const subject = email.Subject?.toLowerCase() ?? '';
+    const body = (email.TextBody || email.HtmlBody || '').toLowerCase();
+    // Check for common spam indicators
+    const spamPatterns = [
+        /unsubscribe/i,
+        /click here to opt out/i,
+        /view in browser/i,
+        /update your preferences/i,
+        /manage your subscription/i,
+        /you are receiving this email because/i,
+        /this is an automated message/i,
+    ];
+    // Marketing indicators (not necessarily spam, but probably not support)
+    const marketingPatterns = [
+        /limited time offer/i,
+        /act now/i,
+        /special offer/i,
+        /exclusive deal/i,
+        /free shipping/i,
+        /discount code/i,
+        /% off/i,
+    ];
+    // Check patterns
+    const combinedText = `${subject} ${body}`;
+    let spamScore = 0;
+    for (const pattern of spamPatterns) {
+        if (pattern.test(combinedText)) {
+            spamScore += 2;
+        }
+    }
+    for (const pattern of marketingPatterns) {
+        if (pattern.test(combinedText)) {
+            spamScore += 1;
+        }
+    }
+    // Threshold for likely spam/marketing
+    return spamScore >= 3;
+}
+/**
+ * Classify email for processing
+ */
+export function classifyEmail(email) {
+    if (isAutoReply(email)) {
+        return {
+            shouldProcess: false,
+            reason: 'Auto-reply or out-of-office message',
+            classification: 'auto_reply',
+        };
+    }
+    if (isLikelySpam(email)) {
+        return {
+            shouldProcess: false,
+            reason: 'Likely spam or marketing email',
+            classification: 'spam_marketing',
+        };
+    }
+    // Check if email has meaningful content
+    const hasContent = email.TextBody?.trim() || email.StrippedTextReply?.trim();
+    if (!hasContent && !email.Subject?.trim()) {
+        return {
+            shouldProcess: false,
+            reason: 'Email has no meaningful content',
+            classification: 'unknown',
+        };
+    }
+    return {
+        shouldProcess: true,
+        classification: 'support',
+    };
+}
+// =============================================================================
+// Email Threading
+// =============================================================================
+/**
+ * Extract thread information from email headers
+ */
+export function extractEmailThread(email) {
+    const inReplyTo = email.InReplyTo?.trim();
+    const references = email.References?.split(/\s+/).filter(Boolean) ?? [];
+    // Extract message ID from angle brackets
+    const cleanMessageId = (id) => id.replace(/^<|>$/g, '');
+    return {
+        isReply: !!inReplyTo || references.length > 0,
+        originalMessageId: inReplyTo ? cleanMessageId(inReplyTo) : references[0],
+        threadMessageIds: references.map(cleanMessageId),
+    };
+}
+/**
+ * Extract quoted content from email body
+ */
+export function extractQuotedContent(body) {
+    // Common reply separators
+    const separatorPatterns = [
+        /^-{2,}.*original message.*-{2,}/im,
+        /^on .+ wrote:$/im,
+        /^from:.*sent:.*to:.*subject:/ims,
+        /^>.*$/gm,
+        /^_{10,}/m,
+    ];
+    let newContent = body;
+    let quotedContent;
+    for (const pattern of separatorPatterns) {
+        const match = newContent.match(pattern);
+        if (match && match.index !== undefined) {
+            quotedContent = newContent.slice(match.index);
+            newContent = newContent.slice(0, match.index).trim();
+            break;
+        }
+    }
+    return { newContent, quotedContent };
+}
+//# sourceMappingURL=postmark.js.map