catalist-support-agent 1.0.0

package/dist/admin-portal.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Simplified entry point for Admin Portal integration
+ *
+ * Provides a focused API for the Gmail webhook without exposing
+ * the full library complexity.
+ */
+export interface EmailProcessingInput {
+    fromEmail: string;
+    fromName?: string;
+    subject: string;
+    body: string;
+    threadId?: string;
+}
+export interface EmailProcessingResult {
+    success: boolean;
+    response?: {
+        text: string;
+        qualityScore: number;
+    };
+    analysis?: {
+        intent: string;
+        sentiment: string;
+        urgency: string;
+        entities: {
+            orderNumbers: string[];
+            productNames: string[];
+        };
+    };
+    customer?: {
+        id: string;
+        name: string;
+        company?: string;
+    };
+    escalated: boolean;
+    escalationReason?: string;
+    noResponseNeeded: boolean;
+}
+/**
+ * Process an email through the full support pipeline
+ */
+export declare function processEmail(input: EmailProcessingInput): Promise<EmailProcessingResult>;
+export { humanizeResponse } from './generation/index.js';
+//# sourceMappingURL=admin-portal.d.ts.map

package/dist/admin-portal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-portal.d.ts","sourceRoot":"","sources":["../src/admin-portal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE;YACR,YAAY,EAAE,MAAM,EAAE,CAAC;YACvB,YAAY,EAAE,MAAM,EAAE,CAAC;SACxB,CAAC;KACH,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CA8HhC;AAmCD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/admin-portal.js

