@vezlo/assistant-server 2.7.0 → 2.8.0

package/dist/src/services/ResponseGenerationService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResponseGenerationService.d.ts","sourceRoot":"","sources":["../../../src/services/ResponseGenerationService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAGvC,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,OAAO,EAAE,KAAK,CAAC;QACb,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE;QACjB,mBAAmB,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACvF,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC,CAAC;CACJ;AAED,qBAAa,yBAAyB;IACpC,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,iBAAiB,CAAS;gBAGhC,aAAa,EAAE,aAAa,GAAG,SAAS,EACxC,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,iBAAiB,EAAE,MAAM;IAO3B;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAkBlG;;;OAGG;IACH,kBAAkB,CAChB,MAAM,EAAE,0BAA0B,EAClC,kBAAkB,EAAE,MAAM,GACzB,MAAM,GAAG,IAAI;IAmBhB;;OAEG;IACG,mBAAmB,CACvB,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,qBAAqB,CAAC;IAsFjC;;OAEG;IACH,gBAAgB,CACd,QAAQ,EAAE,WAAW,EAAE,EACvB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,GAC/B;QACD,mBAAmB,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACvF,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B;IAUD;;OAEG;IACH,YAAY,IAAI,SAAS,GAAG,SAAS;IAIrC;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAa5B"}

package/dist/src/services/ResponseGenerationService.js

@@ -0,0 +1,165 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseGenerationService = void 0;
+const logger_1 = __importDefault(require("../config/logger"));
+class ResponseGenerationService {
+    constructor(intentService, aiService, chatHistoryLength) {
+        this.intentService = intentService;
+        this.aiService = aiService;
+        this.chatHistoryLength = chatHistoryLength;
+    }
+    /**
+     * Classify user intent
+     */
+    async classifyIntent(message, history) {
+        if (!this.intentService) {
+            return {
+                intent: 'knowledge',
+                needsGuardrail: false,
+                contactEmail: null
+            };
+        }
+        const resolvedHistory = Array.isArray(history) ? history : [];
+        logger_1.default.info('🧭 Classifying user intent...');
+        return this.intentService.classify({
+            message,
+            conversationHistory: resolvedHistory
+        });
+    }
+    /**
+     * Handle intent classification result
+     * Returns response content if non-knowledge intent, null if knowledge intent
+     */
+    handleIntentResult(result, userMessageContent) {
+        if (result.needsGuardrail && result.intent !== 'guardrail') {
+            logger_1.default.info('🛡️ Guardrail triggered');
+            return `I can help with documentation or implementation guidance, but I can't share credentials or confidential configuration. Please contact your system administrator or support for access.`;
+        }
+        logger_1.default.info(`🧾 Intent result: ${result.intent}${result.needsGuardrail ? ' (guardrail triggered)' : ''}`);
+        // For non-knowledge intents, return the response content to be streamed
+        if (result.intent !== 'knowledge') {
+            const responseContent = result.response || this.getFallbackResponse(result.intent);
+            return responseContent;
+        }
+        // Knowledge intent - proceed to RAG flow (return null to indicate streaming will happen later)
+        logger_1.default.info('📚 Intent requires knowledge lookup; proceeding with RAG flow.');
+        return null;
+    }
+    /**
+     * Search knowledge base and extract sources
+     */
+    async searchKnowledgeBase(query, companyId) {
+        const sources = [];
+        let knowledgeResults = null;
+        const aiServiceAny = this.aiService;
+        if (!aiServiceAny || !aiServiceAny.knowledgeBaseService) {
+            logger_1.default.warn('⚠️  AI service or knowledge base service not available');
+            return { knowledgeResults: null, sources: [] };
+        }
+        try {
+            logger_1.default.info(`🔍 Searching KB: query="${query.substring(0, 50)}...", companyId=${companyId}`);
+            const searchResults = await aiServiceAny.knowledgeBaseService.search(query, {
+                limit: 5,
+                company_id: companyId
+            });
+            logger_1.default.info(`📊 Found knowledge base results: ${searchResults.length}`);
+            if (searchResults.length > 0) {
+                knowledgeResults = '\n\nRelevant information from knowledge base:\n';
+                searchResults.forEach((result) => {
+                    const title = result.title || 'Untitled';
+                    const content = result.content || '';
+                    if (content.trim()) {
+                        knowledgeResults += `- ${title}: ${content}\n`;
+                        // Extract chunk indices from metadata.chunk_range (e.g., "0-2" -> [0,1,2])
+                        let chunkIndices = [];
+                        if (result.metadata?.chunk_range) {
+                            const [start, end] = result.metadata.chunk_range.split('-').map((n) => parseInt(n, 10));
+                            if (!isNaN(start) && !isNaN(end)) {
+                                for (let i = start; i <= end; i++) {
+                                    chunkIndices.push(i);
+                                }
+                            }
+                        }
+                        // Add to sources array (deduplicate by document_uuid)
+                        if (!sources.find(s => s.document_uuid === result.id)) {
+                            sources.push({
+                                document_uuid: result.id,
+                                document_title: title,
+                                chunk_indices: chunkIndices
+                            });
+                        }
+                        else {
+                            const existing = sources.find(s => s.document_uuid === result.id);
+                            if (existing) {
+                                // Merge chunk indices
+                                chunkIndices.forEach(idx => {
+                                    if (!existing.chunk_indices.includes(idx)) {
+                                        existing.chunk_indices.push(idx);
+                                    }
+                                });
+                            }
+                        }
+                    }
+                });
+                // Verify we actually have meaningful content (not just the header)
+                const headerLength = '\n\nRelevant information from knowledge base:\n'.length;
+                if (knowledgeResults.length > headerLength + 10) {
+                    logger_1.default.info(`✅ Knowledge context prepared (${knowledgeResults.length} chars, ${searchResults.length} results)`);
+                    logger_1.default.info(`📝 Knowledge preview: ${knowledgeResults.substring(0, 200)}...`);
+                }
+                else {
+                    logger_1.default.warn(`⚠️  Knowledge results found but content is empty or too short (${knowledgeResults.length} chars), treating as no results`);
+                    knowledgeResults = '';
+                }
+            }
+            else {
+                knowledgeResults = '';
+                logger_1.default.info('⚠️  No knowledge base results found; will return appropriate fallback response');
+            }
+        }
+        catch (error) {
+            console.error('❌ Failed to search knowledge base:', error);
+            logger_1.default.error('Failed to search knowledge base:', error);
+            knowledgeResults = null;
+        }
+        return { knowledgeResults, sources };
+    }
+    /**
+     * Build chat context for AI generation
+     */
+    buildChatContext(messages, knowledgeResults) {
+        return {
+            conversationHistory: messages.map(msg => ({
+                role: msg.role,
+                content: msg.content
+            })),
+            knowledgeResults: knowledgeResults ?? undefined
+        };
+    }
+    /**
+     * Get AI service for streaming
+     */
+    getAIService() {
+        return this.aiService;
+    }
+    /**
+     * Get fallback response for intent
+     */
+    getFallbackResponse(intent) {
+        const fallbacks = {
+            greeting: 'Hello! How can I help you today?',
+            acknowledgment: "You're welcome! Let me know if you need anything else.",
+            personality: `I'm ${process.env.ASSISTANT_NAME || 'AI Assistant'}, your AI assistant for ${process.env.ORGANIZATION_NAME || 'Your Organization'}.`,
+            clarification: "I'm not sure I understood. Could you clarify what you need help with?",
+            guardrail: "I can help with documentation or implementation guidance, but I can't share credentials or confidential configuration.",
+            human_support_request: "I'd be happy to connect you with our support team. Could you please provide your email address?",
+            human_support_email: "Thank you! Our support team will reach out to you shortly."
+        };
+        return fallbacks[intent] || "I'm here to help. What would you like to know?";
+    }
+}
+exports.ResponseGenerationService = ResponseGenerationService;
+//# sourceMappingURL=ResponseGenerationService.js.map

