catalist-support-agent 1.0.0

package/dist/extraction/state-manager.js

@@ -0,0 +1,344 @@
+/**
+ * State Manager Module
+ *
+ * Tracks extraction state for incremental Gmail sync.
+ * Uses Gmail History API to only process new emails since last extraction.
+ */
+import { createClient } from '@supabase/supabase-js';
+// =============================================================================
+// State Manager
+// =============================================================================
+export class StateManager {
+    supabase;
+    constructor(config) {
+        this.supabase = createClient(config.supabaseUrl, config.supabaseServiceRoleKey);
+    }
+    // ===========================================================================
+    // Extraction State Methods
+    // ===========================================================================
+    /**
+     * Get extraction state for an email account
+     */
+    async getState(emailAddress) {
+        const { data, error } = await this.supabase
+            .from('gmail_extraction_state')
+            .select('*')
+            .eq('email_address', emailAddress)
+            .single();
+        if (error || !data) {
+            return null;
+        }
+        return this.mapStateRow(data);
+    }
+    /**
+     * Create or get extraction state
+     */
+    async getOrCreateState(emailAddress) {
+        let state = await this.getState(emailAddress);
+        if (!state) {
+            const { data, error } = await this.supabase
+                .from('gmail_extraction_state')
+                .insert({
+                email_address: emailAddress,
+                last_history_id: null,
+                last_extracted_at: null,
+                total_entries_extracted: 0,
+                consecutive_errors: 0,
+            })
+                .select()
+                .single();
+            if (error) {
+                throw new Error(`Failed to create extraction state: ${error.message}`);
+            }
+            state = this.mapStateRow(data);
+        }
+        return state;
+    }
+    /**
+     * Update extraction state after successful extraction
+     */
+    async updateStateSuccess(emailAddress, updates) {
+        const updateData = {
+            last_extracted_at: new Date().toISOString(),
+            consecutive_errors: 0,
+            last_error: null,
+            last_error_at: null,
+        };
+        if (updates.historyId) {
+            updateData.last_history_id = updates.historyId;
+        }
+        if (updates.entriesExtracted !== undefined) {
+            // Use raw SQL for increment
+            const { data: currentState } = await this.supabase
+                .from('gmail_extraction_state')
+                .select('total_entries_extracted')
+                .eq('email_address', emailAddress)
+                .single();
+            updateData.total_entries_extracted =
+                (currentState?.total_entries_extracted || 0) + updates.entriesExtracted;
+        }
+        if (updates.batchId) {
+            updateData.last_batch_id = updates.batchId;
+        }
+        const { error } = await this.supabase
+            .from('gmail_extraction_state')
+            .update(updateData)
+            .eq('email_address', emailAddress);
+        if (error) {
+            throw new Error(`Failed to update extraction state: ${error.message}`);
+        }
+    }
+    /**
+     * Record extraction error
+     */
+    async recordError(emailAddress, errorMessage) {
+        // Get current state
+        const state = await this.getOrCreateState(emailAddress);
+        const { error } = await this.supabase
+            .from('gmail_extraction_state')
+            .update({
+            consecutive_errors: state.consecutiveErrors + 1,
+            last_error: errorMessage,
+            last_error_at: new Date().toISOString(),
+        })
+            .eq('email_address', emailAddress);
+        if (error) {
+            throw new Error(`Failed to record error: ${error.message}`);
+        }
+    }
+    /**
+     * Check if we should back off due to errors
+     */
+    async shouldBackOff(emailAddress, maxConsecutiveErrors = 5) {
+        const state = await this.getState(emailAddress);
+        if (!state) {
+            return false;
+        }
+        return state.consecutiveErrors >= maxConsecutiveErrors;
+    }
+    // ===========================================================================
+    // Batch Management Methods
+    // ===========================================================================
+    /**
+     * Create a new import batch
+     */
+    async createBatch(emailAccount, dateRangeStart, dateRangeEnd, config) {
+        const { data, error } = await this.supabase
+            .from('gmail_import_batches')
+            .insert({
+            email_account: emailAccount,
+            date_range_start: dateRangeStart.toISOString(),
+            date_range_end: dateRangeEnd.toISOString(),
+            status: 'pending',
+            config_used: config || {},
+        })
+            .select('id')
+            .single();
+        if (error) {
+            throw new Error(`Failed to create batch: ${error.message}`);
+        }
+        return data.id;
+    }
+    /**
+     * Start a batch (mark as in_progress)
+     */
+    async startBatch(batchId, totalThreads) {
+        const { error } = await this.supabase
+            .from('gmail_import_batches')
+            .update({
+            status: 'in_progress',
+            started_at: new Date().toISOString(),
+            total_threads_found: totalThreads,
+        })
+            .eq('id', batchId);
+        if (error) {
+            throw new Error(`Failed to start batch: ${error.message}`);
+        }
+    }
+    /**
+     * Update batch progress
+     */
+    async updateBatchProgress(batchId, progress) {
+        const updateData = {};
+        if (progress.threadsProcessed !== undefined) {
+            updateData.threads_processed = progress.threadsProcessed;
+        }
+        if (progress.entriesCreated !== undefined) {
+            updateData.entries_created = progress.entriesCreated;
+        }
+        if (progress.entriesSkipped !== undefined) {
+            updateData.entries_skipped = progress.entriesSkipped;
+        }
+        if (progress.errorsEncountered !== undefined) {
+            updateData.errors_encountered = progress.errorsEncountered;
+        }
+        const { error } = await this.supabase
+            .from('gmail_import_batches')
+            .update(updateData)
+            .eq('id', batchId);
+        if (error) {
+            throw new Error(`Failed to update batch progress: ${error.message}`);
+        }
+    }
+    /**
+     * Add error to batch error log
+     */
+    async addBatchError(batchId, errorMessage) {
+        // Fetch current error log
+        const { data: batch } = await this.supabase
+            .from('gmail_import_batches')
+            .select('error_log, errors_encountered')
+            .eq('id', batchId)
+            .single();
+        const currentLog = batch?.error_log || [];
+        const newLog = [
+            ...currentLog,
+            { timestamp: new Date().toISOString(), error: errorMessage },
+        ];
+        const { error } = await this.supabase
+            .from('gmail_import_batches')
+            .update({
+            error_log: newLog,
+            errors_encountered: (batch?.errors_encountered || 0) + 1,
+        })
+            .eq('id', batchId);
+        if (error) {
+            throw new Error(`Failed to add batch error: ${error.message}`);
+        }
+    }
+    /**
+     * Complete a batch
+     */
+    async completeBatch(batchId, status = 'completed') {
+        const { error } = await this.supabase
+            .from('gmail_import_batches')
+            .update({
+            status,
+            completed_at: new Date().toISOString(),
+        })
+            .eq('id', batchId);
+        if (error) {
+            throw new Error(`Failed to complete batch: ${error.message}`);
+        }
+    }
+    /**
+     * Get batch info
+     */
+    async getBatch(batchId) {
+        const { data, error } = await this.supabase
+            .from('gmail_import_batches')
+            .select('*')
+            .eq('id', batchId)
+            .single();
+        if (error || !data) {
+            return null;
+        }
+        return this.mapBatchRow(data);
+    }
+    /**
+     * Get recent batches for an email account
+     */
+    async getRecentBatches(emailAccount, limit = 10) {
+        const { data, error } = await this.supabase
+            .from('gmail_import_batches')
+            .select('*')
+            .eq('email_account', emailAccount)
+            .order('created_at', { ascending: false })
+            .limit(limit);
+        if (error || !data) {
+            return [];
+        }
+        return data.map((row) => this.mapBatchRow(row));
+    }
+    // ===========================================================================
+    // Statistics Methods
+    // ===========================================================================
+    /**
+     * Get overall extraction statistics
+     */
+    async getStats() {
+        const [entriesResult, recentBatches] = await Promise.all([
+            this.supabase.rpc('get_gmail_knowledge_stats'),
+            this.getRecentBatches('sales@catalistgroup.co', 5),
+        ]);
+        const stats = entriesResult.data?.[0] || {
+            total_entries: 0,
+            pending_entries: 0,
+            approved_entries: 0,
+            entries_with_embeddings: 0,
+        };
+        return {
+            totalEntries: stats.total_entries || 0,
+            pendingEntries: stats.pending_entries || 0,
+            approvedEntries: stats.approved_entries || 0,
+            entriesWithEmbeddings: stats.entries_with_embeddings || 0,
+            recentBatches,
+        };
+    }
+    // ===========================================================================
+    // Helper Methods
+    // ===========================================================================
+    mapStateRow(row) {
+        return {
+            id: row.id,
+            emailAddress: row.email_address,
+            lastHistoryId: row.last_history_id,
+            lastExtractedAt: row.last_extracted_at ? new Date(row.last_extracted_at) : null,
+            totalEntriesExtracted: row.total_entries_extracted,
+            lastBatchId: row.last_batch_id,
+            consecutiveErrors: row.consecutive_errors,
+            lastError: row.last_error,
+            lastErrorAt: row.last_error_at ? new Date(row.last_error_at) : null,
+            createdAt: new Date(row.created_at),
+            updatedAt: new Date(row.updated_at),
+        };
+    }
+    mapBatchRow(row) {
+        return {
+            id: row.id,
+            emailAccount: row.email_account,
+            dateRangeStart: new Date(row.date_range_start),
+            dateRangeEnd: new Date(row.date_range_end),
+            status: row.status,
+            totalThreadsFound: row.total_threads_found,
+            threadsProcessed: row.threads_processed,
+            entriesCreated: row.entries_created,
+            entriesSkipped: row.entries_skipped,
+            errorsEncountered: row.errors_encountered,
+            startedAt: row.started_at ? new Date(row.started_at) : null,
+            completedAt: row.completed_at ? new Date(row.completed_at) : null,
+            errorLog: row.error_log || [],
+            configUsed: row.config_used || {},
+            createdAt: new Date(row.created_at),
+            updatedAt: new Date(row.updated_at),
+        };
+    }
+}
+// =============================================================================
+// Singleton Instance
+// =============================================================================
+let stateManagerInstance = null;
+/**
+ * Get singleton state manager instance
+ */
+export function getStateManager() {
+    if (!stateManagerInstance) {
+        const supabaseUrl = process.env.SUPABASE_URL || process.env.NEXT_PUBLIC_SUPABASE_URL;
+        const supabaseServiceRoleKey = process.env.SUPABASE_SERVICE_ROLE_KEY;
+        if (!supabaseUrl || !supabaseServiceRoleKey) {
+            throw new Error('SUPABASE_URL and SUPABASE_SERVICE_ROLE_KEY are required');
+        }
+        stateManagerInstance = new StateManager({
+            supabaseUrl,
+            supabaseServiceRoleKey,
+        });
+    }
+    return stateManagerInstance;
+}
+/**
+ * Reset the singleton (for testing)
+ */
+export function resetStateManager() {
+    stateManagerInstance = null;
+}
+//# sourceMappingURL=state-manager.js.map