@@ -0,0 +1,166 @@
+/**
+ * Simplified entry point for Admin Portal integration
+ *
+ * Provides a focused API for the Gmail webhook without exposing
+ * the full library complexity.
+ */
+import { analyzeMessage, triageMessage } from './analysis/index.js';
+import { getKnowledgeService } from './knowledge/index.js';
+import { humanizeResponse, generateResponse } from './generation/index.js';
+import { checkBrandCompliance } from './brand/index.js';
+import { createConversationId, createMessageId } from './types.js';
+/**
+ * Process an email through the full support pipeline
+ */
+export async function processEmail(input) {
+    // Create normalized message structure
+    const message = {
+        id: createMessageId(crypto.randomUUID()),
+        conversationId: createConversationId(crypto.randomUUID()),
+        channel: 'email',
+        direction: 'inbound',
+        sender: {
+            email: input.fromEmail,
+            name: input.fromName,
+        },
+        content: {
+            text: input.body,
+            subject: input.subject,
+        },
+        metadata: {
+            type: 'email',
+            messageId: input.threadId || crypto.randomUUID(),
+            fromAddress: input.fromEmail,
+            toAddresses: ['sales@catalistgroup.co'],
+        },
+        receivedAt: new Date().toISOString(),
+    };
+    // 1. Quick triage for forbidden terms
+    const triage = triageMessage(message);
+    if (triage.requiresEscalation && triage.quickAssessment.includes('forbidden terms')) {
+        return {
+            success: false,
+            escalated: true,
+            escalationReason: triage.quickAssessment,
+            noResponseNeeded: false,
+        };
+    }
+    // 2. Check for automated senders that don't need response
+    if (shouldSkipResponse(input.fromEmail)) {
+        return {
+            success: true,
+            escalated: false,
+            noResponseNeeded: true,
+        };
+    }
+    // 3. Full analysis
+    const analysis = await analyzeMessage(message);
+    // Check if analysis indicates escalation required
+    if (analysis.escalationRequired) {
+        return {
+            success: false,
+            escalated: true,
+            escalationReason: analysis.escalationReasons?.join('; ') || 'Analysis requires escalation',
+            noResponseNeeded: false,
+            analysis: {
+                intent: analysis.intent.primary,
+                sentiment: analysis.sentiment.category,
+                urgency: analysis.sentiment.urgency,
+                entities: {
+                    orderNumbers: analysis.entities.orderNumbers ?? [],
+                    productNames: analysis.entities.productNames ?? [],
+                },
+            },
+        };
+    }
+    // 4. Retrieve knowledge context (customer data, orders)
+    let knowledge;
+    try {
+        knowledge = await getKnowledgeService().retrieveContext(message, analysis);
+    }
+    catch (error) {
+        console.warn('[AdminPortal] Knowledge retrieval failed, continuing with empty context:', error);
+        knowledge = createEmptyKnowledgeContext();
+    }
+    // 5. Generate response
+    const rawResponse = await generateResponse(message, analysis, knowledge);
+    // 6. Humanize the response (remove AI patterns)
+    const humanizedText = humanizeResponse(rawResponse.content.text);
+    // 7. Validate brand compliance of generated response
+    const brandCheck = checkBrandCompliance(humanizedText);
+    if (!brandCheck.passed) {
+        return {
+            success: false,
+            escalated: true,
+            escalationReason: `Brand compliance failed: ${brandCheck.toneIssues?.join(', ') || 'Unknown issues'}`,
+            noResponseNeeded: false,
+            analysis: {
+                intent: analysis.intent.primary,
+                sentiment: analysis.sentiment.category,
+                urgency: analysis.sentiment.urgency,
+                entities: {
+                    orderNumbers: analysis.entities.orderNumbers ?? [],
+                    productNames: analysis.entities.productNames ?? [],
+                },
+            },
+        };
+    }
+    return {
+        success: true,
+        response: {
+            text: humanizedText,
+            qualityScore: rawResponse.qualityScore ?? 0.9,
+        },
+        analysis: {
+            intent: analysis.intent.primary,
+            sentiment: analysis.sentiment.category,
+            urgency: analysis.sentiment.urgency,
+            entities: {
+                orderNumbers: analysis.entities.orderNumbers ?? [],
+                productNames: analysis.entities.productNames ?? [],
+            },
+        },
+        customer: knowledge.customer
+            ? {
+                id: String(knowledge.customer.id),
+                name: knowledge.customer.contactName ?? knowledge.customer.companyName,
+                company: knowledge.customer.companyName,
+            }
+            : undefined,
+        escalated: false,
+        noResponseNeeded: false,
+    };
+}
+function shouldSkipResponse(email) {
+    const automatedPatterns = [
+        /^noreply@/i,
+        /^no-reply@/i,
+        /^donotreply@/i,
+        /^notifications?@/i,
+        /^alerts?@/i,
+        /@.*\.apple\.com$/i,
+        /@.*\.google\.com$/i,
+        /@.*\.amazon\.com$/i,
+    ];
+    return automatedPatterns.some((p) => p.test(email));
+}
+function createEmptyKnowledgeContext() {
+    return {
+        customer: undefined,
+        products: undefined,
+        orders: undefined,
+        policies: undefined,
+        similarConversations: undefined,
+        templates: undefined,
+        assembledAt: new Date().toISOString(),
+        confidenceScores: {
+            customerData: 0,
+            productData: 0,
+            policyData: 0,
+            similarConversations: 0,
+        },
+    };
+}
+// Re-export humanizeResponse for direct use
+export { humanizeResponse } from './generation/index.js';
+//# sourceMappingURL=admin-portal.js.map

package/dist/admin-portal.js.map

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

