catalist-support-agent 1.0.0

package/dist/delivery/index.js

@@ -0,0 +1,435 @@
+/**
+ * Delivery Pipeline Module
+ *
+ * Handles response delivery across all channels:
+ * - Email via Postmark
+ * - SMS via Twilio
+ * - Slack messages via API
+ *
+ * Includes retry logic, status tracking, and engagement monitoring.
+ */
+import { createClient } from '@supabase/supabase-js';
+import { config, isChannelEnabled } from '../config.js';
+import { DeliveryError } from '../errors.js';
+import { createDeliveryId } from '../types.js';
+// =============================================================================
+// Delivery Service
+// =============================================================================
+export class DeliveryService {
+    supabase;
+    constructor() {
+        this.supabase = createClient(config.supabase.url, config.supabase.serviceRoleKey);
+    }
+    /**
+     * Deliver a response via the appropriate channel
+     */
+    async deliver(response, channel, recipientInfo) {
+        const deliveryId = createDeliveryId(`del-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`);
+        // Create delivery record
+        const { error: insertError } = await this.supabase.from('support_deliveries').insert({
+            id: deliveryId,
+            response_id: response.id,
+            conversation_id: response.conversationId,
+            channel,
+            status: 'pending',
+            status_data: { queuedAt: new Date().toISOString() },
+        });
+        if (insertError) {
+            throw new DeliveryError('Failed to create delivery record', channel, 'preparation', {
+                cause: new Error(insertError.message),
+                conversationId: response.conversationId,
+                messageId: response.messageId,
+            });
+        }
+        try {
+            // Route to appropriate delivery method
+            let result;
+            switch (channel) {
+                case 'email':
+                    result = await this.deliverEmail(response, recipientInfo);
+                    break;
+                case 'sms':
+                    result = await this.deliverSms(response, recipientInfo);
+                    break;
+                case 'slack':
+                    result = await this.deliverSlack(response, recipientInfo);
+                    break;
+                default:
+                    throw new DeliveryError(`Unknown channel: ${channel}`, channel, 'preparation');
+            }
+            // Update delivery status
+            await this.updateDeliveryStatus(deliveryId, {
+                status: result.success ? 'sent' : 'failed',
+                sentAt: result.success ? new Date().toISOString() : undefined,
+                messageId: result.messageId,
+                ...(result.error && {
+                    failedAt: new Date().toISOString(),
+                    error: result.error,
+                    retryable: result.retryable ?? false,
+                }),
+            });
+            return {
+                deliveryId,
+                success: result.success,
+                messageId: result.messageId,
+                error: result.error,
+                timestamp: new Date().toISOString(),
+            };
+        }
+        catch (error) {
+            // Update delivery status to failed
+            await this.updateDeliveryStatus(deliveryId, {
+                status: 'failed',
+                failedAt: new Date().toISOString(),
+                error: error instanceof Error ? error.message : 'Unknown error',
+                retryable: error instanceof DeliveryError ? error.recoverable : false,
+            });
+            throw error;
+        }
+    }
+    /**
+     * Deliver response via email (Postmark)
+     */
+    async deliverEmail(response, recipient) {
+        if (!isChannelEnabled('postmark')) {
+            return {
+                success: false,
+                error: 'Postmark not configured',
+                retryable: false,
+            };
+        }
+        if (!recipient.email) {
+            return {
+                success: false,
+                error: 'No email address provided',
+                retryable: false,
+            };
+        }
+        const emailFormatting = response.formatting.email;
+        if (!emailFormatting) {
+            return {
+                success: false,
+                error: 'No email formatting available',
+                retryable: false,
+            };
+        }
+        try {
+            // Call Postmark API
+            const postmarkResponse = await fetch('https://api.postmarkapp.com/email', {
+                method: 'POST',
+                headers: {
+                    Accept: 'application/json',
+                    'Content-Type': 'application/json',
+                    'X-Postmark-Server-Token': config.postmark.serverToken || '',
+                },
+                body: JSON.stringify({
+                    From: config.postmark.fromAddress,
+                    To: recipient.email,
+                    Subject: emailFormatting.subject,
+                    TextBody: emailFormatting.textBody,
+                    HtmlBody: emailFormatting.htmlBody,
+                    ReplyTo: config.postmark.replyToAddress || config.postmark.fromAddress,
+                    MessageStream: config.postmark.messageStream,
+                    TrackOpens: true,
+                    TrackLinks: 'HtmlOnly',
+                    Tag: 'support-agent',
+                    Metadata: {
+                        conversationId: response.conversationId,
+                        responseId: response.id,
+                    },
+                }),
+            });
+            if (!postmarkResponse.ok) {
+                const errorData = await postmarkResponse.json().catch(() => ({}));
+                return {
+                    success: false,
+                    error: `Postmark error: ${errorData.Message || postmarkResponse.statusText}`,
+                    retryable: postmarkResponse.status >= 500,
+                };
+            }
+            const result = await postmarkResponse.json();
+            return {
+                success: true,
+                messageId: result.MessageID,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error',
+                retryable: true,
+            };
+        }
+    }
+    /**
+     * Deliver response via SMS (Twilio)
+     */
+    async deliverSms(response, recipient) {
+        if (!isChannelEnabled('twilio')) {
+            return {
+                success: false,
+                error: 'Twilio not configured',
+                retryable: false,
+            };
+        }
+        if (!recipient.phone) {
+            return {
+                success: false,
+                error: 'No phone number provided',
+                retryable: false,
+            };
+        }
+        const smsFormatting = response.formatting.sms;
+        if (!smsFormatting) {
+            return {
+                success: false,
+                error: 'No SMS formatting available',
+                retryable: false,
+            };
+        }
+        try {
+            const accountSid = config.twilio.accountSid;
+            const authToken = config.twilio.authToken;
+            const body = new URLSearchParams({
+                To: recipient.phone,
+                From: config.twilio.fromNumber || '',
+                Body: smsFormatting.body,
+            });
+            if (config.twilio.messagingServiceSid) {
+                body.set('MessagingServiceSid', config.twilio.messagingServiceSid);
+                body.delete('From');
+            }
+            const twilioResponse = await fetch(`https://api.twilio.com/2010-04-01/Accounts/${accountSid}/Messages.json`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/x-www-form-urlencoded',
+                    Authorization: `Basic ${Buffer.from(`${accountSid}:${authToken}`).toString('base64')}`,
+                },
+                body: body.toString(),
+            });
+            if (!twilioResponse.ok) {
+                const errorData = await twilioResponse.json().catch(() => ({}));
+                return {
+                    success: false,
+                    error: `Twilio error: ${errorData.message || twilioResponse.statusText}`,
+                    retryable: twilioResponse.status >= 500,
+                };
+            }
+            const result = await twilioResponse.json();
+            return {
+                success: true,
+                messageId: result.sid,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error',
+                retryable: true,
+            };
+        }
+    }
+    /**
+     * Deliver response via Slack
+     */
+    async deliverSlack(response, recipient) {
+        if (!isChannelEnabled('slack')) {
+            return {
+                success: false,
+                error: 'Slack not configured',
+                retryable: false,
+            };
+        }
+        if (!recipient.slackChannelId) {
+            return {
+                success: false,
+                error: 'No Slack channel provided',
+                retryable: false,
+            };
+        }
+        const slackFormatting = response.formatting.slack;
+        if (!slackFormatting) {
+            return {
+                success: false,
+                error: 'No Slack formatting available',
+                retryable: false,
+            };
+        }
+        try {
+            const slackResponse = await fetch('https://slack.com/api/chat.postMessage', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json; charset=utf-8',
+                    Authorization: `Bearer ${config.slack.botToken}`,
+                },
+                body: JSON.stringify({
+                    channel: recipient.slackChannelId,
+                    text: slackFormatting.text,
+                    blocks: slackFormatting.blocks,
+                    thread_ts: recipient.slackThreadTs,
+                    unfurl_links: false,
+                    unfurl_media: false,
+                }),
+            });
+            const result = await slackResponse.json();
+            if (!result.ok) {
+                return {
+                    success: false,
+                    error: `Slack error: ${result.error}`,
+                    retryable: ['rate_limited', 'internal_error'].includes(result.error),
+                };
+            }
+            return {
+                success: true,
+                messageId: result.ts,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error',
+                retryable: true,
+            };
+        }
+    }
+    /**
+     * Update delivery status
+     */
+    async updateDeliveryStatus(deliveryId, status) {
+        await this.supabase
+            .from('support_deliveries')
+            .update({
+            status: status.status,
+            status_data: status,
+            external_message_id: status.messageId,
+        })
+            .eq('id', deliveryId);
+    }
+    /**
+     * Retry a failed delivery with exponential backoff
+     */
+    async retryDelivery(deliveryId, maxRetries = 3) {
+        const { data: delivery, error } = await this.supabase
+            .from('support_deliveries')
+            .select('*, support_responses(*)')
+            .eq('id', deliveryId)
+            .single();
+        if (error || !delivery) {
+            throw new DeliveryError('Delivery not found', 'email', 'preparation', {
+                context: { deliveryId },
+            });
+        }
+        if (delivery.retry_count >= maxRetries) {
+            return null;
+        }
+        // Exponential backoff
+        const backoffMs = Math.pow(2, delivery.retry_count) * 1000;
+        await new Promise((resolve) => setTimeout(resolve, backoffMs));
+        // Update retry count
+        await this.supabase
+            .from('support_deliveries')
+            .update({
+            retry_count: delivery.retry_count + 1,
+            retry_history: [
+                ...(delivery.retry_history || []),
+                {
+                    attempt: delivery.retry_count + 1,
+                    timestamp: new Date().toISOString(),
+                },
+            ],
+        })
+            .eq('id', deliveryId);
+        // Re-attempt delivery (would need full response and recipient info)
+        // This is a placeholder - actual implementation would fetch and retry
+        return null;
+    }
+    /**
+     * Handle delivery status webhook (Postmark, Twilio callbacks)
+     */
+    async handleStatusWebhook(provider, messageId, status, details) {
+        const { data: delivery } = await this.supabase
+            .from('support_deliveries')
+            .select('id')
+            .eq('external_message_id', messageId)
+            .single();
+        if (!delivery) {
+            console.warn(`Delivery not found for message: ${messageId}`);
+            return;
+        }
+        const statusData = status === 'delivered'
+            ? { status: 'delivered', deliveredAt: new Date().toISOString(), messageId }
+            : status === 'bounced'
+                ? { status: 'bounced', bouncedAt: new Date().toISOString(), bounceType: details?.bounceType ?? 'hard_bounce' }
+                : { status: 'failed', failedAt: new Date().toISOString(), error: details?.error ?? 'Unknown', retryable: false };
+        await this.supabase
+            .from('support_deliveries')
+            .update({
+            status: statusData.status,
+            status_data: statusData,
+        })
+            .eq('id', delivery.id);
+    }
+    /**
+     * Record engagement metrics (opens, clicks)
+     */
+    async recordEngagement(messageId, event, details) {
+        const { data: delivery } = await this.supabase
+            .from('support_deliveries')
+            .select('id, engagement_data')
+            .eq('external_message_id', messageId)
+            .single();
+        if (!delivery) {
+            return;
+        }
+        const existingData = delivery.engagement_data || {};
+        const events = existingData.events || [];
+        await this.supabase
+            .from('support_deliveries')
+            .update({
+            engagement_data: {
+                ...existingData,
+                events: [
+                    ...events,
+                    {
+                        type: event,
+                        timestamp: new Date().toISOString(),
+                        ...(details?.link && { link: details.link }),
+                    },
+                ],
+                [`${event}Count`]: (existingData[`${event}Count`] || 0) + 1,
+                [`first${event.charAt(0).toUpperCase() + event.slice(1)}`]: existingData[`first${event.charAt(0).toUpperCase() + event.slice(1)}`] ||
+                    new Date().toISOString(),
+            },
+        })
+            .eq('id', delivery.id);
+    }
+}
+// =============================================================================
+// Singleton and Utility Functions
+// =============================================================================
+let deliveryService = null;
+export function getDeliveryService() {
+    if (!deliveryService) {
+        deliveryService = new DeliveryService();
+    }
+    return deliveryService;
+}
+/**
+ * Deliver a response
+ */
+export async function deliverResponse(response, channel, recipient) {
+    return getDeliveryService().deliver(response, channel, recipient);
+}
+/**
+ * Handle delivery status webhook
+ */
+export async function handleDeliveryWebhook(provider, messageId, status, details) {
+    return getDeliveryService().handleStatusWebhook(provider, messageId, status, details);
+}
+/**
+ * Record engagement event
+ */
+export async function recordEngagementEvent(messageId, event, details) {
+    return getDeliveryService().recordEngagement(messageId, event, details);
+}
+//# sourceMappingURL=index.js.map