package/dist/src/services/ResponseGenerationService.js.map

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

package/dist/src/services/ResponseStreamingService.d.ts

@@ -0,0 +1,33 @@
+import { Response } from 'express';
+export declare class ResponseStreamingService {
+    /**
+     * Stream text content word by word to simulate streaming
+     * This ensures consistent SSE format for all responses
+     */
+    streamTextContent(content: string, res: Response): Promise<void>;
+    /**
+     * Stream AI response chunks with source handling
+     */
+    streamAIResponse(stream: AsyncGenerator<{
+        chunk: string;
+        done: boolean;
+        fullContent?: string;
+    }, void, unknown>, res: Response, sources?: Array<{
+        document_uuid: string;
+        document_title: string;
+        chunk_indices: number[];
+    }>, knowledgeResults?: string | null): Promise<string>;
+    /**
+     * Send completion event
+     */
+    sendCompletionEvent(res: Response, messageUuid: string, parentMessageUuid: string | undefined, createdAt: Date): void;
+    /**
+     * Send error event
+     */
+    sendErrorEvent(res: Response, error: string, message?: string): void;
+    /**
+     * Setup SSE headers
+     */
+    setupSSEHeaders(res: Response): void;
+}
+//# sourceMappingURL=ResponseStreamingService.d.ts.map