package/dist/analysis/entities.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Entity Extraction Service
+ *
+ * Extracts structured entities from support messages using Claude.
+ * Identifies order numbers, product references, dates, amounts, etc.
+ */
+import type { ExtractedEntities, InboundMessage } from '../types.js';
+export declare class EntityExtractionService {
+    private client;
+    private getClient;
+    /**
+     * Extract entities from a message using Claude
+     */
+    extract(message: InboundMessage): Promise<ExtractedEntities>;
+    /**
+     * Parse the entity extraction response
+     */
+    private parseEntityResponse;
+    /**
+     * Filter empty arrays to undefined
+     */
+    private filterEmpty;
+    /**
+     * Parse date entities
+     */
+    private parseDates;
+    /**
+     * Try to parse a date string
+     */
+    private tryParseDate;
+    /**
+     * Validate date type
+     */
+    private validateDateType;
+    /**
+     * Parse monetary amounts
+     */
+    private parseMonetaryAmounts;
+    /**
+     * Extract entities using regex patterns (fallback)
+     */
+    extractWithRegex(message: InboundMessage): ExtractedEntities;
+}
+export declare function getEntityExtractionService(): EntityExtractionService;
+/**
+ * Extract entities from message
+ */
+export declare function extractEntities(message: InboundMessage): Promise<ExtractedEntities>;
+/**
+ * Extract entities using regex (fallback)
+ */
+export declare function extractEntitiesRegex(message: InboundMessage): ExtractedEntities;
+/**
+ * Merge extracted entities from multiple sources
+ */
+export declare function mergeEntities(...entities: ExtractedEntities[]): ExtractedEntities;
+/**
+ * Check if entities contain order reference
+ */
+export declare function hasOrderReference(entities: ExtractedEntities): boolean;
+/**
+ * Check if entities contain product reference
+ */
+export declare function hasProductReference(entities: ExtractedEntities): boolean;
+/**
+ * Get primary order number from entities
+ */
+export declare function getPrimaryOrderNumber(entities: ExtractedEntities): string | undefined;
+/**
+ * Get total monetary amount mentioned
+ */
+export declare function getTotalAmount(entities: ExtractedEntities): number | undefined;
+//# sourceMappingURL=entities.d.ts.map

package/dist/analysis/entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../src/analysis/entities.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAiC,cAAc,EAAE,MAAM,aAAa,CAAC;AAyEpG,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAA0B;IAExC,OAAO,CAAC,SAAS;IAejB;;OAEG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA2ClE;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA8C3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,OAAO,CAAC,UAAU;IAYlB;;OAEG;IACH,OAAO,CAAC,YAAY;IAYpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,iBAAiB;CAkE7D;AAQD,wBAAgB,0BAA0B,IAAI,uBAAuB,CAKpE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAEzF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,iBAAiB,CAE/E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,QAAQ,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,CA6CjF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAEtE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAKxE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,GAAG,SAAS,CAErF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,GAAG,SAAS,CAY9E"}

package/dist/analysis/entities.js