package/dist/delivery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/delivery/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAkB,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,aAAa,EAA4B,MAAM,cAAc,CAAC;AAUvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF,MAAM,OAAO,eAAe;IAClB,QAAQ,CAAiB;IAEjC;QACE,IAAI,CAAC,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IACpF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,QAA2B,EAC3B,OAAuB,EACvB,aAA4B;QAE5B,MAAM,UAAU,GAAG,gBAAgB,CACjC,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAC9D,CAAC;QAEF,yBAAyB;QACzB,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,MAAM,CAAC;YACnF,EAAE,EAAE,UAAU;YACd,WAAW,EAAE,QAAQ,CAAC,EAAE;YACxB,eAAe,EAAE,QAAQ,CAAC,cAAc;YACxC,OAAO;YACP,MAAM,EAAE,SAAS;YACjB,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE;SACpD,CAAC,CAAC;QAEH,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,IAAI,aAAa,CAAC,kCAAkC,EAAE,OAAO,EAAE,aAAa,EAAE;gBAClF,KAAK,EAAE,IAAI,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC;gBACrC,cAAc,EAAE,QAAQ,CAAC,cAAc;gBACvC,SAAS,EAAE,QAAQ,CAAC,SAAS;aAC9B,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC;YACH,uCAAuC;YACvC,IAAI,MAA6B,CAAC;YAElC,QAAQ,OAAO,EAAE,CAAC;gBAChB,KAAK,OAAO;oBACV,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;oBAC1D,MAAM;gBACR,KAAK,KAAK;oBACR,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;oBACxD,MAAM;gBACR,KAAK,OAAO;oBACV,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;oBAC1D,MAAM;gBACR;oBACE,MAAM,IAAI,aAAa,CAAC,oBAAoB,OAAO,EAAE,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;YACnF,CAAC;YAED,yBAAyB;YACzB,MAAM,IAAI,CAAC,oBAAoB,CAAC,UAAU,EAAE;gBAC1C,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;gBAC1C,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS;gBAC7D,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI;oBAClB,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBAClC,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,KAAK;iBACrC,CAAC;aACe,CAAC,CAAC;YAErB,OAAO;gBACL,UAAU;gBACV,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,mCAAmC;YACnC,MAAM,IAAI,CAAC,oBAAoB,CAAC,UAAU,EAAE;gBAC1C,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAClC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;gBAC/D,SAAS,EAAE,KAAK,YAAY,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK;aACtE,CAAC,CAAC;YAEH,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY,CACxB,QAA2B,EAC3B,SAAwB;QAExB,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,CAAC;YAClC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,yBAAyB;gBAChC,SAAS,EAAE,KAAK;aACjB,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,2BAA2B;gBAClC,SAAS,EAAE,KAAK;aACjB,CAAC;QACJ,CAAC;QAED,MAAM,eAAe,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC;QAClD,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,+BAA+B;gBACtC,SAAS,EAAE,KAAK;aACjB,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,oBAAoB;YACpB,MAAM,gBAAgB,GAAG,MAAM,KAAK,CAAC,mCAAmC,EAAE;gBACxE,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,MAAM,EAAE,kBAAkB;oBAC1B,cAAc,EAAE,kBAAkB;oBAClC,yBAAyB,EAAE,MAAM,CAAC,QAAQ,CAAC,WAAW,IAAI,EAAE;iBAC7D;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,WAAW;oBACjC,EAAE,EAAE,SAAS,CAAC,KAAK;oBACnB,OAAO,EAAE,eAAe,CAAC,OAAO;oBAChC,QAAQ,EAAE,eAAe,CAAC,QAAQ;oBAClC,QAAQ,EAAE,eAAe,CAAC,QAAQ;oBAClC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,cAAc,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW;oBACtE,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,aAAa;oBAC5C,UAAU,EAAE,IAAI;oBAChB,UAAU,EAAE,UAAU;oBACtB,GAAG,EAAE,eAAe;oBACpB,QAAQ,EAAE;wBACR,cAAc,EAAE,QAAQ,CAAC,cAAc;wBACvC,UAAU,EAAE,QAAQ,CAAC,EAAE;qBACxB;iBACF,CAAC;aACH,CAAC,CAAC;YAEH,IAAI,CAAC,gBAAgB,CAAC,EAAE,EAAE,CAAC;gBACzB,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAClE,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,mBAAmB,SAAS,CAAC,OAAO,IAAI,gBAAgB,CAAC,UAAU,EAAE;oBAC5E,SAAS,EAAE,gBAAgB,CAAC,MAAM,IAAI,GAAG;iBAC1C,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,CAAC;YAE7C,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;gBAC/D,SAAS,EAAE,IAAI;aAChB,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,UAAU,CACtB,QAA2B,EAC3B,SAAwB;QAExB,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,uBAAuB;gBAC9B,SAAS,EAAE,KAAK;aACjB,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,0BAA0B;gBACjC,SAAS,EAAE,KAAK;aACjB,CAAC;QACJ,CAAC;QAED,MAAM,aAAa,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC;QAC9C,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,6BAA6B;gBACpC,SAAS,EAAE,KAAK;aACjB,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;YAC5C,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;YAE1C,MAAM,IAAI,GAAG,IAAI,eAAe,CAAC;gBAC/B,EAAE,EAAE,SAAS,CAAC,KAAK;gBACnB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE;gBACpC,IAAI,EAAE,aAAa,CAAC,IAAI;aACzB,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;gBACtC,IAAI,CAAC,GAAG,CAAC,qBAAqB,EAAE,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;gBACnE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACtB,CAAC;YAED,MAAM,cAAc,GAAG,MAAM,KAAK,CAChC,8CAA8C,UAAU,gBAAgB,EACxE;gBACE,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,mCAAmC;oBACnD,aAAa,EAAE,SAAS,MAAM,CAAC,IAAI,CAAC,GAAG,UAAU,IAAI,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;iBACvF;gBACD,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE;aACtB,CACF,CAAC;YAEF,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,CAAC;gBACvB,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAChE,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,iBAAiB,SAAS,CAAC,OAAO,IAAI,cAAc,CAAC,UAAU,EAAE;oBACxE,SAAS,EAAE,cAAc,CAAC,MAAM,IAAI,GAAG;iBACxC,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,CAAC;YAE3C,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,MAAM,CAAC,GAAG;aACtB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;gBAC/D,SAAS,EAAE,IAAI;aAChB,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY,CACxB,QAA2B,EAC3B,SAAwB;QAExB,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,sBAAsB;gBAC7B,SAAS,EAAE,KAAK;aACjB,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC;YAC9B,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,2BAA2B;gBAClC,SAAS,EAAE,KAAK;aACjB,CAAC;QACJ,CAAC;QAED,MAAM,eAAe,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC;QAClD,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,+BAA+B;gBACtC,SAAS,EAAE,KAAK;aACjB,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,MAAM,KAAK,CAAC,wCAAwC,EAAE;gBAC1E,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,iCAAiC;oBACjD,aAAa,EAAE,UAAU,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE;iBACjD;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,OAAO,EAAE,SAAS,CAAC,cAAc;oBACjC,IAAI,EAAE,eAAe,CAAC,IAAI;oBAC1B,MAAM,EAAE,eAAe,CAAC,MAAM;oBAC9B,SAAS,EAAE,SAAS,CAAC,aAAa;oBAClC,YAAY,EAAE,KAAK;oBACnB,YAAY,EAAE,KAAK;iBACpB,CAAC;aACH,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,CAAC;YAE1C,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBACf,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,gBAAgB,MAAM,CAAC,KAAK,EAAE;oBACrC,SAAS,EAAE,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC;iBACrE,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,MAAM,CAAC,EAAE;aACrB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;gBAC/D,SAAS,EAAE,IAAI;aAChB,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,oBAAoB,CAChC,UAAsB,EACtB,MAAwD;QAExD,MAAM,IAAI,CAAC,QAAQ;aAChB,IAAI,CAAC,oBAAoB,CAAC;aAC1B,MAAM,CAAC;YACN,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,WAAW,EAAE,MAAM;YACnB,mBAAmB,EAAE,MAAM,CAAC,SAAS;SACtC,CAAC;aACD,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CACjB,UAAsB,EACtB,aAAqB,CAAC;QAEtB,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ;aAClD,IAAI,CAAC,oBAAoB,CAAC;aAC1B,MAAM,CAAC,yBAAyB,CAAC;aACjC,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC;aACpB,MAAM,EAAE,CAAC;QAEZ,IAAI,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvB,MAAM,IAAI,aAAa,CAAC,oBAAoB,EAAE,OAAO,EAAE,aAAa,EAAE;gBACpE,OAAO,EAAE,EAAE,UAAU,EAAE;aACxB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,QAAQ,CAAC,WAAW,IAAI,UAAU,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,sBAAsB;QACtB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;QAC3D,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;QAE/D,qBAAqB;QACrB,MAAM,IAAI,CAAC,QAAQ;aAChB,IAAI,CAAC,oBAAoB,CAAC;aAC1B,MAAM,CAAC;YACN,WAAW,EAAE,QAAQ,CAAC,WAAW,GAAG,CAAC;YACrC,aAAa,EAAE;gBACb,GAAG,CAAC,QAAQ,CAAC,aAAa,IAAI,EAAE,CAAC;gBACjC;oBACE,OAAO,EAAE,QAAQ,CAAC,WAAW,GAAG,CAAC;oBACjC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC;aACF;SACF,CAAC;aACD,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAExB,oEAAoE;QACpE,sEAAsE;QAEtE,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,mBAAmB,CACvB,QAAyC,EACzC,SAAiB,EACjB,MAA0C,EAC1C,OAAqD;QAErD,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ;aAC3C,IAAI,CAAC,oBAAoB,CAAC;aAC1B,MAAM,CAAC,IAAI,CAAC;aACZ,EAAE,CAAC,qBAAqB,EAAE,SAAS,CAAC;aACpC,MAAM,EAAE,CAAC;QAEZ,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC,mCAAmC,SAAS,EAAE,CAAC,CAAC;YAC7D,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GACd,MAAM,KAAK,WAAW;YACpB,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE;YAC3E,CAAC,CAAC,MAAM,KAAK,SAAS;gBACpB,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,aAAa,EAAE;gBAC9G,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAEvH,MAAM,IAAI,CAAC,QAAQ;aAChB,IAAI,CAAC,oBAAoB,CAAC;aAC1B,MAAM,CAAC;YACN,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,WAAW,EAAE,UAAU;SACxB,CAAC;aACD,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CACpB,SAAiB,EACjB,KAAuB,EACvB,OAA2B;QAE3B,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ;aAC3C,IAAI,CAAC,oBAAoB,CAAC;aAC1B,MAAM,CAAC,qBAAqB,CAAC;aAC7B,EAAE,CAAC,qBAAqB,EAAE,SAAS,CAAC;aACpC,MAAM,EAAE,CAAC;QAEZ,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QAED,MAAM,YAAY,GAAI,QAAQ,CAAC,eAA2C,IAAI,EAAE,CAAC;QACjF,MAAM,MAAM,GAAI,YAAY,CAAC,MAAoB,IAAI,EAAE,CAAC;QAExD,MAAM,IAAI,CAAC,QAAQ;aAChB,IAAI,CAAC,oBAAoB,CAAC;aAC1B,MAAM,CAAC;YACN,eAAe,EAAE;gBACf,GAAG,YAAY;gBACf,MAAM,EAAE;oBACN,GAAG,MAAM;oBACT;wBACE,IAAI,EAAE,KAAK;wBACX,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;wBACnC,GAAG,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;qBAC7C;iBACF;gBACD,CAAC,GAAG,KAAK,OAAO,CAAC,EAAE,CAAE,YAAY,CAAC,GAAG,KAAK,OAAO,CAAY,IAAI,CAAC,CAAC,GAAG,CAAC;gBACvE,CAAC,QAAQ,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EACxD,YAAY,CAAC,QAAQ,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;oBACtE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aAC3B;SACF,CAAC;aACD,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;CACF;AA4BD,gFAAgF;AAChF,kCAAkC;AAClC,gFAAgF;AAEhF,IAAI,eAAe,GAA2B,IAAI,CAAC;AAEnD,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;IAC1C,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAA2B,EAC3B,OAAuB,EACvB,SAAwB;IAExB,OAAO,kBAAkB,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,QAAyC,EACzC,SAAiB,EACjB,MAA0C,EAC1C,OAAqD;IAErD,OAAO,kBAAkB,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACxF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,SAAiB,EACjB,KAAuB,EACvB,OAA2B;IAE3B,OAAO,kBAAkB,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAC1E,CAAC"}

