catalist-support-agent 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Catalist Support AI Agent SDK
+ *
+ * Production-grade support agent that autonomously handles customer
+ * communications across email, SMS, and Slack while strictly enforcing
+ * Catalist's brand positioning as an "AI-native B2B marketplace."
+ *
+ * Key Capabilities:
+ * - Multi-channel message intake (Postmark, Twilio, Slack)
+ * - Intent classification and sentiment analysis
+ * - Knowledge retrieval from customer and product data
+ * - Brand-compliant response generation
+ * - Automatic escalation for sensitive topics
+ * - Multi-channel delivery with retry logic
+ *
+ * Critical Brand Constraint:
+ * This agent operates exclusively in "public brand mode" - any request
+ * requiring Amazon/Walmart-specific language, ungating assistance, or
+ * competitor pricing discussions is automatically escalated to humans.
+ */
+export { config, createConfig, getAllForbiddenTerms, isChannelEnabled, getEscalationChannels, getSlaTarget, validateAuthentication, classifyConfidence, shouldEscalateByConfidence, isAutonomousResponseAllowed, type Config, type CreateConfigOptions, type AuthenticationMode, type AuthenticationStatus, type ConfidenceLevel, } from './config.js';
+export { type ConversationId, type MessageId, type CustomerId, type EscalationId, type ResponseId, type DeliveryId, createConversationId, createMessageId, createCustomerId, createEscalationId, createResponseId, createDeliveryId, type SupportChannel, type MessageDirection, type ConversationState, type DeliveryStatus, type BrandComplianceStatus, type IntentCategory, type SentimentCategory, type UrgencyLevel, type EscalationTrigger, type EscalationSeverity, type BounceType, type ResolutionType, getConversationStatus, isDeliverySuccessful, canRetryDelivery, isBrandCompliant, type InboundMessage, type SenderInfo, type ChannelMetadata, type EmailMetadata, type SmsMetadata, type SlackMetadata, type Attachment, type AnalysisResult, type IntentClassification, type SentimentAnalysis, type ExtractedEntities, type ExtractedDate, type MonetaryAmount, type KnowledgeContext, type CustomerContext, type ProductContext, type OrderContext, type InvoiceContext, type ResolvedInvoice, type PolicyContext, type SimilarConversation, type ResponseTemplate, type GeneratedResponse, type ChannelFormatting, type Citation, type EscalationContext, type EscalationResult, type EscalationDelivery, type Conversation, type ConversationRecord, type MessageRecord, type AnalysisRecord, type ResponseRecord, type EscalationRecord, type DeliveryRecord, } from './types.js';
+export { SupportAgentError, IntakeError, WebhookValidationError, DuplicateMessageError, AnalysisError, IntentClassificationError, KnowledgeError, CustomerNotFoundError, GenerationError, ResponseQualityError, DeliveryError, PermanentDeliveryFailure, EscalationError, AllEscalationChannelsFailedError, BrandComplianceError, ForbiddenTermsDetectedError, DatabaseError, EmbeddingError, TimeoutError, isSupportAgentError, isIntakeError, isAnalysisError, isKnowledgeError, isGenerationError, isDeliveryError, isEscalationError, isBrandComplianceError, isDatabaseError, isTimeoutError, isEmbeddingError, isRecoverableError, toSupportAgentError, getErrorMessage, shouldRetry, requiresImmediateEscalation, type DeliveryChannel, type EscalationChannel, type EmbeddingErrorType, } from './errors.js';
+export { ForbiddenTermsDetector, BrandTerminologyEnforcer, BrandComplianceChecker, performBrandTest, checkBrandCompliance, scanMessageContent, createComplianceStatusFromScan, requiresEscalationForForbiddenTerms, validateResponseForBrand, applyBrandTerminologyCorrections, getBrandVoiceGuidelines, getDefaultDetector, getDefaultChecker, containsForbiddenTerms, scanForForbiddenTerms, scanForForbiddenTermsDetailed, type ForbiddenTermMatch, type ForbiddenTermsScanResult, type TerminologyCorrection, type BrandComplianceCheckResult, type ResponseValidationResult, } from './brand/index.js';
+export { MessageNormalizer, getMessageNormalizer, normalizePostmarkEmail, normalizeTwilioSms, normalizeSlackMessage, generateContentHash, extractThreadIdentifier, getSenderIdentifier, normalizePhoneNumber, validateMessageContent, scanAndAnnotateMessage, type PostmarkInboundEmail, type TwilioInboundSms, type SlackMessageEvent, type SlackEventWrapper, validatePostmarkWebhook, processPostmarkEmail, handlePostmarkInbound, isAutoReply, isLikelySpam, classifyEmail, extractEmailThread, extractQuotedContent, type PostmarkWebhookPayload, type PostmarkProcessResult, validateTwilioSignature, validateTwilioWebhook, parseTwilioBody, processTwilioSms, handleTwilioInbound, isOptOutMessage, isHelpRequest, classifySms, hasMmsAttachments, extractMmsMedia, extractCountryCode, isNorthAmericanNumber, generateTwimlResponse, generateOptOutResponse, generateHelpResponse, type TwilioProcessResult, validateSlackSignature, validateSlackWebhook, isUrlVerification, isMessageEvent, isDirectMessage, isBotMessage, processSlackMessage, handleSlackEvent, extractMentions, extractChannelReferences, extractLinks, cleanSlackText, isB2BCustomerChannel, shouldProcessSlackMessage, formatForSlack, generateSlackBlocks, type SlackProcessResult, type SlackUrlVerification, } from './intake/index.js';
+export { analyzeMessage, type AnalysisPipelineOptions, IntentClassificationService, getIntentClassificationService, classifyIntent, classifyIntentHeuristic, getIntentDescription, isHighPriorityIntent, isAutonomouslyHandleableIntent, SentimentAnalysisService, getSentimentAnalysisService, analyzeSentiment, analyzeSentimentHeuristic, shouldConsiderEscalationBySentiment, getUrgencyScore, combineUrgency, EntityExtractionService, getEntityExtractionService, extractEntities, extractEntitiesRegex, mergeEntities, hasOrderReference, hasProductReference, getPrimaryOrderNumber, getTotalAmount, } from './analysis/index.js';
+export { KnowledgeRetrievalService, getKnowledgeRetrievalService, getKnowledgeService, retrieveKnowledge, hassufficientContext, calculateContextConfidence, } from './knowledge/index.js';
+export { ResponseGenerationService, getResponseGenerationService, generateResponse, humanizeResponse, isResponseReadyToSend, } from './generation/index.js';
+export { EscalationService, getEscalationService, buildEscalationContext, shouldEscalate, containsHumanRequest, } from './escalation/index.js';
+export { DeliveryService, getDeliveryService, type RecipientInfo, type DeliveryResult, } from './delivery/index.js';
+export declare const VERSION = "1.0.0";
+export declare const SDK_NAME = "catalist-support-agent";
+import type { InboundMessage, AnalysisResult, GeneratedResponse, KnowledgeContext, ConversationId } from './types.js';
+/**
+ * Result from processing a message through the support agent pipeline
+ */
+export interface ProcessResult {
+    /** The analysis results from triage */
+    analysis: AnalysisResult;
+    /** The generated response (if not escalated) */
+    response?: GeneratedResponse;
+    /** The knowledge context retrieved */
+    knowledge: KnowledgeContext;
+    /** Whether the message was escalated to a human */
+    escalated: boolean;
+    /** Reason for escalation (if applicable) */
+    escalationReason?: string;
+    /** Total processing time in milliseconds */
+    processingTimeMs: number;
+    /** Conversation ID for this interaction */
+    conversationId: ConversationId;
+}
+/**
+ * Options for processing a message
+ */
+export interface ProcessMessageOptions {
+    /** Run in shadow mode - generate response but don't send */
+    shadowMode?: boolean;
+    /** Override the target channel for response formatting */
+    targetChannel?: 'email' | 'sms' | 'slack';
+    /** Skip knowledge retrieval (use minimal context) */
+    skipKnowledge?: boolean;
+    /** Force escalation regardless of analysis */
+    forceEscalation?: boolean;
+}
+/**
+ * Catalist Support Agent
+ *
+ * The main agent class that orchestrates the full support pipeline:
+ * 1. Message intake and normalization
+ * 2. Intent classification and sentiment analysis
+ * 3. Knowledge retrieval (customer, orders, products)
+ * 4. Response generation with brand compliance
+ * 5. Escalation handling
+ * 6. Multi-channel delivery
+ */
+export declare class SupportAgent {
+    private initialized;
+    /**
+     * Initialize the agent (pre-warm services, validate config)
+     */
+    initialize(): Promise<void>;
+    /**
+     * Process an inbound message through the full support pipeline
+     */
+    processMessage(message: InboundMessage, options?: ProcessMessageOptions): Promise<ProcessResult>;
+}
+/**
+ * Get the singleton SupportAgent instance
+ */
+export declare function getSupportAgent(): SupportAgent;
+/**
+ * Create a new SupportAgent instance (not singleton)
+ */
+export declare function createSupportAgent(): SupportAgent;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,233 @@
+/**
+ * Catalist Support AI Agent SDK
+ *
+ * Production-grade support agent that autonomously handles customer
+ * communications across email, SMS, and Slack while strictly enforcing
+ * Catalist's brand positioning as an "AI-native B2B marketplace."
+ *
+ * Key Capabilities:
+ * - Multi-channel message intake (Postmark, Twilio, Slack)
+ * - Intent classification and sentiment analysis
+ * - Knowledge retrieval from customer and product data
+ * - Brand-compliant response generation
+ * - Automatic escalation for sensitive topics
+ * - Multi-channel delivery with retry logic
+ *
+ * Critical Brand Constraint:
+ * This agent operates exclusively in "public brand mode" - any request
+ * requiring Amazon/Walmart-specific language, ungating assistance, or
+ * competitor pricing discussions is automatically escalated to humans.
+ */
+// =============================================================================
+// Configuration
+// =============================================================================
+export { config, createConfig, getAllForbiddenTerms, isChannelEnabled, getEscalationChannels, getSlaTarget, validateAuthentication, classifyConfidence, shouldEscalateByConfidence, isAutonomousResponseAllowed, } from './config.js';
+// =============================================================================
+// Types
+// =============================================================================
+export { createConversationId, createMessageId, createCustomerId, createEscalationId, createResponseId, createDeliveryId, 
+// Helper functions
+getConversationStatus, isDeliverySuccessful, canRetryDelivery, isBrandCompliant, } from './types.js';
+// =============================================================================
+// Errors
+// =============================================================================
+export { SupportAgentError, IntakeError, WebhookValidationError, DuplicateMessageError, AnalysisError, IntentClassificationError, KnowledgeError, CustomerNotFoundError, GenerationError, ResponseQualityError, DeliveryError, PermanentDeliveryFailure, EscalationError, AllEscalationChannelsFailedError, BrandComplianceError, ForbiddenTermsDetectedError, DatabaseError, EmbeddingError, TimeoutError, isSupportAgentError, isIntakeError, isAnalysisError, isKnowledgeError, isGenerationError, isDeliveryError, isEscalationError, isBrandComplianceError, isDatabaseError, isTimeoutError, isEmbeddingError, isRecoverableError, toSupportAgentError, getErrorMessage, shouldRetry, requiresImmediateEscalation, } from './errors.js';
+// =============================================================================
+// Brand Compliance
+// =============================================================================
+export { ForbiddenTermsDetector, BrandTerminologyEnforcer, BrandComplianceChecker, performBrandTest, checkBrandCompliance, scanMessageContent, createComplianceStatusFromScan, requiresEscalationForForbiddenTerms, validateResponseForBrand, applyBrandTerminologyCorrections, getBrandVoiceGuidelines, getDefaultDetector, getDefaultChecker, containsForbiddenTerms, scanForForbiddenTerms, scanForForbiddenTermsDetailed, } from './brand/index.js';
+// =============================================================================
+// Intake Pipeline
+// =============================================================================
+export { 
+// Message Normalization
+MessageNormalizer, getMessageNormalizer, normalizePostmarkEmail, normalizeTwilioSms, normalizeSlackMessage, generateContentHash, extractThreadIdentifier, getSenderIdentifier, normalizePhoneNumber, validateMessageContent, scanAndAnnotateMessage, 
+// Postmark (Email)
+validatePostmarkWebhook, processPostmarkEmail, handlePostmarkInbound, isAutoReply, isLikelySpam, classifyEmail, extractEmailThread, extractQuotedContent, 
+// Twilio (SMS)
+validateTwilioSignature, validateTwilioWebhook, parseTwilioBody, processTwilioSms, handleTwilioInbound, isOptOutMessage, isHelpRequest, classifySms, hasMmsAttachments, extractMmsMedia, extractCountryCode, isNorthAmericanNumber, generateTwimlResponse, generateOptOutResponse, generateHelpResponse, 
+// Slack
+validateSlackSignature, validateSlackWebhook, isUrlVerification, isMessageEvent, isDirectMessage, isBotMessage, processSlackMessage, handleSlackEvent, extractMentions, extractChannelReferences, extractLinks, cleanSlackText, isB2BCustomerChannel, shouldProcessSlackMessage, formatForSlack, generateSlackBlocks, } from './intake/index.js';
+// =============================================================================
+// Analysis Pipeline
+// =============================================================================
+export { 
+// Main Pipeline
+analyzeMessage, 
+// Intent Classification
+IntentClassificationService, getIntentClassificationService, classifyIntent, classifyIntentHeuristic, getIntentDescription, isHighPriorityIntent, isAutonomouslyHandleableIntent, 
+// Sentiment Analysis
+SentimentAnalysisService, getSentimentAnalysisService, analyzeSentiment, analyzeSentimentHeuristic, shouldConsiderEscalationBySentiment, getUrgencyScore, combineUrgency, 
+// Entity Extraction
+EntityExtractionService, getEntityExtractionService, extractEntities, extractEntitiesRegex, mergeEntities, hasOrderReference, hasProductReference, getPrimaryOrderNumber, getTotalAmount, } from './analysis/index.js';
+// =============================================================================
+// Knowledge Retrieval
+// =============================================================================
+export { KnowledgeRetrievalService, getKnowledgeRetrievalService, getKnowledgeService, retrieveKnowledge, hassufficientContext, calculateContextConfidence, } from './knowledge/index.js';
+// =============================================================================
+// Response Generation
+// =============================================================================
+export { ResponseGenerationService, getResponseGenerationService, generateResponse, humanizeResponse, isResponseReadyToSend, } from './generation/index.js';
+// =============================================================================
+// Escalation System
+// =============================================================================
+export { EscalationService, getEscalationService, buildEscalationContext, shouldEscalate, containsHumanRequest, } from './escalation/index.js';
+// =============================================================================
+// Delivery Pipeline
+// =============================================================================
+export { DeliveryService, getDeliveryService, } from './delivery/index.js';
+// =============================================================================
+// Version Info
+// =============================================================================
+export const VERSION = '1.0.0';
+export const SDK_NAME = 'catalist-support-agent';
+import { createConversationId } from './types.js';
+import { config } from './config.js';
+import { analyzeMessage } from './analysis/index.js';
+import { retrieveKnowledge } from './knowledge/index.js';
+import { generateResponse as doGenerateResponse } from './generation/index.js';
+import { shouldEscalate, buildEscalationContext } from './escalation/index.js';
+/**
+ * Helper to create an empty knowledge context for fallback scenarios
+ */
+function createEmptyKnowledgeContext() {
+    return {
+        assembledAt: new Date().toISOString(),
+        confidenceScores: {
+            customerData: 0,
+            productData: 0,
+            policyData: 0,
+            similarConversations: 0,
+        },
+    };
+}
+/**
+ * Catalist Support Agent
+ *
+ * The main agent class that orchestrates the full support pipeline:
+ * 1. Message intake and normalization
+ * 2. Intent classification and sentiment analysis
+ * 3. Knowledge retrieval (customer, orders, products)
+ * 4. Response generation with brand compliance
+ * 5. Escalation handling
+ * 6. Multi-channel delivery
+ */
+export class SupportAgent {
+    initialized = false;
+    /**
+     * Initialize the agent (pre-warm services, validate config)
+     */
+    async initialize() {
+        // Validate required configuration
+        if (!config.claude.apiKey) {
+            console.warn('[SupportAgent] ANTHROPIC_API_KEY not configured - response generation will fail');
+        }
+        if (!config.supabase.url || !config.supabase.serviceRoleKey) {
+            console.warn('[SupportAgent] Supabase not configured - knowledge retrieval will fail');
+        }
+        this.initialized = true;
+    }
+    /**
+     * Process an inbound message through the full support pipeline
+     */
+    async processMessage(message, options = {}) {
+        const startTime = Date.now();
+        // Ensure conversation ID exists
+        const conversationId = message.conversationId ?? createConversationId(`conv-${Date.now()}`);
+        // 1. Analyze the message (intent, sentiment, entities)
+        const analysis = await analyzeMessage(message);
+        // 2. Check if we should escalate before proceeding
+        const escalationCheck = shouldEscalate(analysis);
+        if (options.forceEscalation || escalationCheck.required) {
+            const emptyKnowledge = createEmptyKnowledgeContext();
+            const trigger = escalationCheck.trigger ?? 'human_takeover';
+            const severity = escalationCheck.severity ?? 'medium';
+            const reason = escalationCheck.reasons.join('; ') || 'Forced escalation';
+            const escalationContext = buildEscalationContext(message, analysis, emptyKnowledge, trigger, severity, reason);
+            return {
+                analysis,
+                knowledge: emptyKnowledge,
+                escalated: true,
+                escalationReason: escalationContext.trigger,
+                processingTimeMs: Date.now() - startTime,
+                conversationId,
+            };
+        }
+        // 3. Retrieve knowledge context
+        let knowledge = createEmptyKnowledgeContext();
+        if (!options.skipKnowledge) {
+            try {
+                knowledge = await retrieveKnowledge(message, analysis);
+            }
+            catch (error) {
+                console.warn('[SupportAgent] Knowledge retrieval failed:', error);
+                // Continue with minimal context
+            }
+        }
+        // 4. Check for escalation based on knowledge context (e.g., VIP customer, sensitive issue)
+        const postKnowledgeCheck = shouldEscalate(analysis);
+        if (postKnowledgeCheck.required) {
+            const trigger = postKnowledgeCheck.trigger ?? 'customer_request';
+            const severity = postKnowledgeCheck.severity ?? 'medium';
+            const reason = postKnowledgeCheck.reasons.join('; ') || 'Post-knowledge escalation';
+            const escalationContext = buildEscalationContext(message, analysis, knowledge, trigger, severity, reason);
+            return {
+                analysis,
+                knowledge,
+                escalated: true,
+                escalationReason: escalationContext.trigger,
+                processingTimeMs: Date.now() - startTime,
+                conversationId,
+            };
+        }
+        // 5. Generate response
+        let response;
+        try {
+            response = await doGenerateResponse(message, analysis, knowledge, {
+                targetChannel: options.targetChannel ?? message.channel,
+            });
+        }
+        catch (error) {
+            console.error('[SupportAgent] Response generation failed:', error);
+            // Escalate on generation failure
+            return {
+                analysis,
+                knowledge,
+                escalated: true,
+                escalationReason: `generation_failed: ${error instanceof Error ? error.message : String(error)}`,
+                processingTimeMs: Date.now() - startTime,
+                conversationId,
+            };
+        }
+        // 6. In shadow mode, we don't deliver - just return the result
+        // In production mode, delivery would happen here
+        return {
+            analysis,
+            response,
+            knowledge,
+            escalated: false,
+            processingTimeMs: Date.now() - startTime,
+            conversationId,
+        };
+    }
+}
+// =============================================================================
+// Factory Functions
+// =============================================================================
+let supportAgentInstance = null;
+/**
+ * Get the singleton SupportAgent instance
+ */
+export function getSupportAgent() {
+    if (!supportAgentInstance) {
+        supportAgentInstance = new SupportAgent();
+    }
+    return supportAgentInstance;
+}
+/**
+ * Create a new SupportAgent instance (not singleton)
+ */
+export function createSupportAgent() {
+    return new SupportAgent();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/intake/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Message Intake Module
+ *
+ * Handles inbound message reception from all channels:
+ * - Email (via Postmark)
+ * - SMS (via Twilio)
+ * - Slack (via Events API)
+ *
+ * Provides message normalization, deduplication, and threading services.
+ */
+export { MessageNormalizer, getMessageNormalizer, normalizePostmarkEmail, normalizeTwilioSms, normalizeSlackMessage, generateContentHash, extractThreadIdentifier, getSenderIdentifier, normalizePhoneNumber, validateMessageContent, scanAndAnnotateMessage, type PostmarkInboundEmail, type TwilioInboundSms, type SlackMessageEvent, type SlackEventWrapper, } from './normalizer.js';
+export { validatePostmarkWebhook, processPostmarkEmail, handlePostmarkInbound, isAutoReply, isLikelySpam, classifyEmail, extractEmailThread, extractQuotedContent, type PostmarkWebhookPayload, type PostmarkProcessResult, } from './postmark.js';
+export { validateTwilioSignature, validateTwilioWebhook, parseTwilioBody, processTwilioSms, handleTwilioInbound, isOptOutMessage, isHelpRequest, classifySms, hasMmsAttachments, extractMmsMedia, extractCountryCode, isNorthAmericanNumber, generateTwimlResponse, generateOptOutResponse, generateHelpResponse, type TwilioProcessResult, } from './twilio.js';
+export { validateSlackSignature, validateSlackWebhook, isUrlVerification, isMessageEvent, isDirectMessage, isBotMessage, processSlackMessage, handleSlackEvent, extractMentions, extractChannelReferences, extractLinks, cleanSlackText, isB2BCustomerChannel, shouldProcessSlackMessage, formatForSlack, generateSlackBlocks, type SlackProcessResult, type SlackUrlVerification, } from './slack.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/intake/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,WAAW,EACX,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,GAC3B,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,yBAAyB,EACzB,cAAc,EACd,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,YAAY,CAAC"}

package/dist/intake/index.js

@@ -0,0 +1,19 @@
+/**
+ * Message Intake Module
+ *
+ * Handles inbound message reception from all channels:
+ * - Email (via Postmark)
+ * - SMS (via Twilio)
+ * - Slack (via Events API)
+ *
+ * Provides message normalization, deduplication, and threading services.
+ */
+// Message normalizer
+export { MessageNormalizer, getMessageNormalizer, normalizePostmarkEmail, normalizeTwilioSms, normalizeSlackMessage, generateContentHash, extractThreadIdentifier, getSenderIdentifier, normalizePhoneNumber, validateMessageContent, scanAndAnnotateMessage, } from './normalizer.js';
+// Postmark email handler
+export { validatePostmarkWebhook, processPostmarkEmail, handlePostmarkInbound, isAutoReply, isLikelySpam, classifyEmail, extractEmailThread, extractQuotedContent, } from './postmark.js';
+// Twilio SMS handler
+export { validateTwilioSignature, validateTwilioWebhook, parseTwilioBody, processTwilioSms, handleTwilioInbound, isOptOutMessage, isHelpRequest, classifySms, hasMmsAttachments, extractMmsMedia, extractCountryCode, isNorthAmericanNumber, generateTwimlResponse, generateOptOutResponse, generateHelpResponse, } from './twilio.js';
+// Slack event handler
+export { validateSlackSignature, validateSlackWebhook, isUrlVerification, isMessageEvent, isDirectMessage, isBotMessage, processSlackMessage, handleSlackEvent, extractMentions, extractChannelReferences, extractLinks, cleanSlackText, isB2BCustomerChannel, shouldProcessSlackMessage, formatForSlack, generateSlackBlocks, } from './slack.js';
+//# sourceMappingURL=index.js.map

package/dist/intake/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/intake/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,qBAAqB;AACrB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,GAKvB,MAAM,iBAAiB,CAAC;AAEzB,yBAAyB;AACzB,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,WAAW,EACX,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,oBAAoB,GAGrB,MAAM,eAAe,CAAC;AAEvB,qBAAqB;AACrB,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,GAErB,MAAM,aAAa,CAAC;AAErB,sBAAsB;AACtB,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,YAAY,EACZ,cAAc,EACd,oBAAoB,EACpB,yBAAyB,EACzB,cAAc,EACd,mBAAmB,GAGpB,MAAM,YAAY,CAAC"}

package/dist/intake/normalizer.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Message Normalizer
+ *
+ * Transforms channel-specific message formats into a unified InboundMessage interface.
+ * Handles content extraction, sender identification, and metadata normalization.
+ */
+import type { InboundMessage } from '../types.js';
+export interface PostmarkInboundEmail {
+    From: string;
+    FromName?: string;
+    FromFull?: {
+        Email: string;
+        Name: string;
+    };
+    To: string;
+    ToFull?: Array<{
+        Email: string;
+        Name: string;
+    }>;
+    Cc?: string;
+    CcFull?: Array<{
+        Email: string;
+        Name: string;
+    }>;
+    ReplyTo?: string;
+    Subject?: string;
+    MessageID: string;
+    Date: string;
+    TextBody?: string;
+    HtmlBody?: string;
+    StrippedTextReply?: string;
+    Headers?: Array<{
+        Name: string;
+        Value: string;
+    }>;
+    Attachments?: Array<{
+        Name: string;
+        Content: string;
+        ContentType: string;
+        ContentLength: number;
+        ContentID?: string;
+    }>;
+    OriginalRecipient?: string;
+    InReplyTo?: string;
+    References?: string;
+}
+export interface TwilioInboundSms {
+    MessageSid: string;
+    AccountSid: string;
+    From: string;
+    To: string;
+    Body: string;
+    NumMedia?: string;
+    NumSegments?: string;
+    FromCity?: string;
+    FromState?: string;
+    FromZip?: string;
+    FromCountry?: string;
+    ToCity?: string;
+    ToState?: string;
+    ToZip?: string;
+    ToCountry?: string;
+    MediaUrl0?: string;
+    MediaContentType0?: string;
+}
+export interface SlackMessageEvent {
+    type: 'message';
+    subtype?: string;
+    channel: string;
+    user: string;
+    text: string;
+    ts: string;
+    thread_ts?: string;
+    team: string;
+    event_ts: string;
+    channel_type?: 'im' | 'channel' | 'group';
+    files?: Array<{
+        id: string;
+        name: string;
+        mimetype: string;
+        size: number;
+        url_private?: string;
+        url_private_download?: string;
+    }>;
+    blocks?: unknown[];
+}
+export interface SlackEventWrapper {
+    token: string;
+    team_id: string;
+    api_app_id: string;
+    event: SlackMessageEvent;
+    type: 'event_callback' | 'url_verification';
+    event_id: string;
+    event_time: number;
+    authed_users?: string[];
+    challenge?: string;
+}
+export declare class MessageNormalizer {
+    /**
+     * Normalize a Postmark inbound email
+     */
+    normalizePostmarkEmail(email: PostmarkInboundEmail): InboundMessage;
+    /**
+     * Normalize a Twilio inbound SMS
+     */
+    normalizeTwilioSms(sms: TwilioInboundSms): InboundMessage;
+    /**
+     * Normalize a Slack message event
+     */
+    normalizeSlackMessage(event: SlackMessageEvent, teamId: string): InboundMessage;
+    /**
+     * Convert Postmark headers array to record
+     */
+    private headersToRecord;
+    /**
+     * Normalize Postmark attachments
+     */
+    private normalizePostmarkAttachments;
+    /**
+     * Normalize Twilio MMS media
+     */
+    private normalizeTwilioMedia;
+    /**
+     * Normalize Slack file attachments
+     */
+    private normalizeSlackFiles;
+}
+/**
+ * Generate a content hash for deduplication
+ */
+export declare function generateContentHash(message: InboundMessage): string;
+/**
+ * Extract conversation thread identifier from message
+ */
+export declare function extractThreadIdentifier(message: InboundMessage): string | undefined;
+/**
+ * Get sender identifier for customer matching
+ */
+export declare function getSenderIdentifier(message: InboundMessage): {
+    type: 'email' | 'phone' | 'slack';
+    value: string;
+} | undefined;
+/**
+ * Normalize phone number to E.164 format
+ */
+export declare function normalizePhoneNumber(phone: string): string;
+/**
+ * Validate message content is not empty
+ */
+export declare function validateMessageContent(message: InboundMessage): void;
+/**
+ * Check message for forbidden terms and annotate
+ */
+export declare function scanAndAnnotateMessage(message: InboundMessage): {
+    message: InboundMessage;
+    hasForbiddenTerms: boolean;
+    detectedTerms: string[];
+};
+export declare function getMessageNormalizer(): MessageNormalizer;
+export declare function normalizePostmarkEmail(email: PostmarkInboundEmail): InboundMessage;
+export declare function normalizeTwilioSms(sms: TwilioInboundSms): InboundMessage;
+export declare function normalizeSlackMessage(event: SlackMessageEvent, teamId: string): InboundMessage;
+//# sourceMappingURL=normalizer.d.ts.map

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

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