@@ -0,0 +1,378 @@
+/**
+ * Entity Extraction Service
+ *
+ * Extracts structured entities from support messages using Claude.
+ * Identifies order numbers, product references, dates, amounts, etc.
+ */
+import Anthropic from '@anthropic-ai/sdk';
+import { config } from '../config.js';
+import { AnalysisError } from '../errors.js';
+// =============================================================================
+// Entity Patterns (Regex-based extraction)
+// =============================================================================
+const PATTERNS = {
+    // Order numbers: Various formats like ORD-12345, #12345, SO-12345
+    orderNumber: /(?:order|ord|so|po|invoice)[\s#:-]*([A-Z0-9-]{4,20})/gi,
+    // Catalist invoice numbers: 7-digit numbers starting with 91 (e.g., 9107893)
+    catalistInvoice: /\b(91\d{5})\b/g,
+    // Amazon ASIN: 10-character alphanumeric, typically starts with B0
+    asin: /\b(B0[A-Z0-9]{8}|[A-Z0-9]{10})\b/g,
+    // SKU patterns: Common formats like ABC-12345, 12345-ABC
+    sku: /\b([A-Z]{2,5}[-\s]?[0-9]{3,10}|[0-9]{3,10}[-\s]?[A-Z]{2,5})\b/gi,
+    // Monetary amounts: $100, $1,234.56, USD 100
+    money: /(?:\$|USD|EUR|GBP)\s*([0-9,]+(?:\.[0-9]{2})?)|([0-9,]+(?:\.[0-9]{2})?)\s*(?:dollars?|USD|EUR|GBP)/gi,
+    // Phone numbers: Various formats
+    phone: /(?:\+?1[-.\s]?)?\(?[0-9]{3}\)?[-.\s]?[0-9]{3}[-.\s]?[0-9]{4}/g,
+    // Email addresses
+    email: /[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}/g,
+    // Dates: Various formats
+    date: /(?:(?:jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)[a-z]*\.?\s+\d{1,2}(?:st|nd|rd|th)?,?\s*\d{4}|\d{1,2}[-/]\d{1,2}[-/]\d{2,4}|\d{4}[-/]\d{1,2}[-/]\d{1,2})/gi,
+};
+// =============================================================================
+// Entity Extraction Prompt
+// =============================================================================
+const ENTITY_EXTRACTION_PROMPT = `You are an entity extraction system for B2B marketplace support messages.
+
+Extract the following entities if present:
+- **Order Numbers**: Order IDs, invoice numbers, PO numbers
+- **Product Names**: Product names, brand names mentioned
+- **Product SKUs**: Product codes, SKU numbers, Amazon ASINs (10-character codes like B00V3HW8E0)
+- **Dates**: Any dates mentioned (order dates, delivery dates, etc.)
+- **Monetary Amounts**: Prices, totals, refund amounts
+- **Customer References**: Customer account numbers, company names
+- **Company Names**: Business names mentioned
+- **Person Names**: Contact names mentioned
+
+## Response Format
+
+Respond with a JSON object:
+{
+  "orderNumbers": ["ORD-12345"],
+  "productNames": ["Product Name"],
+  "productSkus": ["SKU-123"],
+  "dates": [
+    {"raw": "January 15, 2024", "type": "order_date|delivery_date|request_date|general"}
+  ],
+  "monetaryAmounts": [
+    {"raw": "$150.00", "amount": 150.00, "currency": "USD", "context": "refund amount"}
+  ],
+  "customerReferences": ["ACC-123"],
+  "companyNames": ["Company Inc"],
+  "personNames": ["John Smith"]
+}
+
+Include only entities that are clearly present. Use null for arrays with no matches.
+`;
+// =============================================================================
+// Entity Extraction Service
+// =============================================================================
+export class EntityExtractionService {
+    client = null;
+    getClient() {
+        if (!this.client) {
+            if (config.claude.apiKey) {
+                this.client = new Anthropic({
+                    apiKey: config.claude.apiKey,
+                });
+            }
+            else {
+                throw new AnalysisError('Claude API key not configured', 'entities', {
+                    context: { reason: 'Missing ANTHROPIC_API_KEY' },
+                });
+            }
+        }
+        return this.client;
+    }
+    /**
+     * Extract entities from a message using Claude
+     */
+    async extract(message) {
+        try {
+            const client = this.getClient();
+            let content = message.content.text;
+            if (message.content.subject) {
+                content = `Subject: ${message.content.subject}\n\n${content}`;
+            }
+            const response = await client.messages.create({
+                model: config.claude.model,
+                max_tokens: 512,
+                system: ENTITY_EXTRACTION_PROMPT,
+                messages: [
+                    {
+                        role: 'user',
+                        content: `Extract entities from this customer message:\n\n${content}`,
+                    },
+                ],
+            });
+            const textContent = response.content.find((c) => c.type === 'text');
+            if (!textContent || textContent.type !== 'text') {
+                throw new AnalysisError('No text response from Claude', 'entities');
+            }
+            return this.parseEntityResponse(textContent.text);
+        }
+        catch (error) {
+            if (error instanceof AnalysisError) {
+                throw error;
+            }
+            throw new AnalysisError(`Entity extraction failed: ${error instanceof Error ? error.message : 'Unknown error'}`, 'entities', {
+                cause: error instanceof Error ? error : undefined,
+                messageId: message.id,
+            });
+        }
+    }
+    /**
+     * Parse the entity extraction response
+     */
+    parseEntityResponse(text) {
+        const jsonMatch = text.match(/\{[\s\S]*\}/);
+        if (!jsonMatch) {
+            throw new AnalysisError('Could not parse entity extraction JSON', 'entities', {
+                context: { response: text.substring(0, 200) },
+            });
+        }
+        try {
+            const parsed = JSON.parse(jsonMatch[0]);
+            return {
+                orderNumbers: this.filterEmpty(parsed.orderNumbers),
+                productNames: this.filterEmpty(parsed.productNames),
+                productSkus: this.filterEmpty(parsed.productSkus),
+                dates: this.parseDates(parsed.dates),
+                monetaryAmounts: this.parseMonetaryAmounts(parsed.monetaryAmounts),
+                customerReferences: this.filterEmpty(parsed.customerReferences),
+                companyNames: this.filterEmpty(parsed.companyNames),
+                personNames: this.filterEmpty(parsed.personNames),
+                phoneNumbers: this.filterEmpty(parsed.phoneNumbers),
+                emails: this.filterEmpty(parsed.emails),
+            };
+        }
+        catch {
+            throw new AnalysisError('Invalid JSON in entity extraction response', 'entities', {
+                context: { response: text.substring(0, 200) },
+            });
+        }
+    }
+    /**
+     * Filter empty arrays to undefined
+     */
+    filterEmpty(arr) {
+        if (!arr || arr.length === 0)
+            return undefined;
+        return arr.filter((s) => s && s.trim());
+    }
+    /**
+     * Parse date entities
+     */
+    parseDates(dates) {
+        if (!dates || dates.length === 0)
+            return undefined;
+        return dates.map((d) => ({
+            raw: d.raw,
+            parsed: this.tryParseDate(d.raw),
+            type: this.validateDateType(d.type),
+        }));
+    }
+    /**
+     * Try to parse a date string
+     */
+    tryParseDate(raw) {
+        try {
+            const parsed = new Date(raw);
+            if (!isNaN(parsed.getTime())) {
+                return parsed;
+            }
+        }
+        catch {
+            // Ignore parse errors
+        }
+        return undefined;
+    }
+    /**
+     * Validate date type
+     */
+    validateDateType(type) {
+        if (type === 'order_date' ||
+            type === 'delivery_date' ||
+            type === 'request_date' ||
+            type === 'general') {
+            return type;
+        }
+        return 'general';
+    }
+    /**
+     * Parse monetary amounts
+     */
+    parseMonetaryAmounts(amounts) {
+        if (!amounts || amounts.length === 0)
+            return undefined;
+        return amounts.map((a) => ({
+            raw: a.raw,
+            amount: a.amount,
+            currency: a.currency || 'USD',
+            context: a.context,
+        }));
+    }
+    /**
+     * Extract entities using regex patterns (fallback)
+     */
+    extractWithRegex(message) {
+        const text = `${message.content.subject ?? ''}\n${message.content.text}`;
+        // Extract order numbers
+        const orderMatches = [...text.matchAll(PATTERNS.orderNumber)];
+        const orderNumbers = orderMatches.map((m) => m[1]).filter(Boolean);
+        // Extract Catalist invoice numbers (7-digit starting with 91)
+        const invoiceMatches = [...text.matchAll(PATTERNS.catalistInvoice)];
+        const invoiceNumbers = invoiceMatches.map((m) => m[1]).filter(Boolean);
+        // Merge invoice numbers into order numbers (they're often used interchangeably)
+        orderNumbers.push(...invoiceNumbers);
+        // Extract ASINs (Amazon Standard Identification Number)
+        const asinMatches = [...text.matchAll(PATTERNS.asin)];
+        const asins = asinMatches.map((m) => m[1]).filter(Boolean);
+        // Extract SKUs
+        const skuMatches = [...text.matchAll(PATTERNS.sku)];
+        const productSkus = [
+            ...asins, // ASINs are treated as product identifiers
+            ...skuMatches.map((m) => m[1]).filter(Boolean),
+        ];
+        // Extract monetary amounts
+        const moneyMatches = [...text.matchAll(PATTERNS.money)];
+        const monetaryAmounts = moneyMatches
+            .map((m) => {
+            const amountStr = m[1] || m[2];
+            if (!amountStr)
+                return null;
+            const amount = parseFloat(amountStr.replace(/,/g, ''));
+            if (isNaN(amount))
+                return null;
+            return {
+                raw: m[0],
+                amount,
+                currency: 'USD',
+            };
+        })
+            .filter((a) => a !== null);
+        // Extract dates
+        const dateMatches = [...text.matchAll(PATTERNS.date)];
+        const dates = dateMatches.map((m) => ({
+            raw: m[0],
+            parsed: this.tryParseDate(m[0]),
+            type: 'general',
+        }));
+        // Extract emails
+        const emailMatches = [...text.matchAll(PATTERNS.email)];
+        const emails = emailMatches.map((m) => m[0]).filter(Boolean);
+        // Extract phone numbers
+        const phoneMatches = [...text.matchAll(PATTERNS.phone)];
+        const phoneNumbers = phoneMatches.map((m) => m[0]).filter(Boolean);
+        return {
+            orderNumbers: orderNumbers.length > 0 ? [...new Set(orderNumbers)] : undefined,
+            productSkus: productSkus.length > 0 ? [...new Set(productSkus)] : undefined,
+            monetaryAmounts: monetaryAmounts.length > 0 ? monetaryAmounts : undefined,
+            dates: dates.length > 0 ? dates : undefined,
+            emails: emails.length > 0 ? [...new Set(emails)] : undefined,
+            phoneNumbers: phoneNumbers.length > 0 ? [...new Set(phoneNumbers)] : undefined,
+        };
+    }
+}
+// =============================================================================
+// Singleton and Utility Functions
+// =============================================================================
+let entityService = null;
+export function getEntityExtractionService() {
+    if (!entityService) {
+        entityService = new EntityExtractionService();
+    }
+    return entityService;
+}
+/**
+ * Extract entities from message
+ */
+export async function extractEntities(message) {
+    return getEntityExtractionService().extract(message);
+}
+/**
+ * Extract entities using regex (fallback)
+ */
+export function extractEntitiesRegex(message) {
+    return getEntityExtractionService().extractWithRegex(message);
+}
+/**
+ * Merge extracted entities from multiple sources
+ */
+export function mergeEntities(...entities) {
+    const merged = {};
+    for (const e of entities) {
+        if (e.orderNumbers) {
+            merged.orderNumbers = [
+                ...new Set([...(merged.orderNumbers ?? []), ...e.orderNumbers]),
+            ];
+        }
+        if (e.productNames) {
+            merged.productNames = [
+                ...new Set([...(merged.productNames ?? []), ...e.productNames]),
+            ];
+        }
+        if (e.productSkus) {
+            merged.productSkus = [...new Set([...(merged.productSkus ?? []), ...e.productSkus])];
+        }
+        if (e.dates) {
+            merged.dates = [...(merged.dates ?? []), ...e.dates];
+        }
+        if (e.monetaryAmounts) {
+            merged.monetaryAmounts = [...(merged.monetaryAmounts ?? []), ...e.monetaryAmounts];
+        }
+        if (e.customerReferences) {
+            merged.customerReferences = [
+                ...new Set([...(merged.customerReferences ?? []), ...e.customerReferences]),
+            ];
+        }
+        if (e.companyNames) {
+            merged.companyNames = [
+                ...new Set([...(merged.companyNames ?? []), ...e.companyNames]),
+            ];
+        }
+        if (e.personNames) {
+            merged.personNames = [...new Set([...(merged.personNames ?? []), ...e.personNames])];
+        }
+        if (e.phoneNumbers) {
+            merged.phoneNumbers = [...new Set([...(merged.phoneNumbers ?? []), ...e.phoneNumbers])];
+        }
+        if (e.emails) {
+            merged.emails = [...new Set([...(merged.emails ?? []), ...e.emails])];
+        }
+    }
+    return merged;
+}
+/**
+ * Check if entities contain order reference
+ */
+export function hasOrderReference(entities) {
+    return !!(entities.orderNumbers && entities.orderNumbers.length > 0);
+}
+/**
+ * Check if entities contain product reference
+ */
+export function hasProductReference(entities) {
+    return !!((entities.productNames && entities.productNames.length > 0) ||
+        (entities.productSkus && entities.productSkus.length > 0));
+}
+/**
+ * Get primary order number from entities
+ */
+export function getPrimaryOrderNumber(entities) {
+    return entities.orderNumbers?.[0];
+}
+/**
+ * Get total monetary amount mentioned
+ */
+export function getTotalAmount(entities) {
+    if (!entities.monetaryAmounts || entities.monetaryAmounts.length === 0) {
+        return undefined;
+    }
+    // If only one amount, return it
+    if (entities.monetaryAmounts.length === 1) {
+        return entities.monetaryAmounts[0]?.amount;
+    }
+    // If multiple amounts, return the largest (likely the total)
+    return Math.max(...entities.monetaryAmounts.map((a) => a.amount));
+}
+//# sourceMappingURL=entities.js.map