package/dist/extraction/state-manager.js.map

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

package/dist/generation/index.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Response Generation Module
+ *
+ * Generates brand-compliant responses using Claude:
+ * - Assembles context from analysis and knowledge
+ * - Applies brand voice guidelines
+ * - Enforces forbidden terms rules
+ * - Formats for target channel
+ * - Validates before sending
+ */
+import { type Config } from '../config.js';
+import type { GeneratedResponse, InboundMessage, AnalysisResult, KnowledgeContext, SupportChannel } from '../types.js';
+export declare class ResponseGenerationService {
+    private client;
+    private effectiveConfig;
+    constructor(configOverride?: Config);
+    private getClient;
+    /**
+     * Generate a response for a message
+     */
+    generateResponse(message: InboundMessage, analysis: AnalysisResult, knowledge: KnowledgeContext, options?: {
+        targetChannel?: SupportChannel;
+        maxAttempts?: number;
+    }): Promise<GeneratedResponse>;
+    /**
+     * Build context prompt for Claude
+     */
+    private buildContextPrompt;
+    /**
+     * Call Claude to generate response
+     */
+    private callClaude;
+    /**
+     * Format response for target channel
+     */
+    private formatForChannel;
+    /**
+     * Format text as HTML for email
+     */
+    private formatAsHtml;
+    /**
+     * Format text for SMS (truncate and simplify)
+     */
+    private formatForSms;
+    /**
+     * Format text as Slack blocks
+     */
+    private formatAsSlackBlocks;
+    /**
+     * Extract citations from response
+     */
+    private extractCitations;
+    /**
+     * Calculate quality score for response
+     */
+    private calculateQualityScore;
+}
+/**
+ * Remove common AI writing patterns to make responses sound more natural
+ * Based on Wikipedia's "Signs of AI writing" guide
+ */
+export declare function humanizeResponse(text: string): string;
+export declare function getResponseGenerationService(configOverride?: Config): ResponseGenerationService;
+/**
+ * Generate a response for a message
+ */
+export declare function generateResponse(message: InboundMessage, analysis: AnalysisResult, knowledge: KnowledgeContext, options?: {
+    targetChannel?: SupportChannel;
+    maxAttempts?: number;
+}): Promise<GeneratedResponse>;
+/**
+ * Check if response is ready to send
+ */
+export declare function isResponseReadyToSend(response: GeneratedResponse): boolean;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AASnD,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,gBAAgB,EAIhB,cAAc,EAGf,MAAM,aAAa,CAAC;AAgKrB,qBAAa,yBAAyB;IACpC,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,eAAe,CAAS;gBAEpB,cAAc,CAAC,EAAE,MAAM;IAInC,OAAO,CAAC,SAAS;IAejB;;OAEG;IACG,gBAAgB,CACpB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,gBAAgB,EAC3B,OAAO,GAAE;QACP,aAAa,CAAC,EAAE,cAAc,CAAC;QAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;KACjB,GACL,OAAO,CAAC,iBAAiB,CAAC;IAiH7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwH1B;;OAEG;YACW,UAAU;IA2BxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoCxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAkBpB;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA+BxB;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAqB9B;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqGrD;AAQD,wBAAgB,4BAA4B,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,yBAAyB,CAU/F;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,gBAAgB,EAC3B,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,cAAc,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACjE,OAAO,CAAC,iBAAiB,CAAC,CAE5B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAK1E"}