package/dist/embeddings/cache.d.ts

@@ -0,0 +1,96 @@
+/**
+ * LRU Cache for Embedding Queries
+ *
+ * In-memory cache with TTL support to reduce redundant embedding API calls.
+ * Stores query text -> embedding vector mappings.
+ */
+/**
+ * Simple LRU Cache with TTL support
+ */
+export declare class LRUCache<K, V> {
+    private cache;
+    private readonly maxSize;
+    private readonly ttlMs;
+    constructor(maxSize?: number, ttlMs?: number);
+    /**
+     * Get a value from the cache
+     */
+    get(key: K): V | undefined;
+    /**
+     * Set a value in the cache
+     */
+    set(key: K, value: V, customTtlMs?: number): void;
+    /**
+     * Check if key exists and is not expired
+     */
+    has(key: K): boolean;
+    /**
+     * Delete a key from the cache
+     */
+    delete(key: K): boolean;
+    /**
+     * Clear all entries
+     */
+    clear(): void;
+    /**
+     * Get current cache size
+     */
+    get size(): number;
+    /**
+     * Remove expired entries
+     */
+    prune(): number;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        size: number;
+        maxSize: number;
+        ttlMs: number;
+    };
+}
+/**
+ * Specialized cache for embedding vectors
+ * Uses content hash as key to handle exact and near-duplicate queries
+ */
+export declare class EmbeddingCache {
+    private cache;
+    private hits;
+    private misses;
+    constructor(maxSize?: number, ttlMs?: number);
+    /**
+     * Generate a cache key from text
+     * Simple hash function for in-memory use
+     */
+    private generateKey;
+    /**
+     * Get embedding from cache
+     */
+    get(text: string): number[] | undefined;
+    /**
+     * Store embedding in cache
+     */
+    set(text: string, embedding: number[]): void;
+    /**
+     * Check if text has cached embedding
+     */
+    has(text: string): boolean;
+    /**
+     * Clear the cache
+     */
+    clear(): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        size: number;
+        hits: number;
+        misses: number;
+        hitRate: number;
+    };
+    /**
+     * Prune expired entries
+     */
+    prune(): number;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/embeddings/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/embeddings/cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;GAEG;AACH,qBAAa,QAAQ,CAAC,CAAC,EAAE,CAAC;IACxB,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,OAAO,GAAE,MAAa,EAAE,KAAK,GAAE,MAAe;IAM1D;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAoB1B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAkBjD;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAYpB;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAIvB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,KAAK,IAAI,MAAM;IAcf;;OAEG;IACH,QAAQ,IAAI;QACV,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;KACf;CAOF;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAAa;gBAEf,OAAO,GAAE,MAAa,EAAE,KAAK,GAAE,MAAe;IAI1D;;;OAGG;IACH,OAAO,CAAC,WAAW;IAcnB;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS;IAavC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAK5C;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAK1B;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,QAAQ,IAAI;QACV,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB;IAUD;;OAEG;IACH,KAAK,IAAI,MAAM;CAGhB"}