package/dist/src/services/ResponseStreamingService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResponseStreamingService.d.ts","sourceRoot":"","sources":["../../../src/services/ResponseStreamingService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGnC,qBAAa,wBAAwB;IACnC;;;OAGG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BtE;;OAEG;IACG,gBAAgB,CACpB,MAAM,EAAE,cAAc,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,IAAI,EAAE,OAAO,CAAC,EAC7F,GAAG,EAAE,QAAQ,EACb,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC,EACF,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,GAC/B,OAAO,CAAC,MAAM,CAAC;IAiDlB;;OAEG;IACH,mBAAmB,CAAC,GAAG,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,IAAI,GAAG,IAAI;IAWrH;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IASpE;;OAEG;IACH,eAAe,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI;CAMrC"}

package/dist/src/services/ResponseStreamingService.js

@@ -0,0 +1,114 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponseStreamingService = void 0;
+const logger_1 = __importDefault(require("../config/logger"));
+class ResponseStreamingService {
+    /**
+     * Stream text content word by word to simulate streaming
+     * This ensures consistent SSE format for all responses
+     */
+    async streamTextContent(content, res) {
+        const words = content.split(' ');
+        const chunkSize = 2; // Stream 2 words at a time for smoother experience
+        const totalChunks = Math.ceil(words.length / chunkSize);
+        for (let i = 0; i < words.length; i += chunkSize) {
+            const chunk = words.slice(i, i + chunkSize).join(' ') + (i + chunkSize < words.length ? ' ' : '');
+            const chunkIndex = Math.floor(i / chunkSize) + 1;
+            const isLastChunk = chunkIndex === totalChunks;
+            const chunkData = JSON.stringify({
+                type: 'chunk',
+                content: chunk,
+                done: isLastChunk, // Mark last chunk with done: true
+                sources: undefined // Intent responses have no sources
+            });
+            res.write(`data: ${chunkData}\n\n`);
+            // Flush the response to ensure chunks are sent immediately
+            if (res.flush) {
+                res.flush();
+            }
+            // Delay for smooth streaming effect (30ms for better visibility)
+            await new Promise(resolve => setTimeout(resolve, 30));
+        }
+    }
+    /**
+     * Stream AI response chunks with source handling
+     */
+    async streamAIResponse(stream, res, sources, knowledgeResults) {
+        let accumulatedContent = '';
+        let chunkCount = 0;
+        logger_1.default.info('🔄 Starting OpenAI stream...');
+        for await (const { chunk, done, fullContent } of stream) {
+            chunkCount++;
+            // On last chunk, include sources (only if we actually have useful knowledge results)
+            // Don't send sources if LLM couldn't answer or apologized
+            const shouldIncludeSources = done && sources && sources.length > 0 && knowledgeResults && knowledgeResults.trim().length > 0;
+            const chunkData = JSON.stringify({
+                type: 'chunk',
+                content: chunk,
+                done: done || false,
+                sources: shouldIncludeSources ? sources : undefined
+            });
+            // Log sources on last chunk for debugging
+            if (shouldIncludeSources) {
+                logger_1.default.info(`📚 Sending sources with last chunk: ${JSON.stringify(sources)}`);
+            }
+            else if (done && sources && sources.length > 0) {
+                logger_1.default.info(`⚠️  Sources available but not sent (no knowledge results used)`);
+            }
+            res.write(`data: ${chunkData}\n\n`);
+            if (res.flush)
+                res.flush();
+            // Update accumulated content
+            if (chunk) {
+                accumulatedContent += chunk;
+            }
+            // Log first and last chunks
+            if (chunkCount === 1) {
+                logger_1.default.info(`📤 First chunk sent: "${chunk.substring(0, 30)}..."`);
+            }
+            if (done && fullContent) {
+                accumulatedContent = fullContent;
+                logger_1.default.info(`🏁 Stream complete: ${chunkCount} chunks sent, ${fullContent.length} total chars`);
+            }
+        }
+        return accumulatedContent;
+    }
+    /**
+     * Send completion event
+     */
+    sendCompletionEvent(res, messageUuid, parentMessageUuid, createdAt) {
+        const completionData = JSON.stringify({
+            type: 'completion',
+            uuid: messageUuid,
+            parent_message_uuid: parentMessageUuid || '',
+            status: 'completed',
+            created_at: createdAt.toISOString()
+        });
+        res.write(`data: ${completionData}\n\n`);
+    }
+    /**
+     * Send error event
+     */
+    sendErrorEvent(res, error, message) {
+        const errorData = JSON.stringify({
+            type: 'error',
+            error,
+            message: message || 'Unknown error'
+        });
+        res.write(`data: ${errorData}\n\n`);
+    }
+    /**
+     * Setup SSE headers
+     */
+    setupSSEHeaders(res) {
+        res.setHeader('Content-Type', 'text/event-stream');
+        res.setHeader('Cache-Control', 'no-cache');
+        res.setHeader('Connection', 'keep-alive');
+        res.setHeader('X-Accel-Buffering', 'no'); // Disable nginx buffering
+    }
+}
+exports.ResponseStreamingService = ResponseStreamingService;
+//# sourceMappingURL=ResponseStreamingService.js.map

package/dist/src/services/ResponseStreamingService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResponseStreamingService.js","sourceRoot":"","sources":["../../../src/services/ResponseStreamingService.ts"],"names":[],"mappings":";;;;;;AACA,8DAAsC;AAEtC,MAAa,wBAAwB;IACnC;;;OAGG;IACH,KAAK,CAAC,iBAAiB,CAAC,OAAe,EAAE,GAAa;QACpD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,SAAS,GAAG,CAAC,CAAC,CAAC,mDAAmD;QACxE,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;QAExD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC;YACjD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAClG,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;YACjD,MAAM,WAAW,GAAG,UAAU,KAAK,WAAW,CAAC;YAE/C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;gBAC/B,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,WAAW,EAAE,kCAAkC;gBACrD,OAAO,EAAE,SAAS,CAAC,mCAAmC;aACvD,CAAC,CAAC;YACH,GAAG,CAAC,KAAK,CAAC,SAAS,SAAS,MAAM,CAAC,CAAC;YAEpC,2DAA2D;YAC3D,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;gBACd,GAAG,CAAC,KAAK,EAAE,CAAC;YACd,CAAC;YAED,iEAAiE;YACjE,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CACpB,MAA6F,EAC7F,GAAa,EACb,OAIE,EACF,gBAAgC;QAEhC,IAAI,kBAAkB,GAAG,EAAE,CAAC;QAC5B,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,gBAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAE5C,IAAI,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,MAAM,EAAE,CAAC;YACxD,UAAU,EAAE,CAAC;YAEb,qFAAqF;YACrF,0DAA0D;YAC1D,MAAM,oBAAoB,GAAG,IAAI,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,gBAAgB,IAAI,gBAAgB,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;YAE7H,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;gBAC/B,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,IAAI,IAAI,KAAK;gBACnB,OAAO,EAAE,oBAAoB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;aACpD,CAAC,CAAC;YAEH,0CAA0C;YAC1C,IAAI,oBAAoB,EAAE,CAAC;gBACzB,gBAAM,CAAC,IAAI,CAAC,uCAAuC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAChF,CAAC;iBAAM,IAAI,IAAI,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjD,gBAAM,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;YAChF,CAAC;YAED,GAAG,CAAC,KAAK,CAAC,SAAS,SAAS,MAAM,CAAC,CAAC;YACpC,IAAI,GAAG,CAAC,KAAK;gBAAE,GAAG,CAAC,KAAK,EAAE,CAAC;YAE3B,6BAA6B;YAC7B,IAAI,KAAK,EAAE,CAAC;gBACV,kBAAkB,IAAI,KAAK,CAAC;YAC9B,CAAC;YAED,4BAA4B;YAC5B,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;gBACrB,gBAAM,CAAC,IAAI,CAAC,yBAAyB,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;YACrE,CAAC;YAED,IAAI,IAAI,IAAI,WAAW,EAAE,CAAC;gBACxB,kBAAkB,GAAG,WAAW,CAAC;gBACjC,gBAAM,CAAC,IAAI,CAAC,uBAAuB,UAAU,iBAAiB,WAAW,CAAC,MAAM,cAAc,CAAC,CAAC;YAClG,CAAC;QACH,CAAC;QAED,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,GAAa,EAAE,WAAmB,EAAE,iBAAqC,EAAE,SAAe;QAC5G,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC;YACpC,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,WAAW;YACjB,mBAAmB,EAAE,iBAAiB,IAAI,EAAE;YAC5C,MAAM,EAAE,WAAW;YACnB,UAAU,EAAE,SAAS,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;QACH,GAAG,CAAC,KAAK,CAAC,SAAS,cAAc,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,GAAa,EAAE,KAAa,EAAE,OAAgB;QAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;YAC/B,IAAI,EAAE,OAAO;YACb,KAAK;YACL,OAAO,EAAE,OAAO,IAAI,eAAe;SACpC,CAAC,CAAC;QACH,GAAG,CAAC,KAAK,CAAC,SAAS,SAAS,MAAM,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,GAAa;QAC3B,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC;QACnD,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;QAC3C,GAAG,CAAC,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QAC1C,GAAG,CAAC,SAAS,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC,CAAC,0BAA0B;IACtE,CAAC;CACF;AAjID,4DAiIC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vezlo/assistant-server",
-  "version": "2.7.0",
+  "version": "2.8.0",
   "description": "Production-ready AI Assistant Server with advanced RAG (chunk-based semantic search + adjacent retrieval), conversation management, real-time communication, and human agent handoff",
   "main": "dist/src/server.js",
   "types": "dist/src/server.d.ts",