@squadrules/mcp 4.8.6

package/dist/services/code-block-processor.js

@@ -0,0 +1,169 @@
+// logger import removed because not used
+/**
+ * Service for extracting and processing code blocks from markdown content
+ * to enhance searchability of technical documentation
+ */
+export class CodeBlockProcessor {
+    /**
+     * Extract code blocks from markdown content
+     */
+    extractCodeBlocks(markdown) {
+        const codeBlocks = [];
+        const lines = markdown.split(/\r?\n/);
+        let inCodeBlock = false;
+        let currentBlock = null;
+        for (const line of lines) {
+            if (line.trim().startsWith('```')) {
+                if (!inCodeBlock) {
+                    // Start of code block
+                    inCodeBlock = true;
+                    const language = line.trim().substring(3).trim() || 'text';
+                    currentBlock = { language, content: [] };
+                }
+                else {
+                    // End of code block
+                    if (currentBlock) {
+                        const content = currentBlock.content.join('\n');
+                        const identifiers = this.extractIdentifiers(content, currentBlock.language);
+                        codeBlocks.push({
+                            language: currentBlock.language,
+                            content,
+                            identifiers
+                        });
+                    }
+                    inCodeBlock = false;
+                    currentBlock = null;
+                }
+            }
+            else if (inCodeBlock && currentBlock) {
+                currentBlock.content.push(line);
+            }
+        }
+        return codeBlocks;
+    }
+    /**
+     * Extract searchable identifiers from code content
+     */
+    extractIdentifiers(code, language) {
+        const identifiers = new Set();
+        // Language-specific patterns
+        const patterns = this.getLanguagePatterns(language);
+        for (const pattern of patterns) {
+            const matches = code.matchAll(pattern.regex);
+            for (const match of matches) {
+                const identifier = match[1] || match[0];
+                if (identifier && identifier.length > 2 && identifier.length < 50) {
+                    // Filter out common keywords and short fragments
+                    if (!this.isCommonKeyword(identifier, language)) {
+                        identifiers.add(identifier.toLowerCase());
+                    }
+                }
+            }
+        }
+        return Array.from(identifiers);
+    }
+    /**
+     * Get regex patterns for extracting identifiers from different languages
+     */
+    getLanguagePatterns(language) {
+        const basePatterns = [
+            // Function names (various languages)
+            { regex: /\bfunction\s+([a-zA-Z_$][a-zA-Z0-9_$]*)\s*\(/g, type: 'function' },
+            { regex: /\bdef\s+([a-zA-Z_$][a-zA-Z0-9_$]*)\s*\(/g, type: 'function' },
+            { regex: /\b([a-zA-Z_$][a-zA-Z0-9_$]*)\s*\([^)]*\)\s*{/g, type: 'function' }, // C-style functions
+            // Class names
+            { regex: /\bclass\s+([a-zA-Z_$][a-zA-Z0-9_$]*)/g, type: 'class' },
+            // Variable/constant declarations
+            { regex: /\b(?:const|let|var)\s+([a-zA-Z_$][a-zA-Z0-9_$]*)\s*[:=]/g, type: 'variable' },
+            { regex: /\b([a-zA-Z_$][a-zA-Z0-9_$]*)\s*[:=]\s*function/g, type: 'variable' },
+            // Interface/type names
+            { regex: /\binterface\s+([a-zA-Z_$][a-zA-Z0-9_$]*)/g, type: 'interface' },
+            { regex: /\btype\s+([a-zA-Z_$][a-zA-Z0-9_$]*)/g, type: 'type' },
+            // Method calls (potential API methods)
+            { regex: /\.([a-zA-Z_$][a-zA-Z0-9_$]*)\s*\(/g, type: 'method' },
+            // Import/require statements
+            { regex: /(?:import|from|require)\s+['"]([^'"]+)['"]/g, type: 'import' },
+            { regex: /(?:import|require)\s*\(\s*['"]([^'"]+)['"]\s*\)/g, type: 'import' },
+        ];
+        // Language-specific additions
+        switch (language.toLowerCase()) {
+            case 'javascript':
+            case 'typescript':
+            case 'js':
+            case 'ts':
+                return [
+                    ...basePatterns,
+                    // Arrow functions
+                    { regex: /\b([a-zA-Z_$][a-zA-Z0-9_$]*)\s*=>/g, type: 'function' },
+                    // Export statements
+                    { regex: /\bexport\s+(?:const|function|class)\s+([a-zA-Z_$][a-zA-Z0-9_$]*)/g, type: 'export' },
+                ];
+            case 'python':
+            case 'py':
+                return [
+                    ...basePatterns,
+                    // Class methods
+                    { regex: /\bdef\s+([a-zA-Z_$][a-zA-Z0-9_$]*)\s*\(self/g, type: 'method' },
+                ];
+            case 'java':
+                return [
+                    ...basePatterns,
+                    // Package declarations
+                    { regex: /\bpackage\s+([a-zA-Z_$][a-zA-Z0-9_$.]*)/g, type: 'package' },
+                ];
+            case 'csharp':
+            case 'c#':
+                return [
+                    ...basePatterns,
+                    // Namespace
+                    { regex: /\bnamespace\s+([a-zA-Z_$][a-zA-Z0-9_$.]*)/g, type: 'namespace' },
+                ];
+            default:
+                return basePatterns;
+        }
+    }
+    /**
+     * Check if an identifier is a common keyword that shouldn't be indexed
+     */
+    isCommonKeyword(identifier, language) {
+        const commonKeywords = new Set([
+            'function', 'class', 'const', 'let', 'var', 'if', 'else', 'for', 'while',
+            'return', 'import', 'export', 'from', 'require', 'interface', 'type',
+            'public', 'private', 'protected', 'static', 'final', 'void', 'int',
+            'string', 'boolean', 'object', 'array', 'null', 'undefined', 'true', 'false'
+        ]);
+        // Language-specific keywords
+        const languageKeywords = {
+            'javascript': new Set(['console', 'log', 'error', 'warn', 'info', 'document', 'window']),
+            'typescript': new Set(['console', 'log', 'error', 'warn', 'info', 'document', 'window', 'any']),
+            'python': new Set(['self', 'print', 'len', 'str', 'int', 'list', 'dict', 'set']),
+            'java': new Set(['System', 'out', 'println', 'String', 'Integer', 'List', 'Map']),
+        };
+        const langKeywords = languageKeywords[language.toLowerCase()] || new Set();
+        return commonKeywords.has(identifier.toLowerCase()) || langKeywords.has(identifier);
+    }
+    /**
+     * Process markdown content and return code processing results
+     */
+    processMarkdown(markdown) {
+        const codeBlocks = this.extractCodeBlocks(markdown);
+        const allIdentifiers = codeBlocks.flatMap(block => block.identifiers);
+        return {
+            codeBlocks,
+            allIdentifiers: [...new Set(allIdentifiers)] // Remove duplicates
+        };
+    }
+    /**
+     * Enhance text content with code identifiers for better searchability
+     */
+    enhanceContentForSearch(originalText, codeResult) {
+        if (codeResult.allIdentifiers.length === 0) {
+            return originalText;
+        }
+        // Add code identifiers to the end of the text for search purposes
+        // This ensures they're included in embeddings and text search
+        const identifierText = codeResult.allIdentifiers.join(' ');
+        return `${originalText}\n\n[CODE_IDENTIFIERS: ${identifierText}]`;
+    }
+}
+//# sourceMappingURL=code-block-processor.js.map

package/dist/services/code-block-processor.js.map

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

package/dist/services/embedding/audit.d.ts

@@ -0,0 +1,35 @@
+export interface EmbeddingAuditPayload {
+    tenantId: string;
+    requestId: string;
+    provider: string;
+    model: string;
+    inputCount: number;
+    inputCharLength: number;
+    outputDimension: number;
+    latencyMs: number;
+}
+export declare function logEmbeddingAuditSuccess(payload: EmbeddingAuditPayload): void;
+export declare function logEmbeddingAuditError(payload: Omit<EmbeddingAuditPayload, 'outputDimension'> & {
+    outputDimension?: number;
+    errorMessage: string;
+}): void;
+export declare function detectEmbeddingAnomalies(params: {
+    tenantId: string;
+    requestId: string;
+    provider: string;
+    model: string;
+    latencyMs: number;
+    expectedDimension: number;
+    actualDimension: number;
+    sampleEmbedding: number[];
+}): {
+    hasCritical: boolean;
+};
+export declare function logSearchAnomaly(params: {
+    tenantId: string;
+    requestId: string;
+    resultCount: number;
+    queryLength: number;
+    topScore: number | null;
+}): void;
+//# sourceMappingURL=audit.d.ts.map

package/dist/services/embedding/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../../src/services/embedding/audit.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAyCD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAa7E;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,IAAI,CAAC,qBAAqB,EAAE,iBAAiB,CAAC,GAAG;IAC/F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,IAAI,CAcP;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,GAAG;IAAE,WAAW,EAAE,OAAO,CAAA;CAAE,CAsD3B;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,GAAG,IAAI,CA8BP"}

package/dist/services/embedding/audit.js

@@ -0,0 +1,146 @@
+import { EMBEDDING_LATENCY_WARN_MS, EMBEDDING_NORM_MAX, EMBEDDING_NORM_MIN, SEARCH_SCORE_WARN_THRESHOLD } from '../../config.js';
+import { anomalyEvents } from '../metrics/anomaly-metrics.js';
+import { structuredLogger } from '../../utils/structured-logger.js';
+function round(value) {
+    return Number(value.toFixed(4));
+}
+function vectorNorm(vector) {
+    if (vector.length === 0)
+        return 0;
+    let sumSquares = 0;
+    for (const value of vector)
+        sumSquares += value * value;
+    return Math.sqrt(sumSquares);
+}
+function recordAnomaly(params) {
+    anomalyEvents.inc({
+        type: params.type,
+        severity: params.severity,
+        tenant_id: params.tenantId
+    });
+    const bindings = {
+        category: 'audit.anomaly',
+        anomaly_type: params.type,
+        severity: params.severity,
+        tenant_id: params.tenantId,
+        request_id: params.requestId,
+        ...params.details
+    };
+    if (params.severity === 'error') {
+        structuredLogger.error(params.message, undefined, bindings);
+        return;
+    }
+    structuredLogger.warn(bindings, params.message);
+}
+export function logEmbeddingAuditSuccess(payload) {
+    structuredLogger.info({
+        category: 'audit.embedding',
+        status: 'success',
+        tenant_id: payload.tenantId,
+        request_id: payload.requestId,
+        provider: payload.provider,
+        model: payload.model,
+        input_count: payload.inputCount,
+        input_char_length: payload.inputCharLength,
+        output_dimension: payload.outputDimension,
+        latency_ms: payload.latencyMs
+    }, 'Embedding request completed');
+}
+export function logEmbeddingAuditError(payload) {
+    structuredLogger.error('Embedding request failed', undefined, {
+        category: 'audit.embedding',
+        status: 'error',
+        tenant_id: payload.tenantId,
+        request_id: payload.requestId,
+        provider: payload.provider,
+        model: payload.model,
+        input_count: payload.inputCount,
+        input_char_length: payload.inputCharLength,
+        output_dimension: payload.outputDimension ?? 0,
+        latency_ms: payload.latencyMs,
+        error_message: payload.errorMessage
+    });
+}
+export function detectEmbeddingAnomalies(params) {
+    let hasCritical = false;
+    if (params.latencyMs > EMBEDDING_LATENCY_WARN_MS) {
+        recordAnomaly({
+            tenantId: params.tenantId,
+            requestId: params.requestId,
+            type: 'embedding_high_latency',
+            severity: 'warn',
+            message: 'Embedding latency exceeded warning threshold',
+            details: {
+                provider: params.provider,
+                model: params.model,
+                latency_ms: params.latencyMs,
+                threshold_ms: EMBEDDING_LATENCY_WARN_MS
+            }
+        });
+    }
+    const norm = vectorNorm(params.sampleEmbedding);
+    if (norm < EMBEDDING_NORM_MIN || norm > EMBEDDING_NORM_MAX) {
+        recordAnomaly({
+            tenantId: params.tenantId,
+            requestId: params.requestId,
+            type: 'embedding_unusual_norm',
+            severity: 'warn',
+            message: 'Embedding vector norm is outside expected range',
+            details: {
+                provider: params.provider,
+                model: params.model,
+                norm: round(norm),
+                min_norm: EMBEDDING_NORM_MIN,
+                max_norm: EMBEDDING_NORM_MAX
+            }
+        });
+    }
+    if (params.actualDimension !== params.expectedDimension) {
+        hasCritical = true;
+        recordAnomaly({
+            tenantId: params.tenantId,
+            requestId: params.requestId,
+            type: 'embedding_dimension_mismatch',
+            severity: 'error',
+            message: 'Embedding dimension mismatch detected',
+            details: {
+                provider: params.provider,
+                model: params.model,
+                expected_dimension: params.expectedDimension,
+                actual_dimension: params.actualDimension
+            }
+        });
+    }
+    return { hasCritical };
+}
+export function logSearchAnomaly(params) {
+    if (params.resultCount === 0 && params.queryLength >= 8) {
+        recordAnomaly({
+            tenantId: params.tenantId,
+            requestId: params.requestId,
+            type: 'search_zero_results',
+            severity: 'warn',
+            message: 'Search returned zero results for a non-trivial query',
+            details: {
+                query_length: params.queryLength,
+                result_count: params.resultCount
+            }
+        });
+    }
+    if (typeof params.topScore === 'number' && params.queryLength >= 8 && params.topScore < SEARCH_SCORE_WARN_THRESHOLD) {
+        recordAnomaly({
+            tenantId: params.tenantId,
+            requestId: params.requestId,
+            type: 'search_low_score',
+            severity: 'warn',
+            message: 'Search top score is below warning threshold',
+            details: {
+                query_length: params.queryLength,
+                result_count: params.resultCount,
+                top_score: round(params.topScore),
+                threshold: SEARCH_SCORE_WARN_THRESHOLD
+            }
+        });
+    }
+}
+//# sourceMappingURL=audit.js.map

package/dist/services/embedding/audit.js.map

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

package/dist/services/embedding/bm25-tokenizer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Lightweight BM25-style tokenizer for sparse vectors.
+ * Converts text to { indices, values } for Qdrant sparse vector search.
+ * Tokenization: lowercase, split on non-alphanumeric, remove stop words.
+ * Index: FNV-1a hash mod 30000. Value: sublinear TF 1 + log(tf).
+ * No IDF client-side; Qdrant handles scoring.
+ */
+export interface SparseVector {
+    indices: number[];
+    values: number[];
+}
+/**
+ * Tokenize text into a sparse vector for BM25 search.
+ * Lowercase, split on non-alphanumeric, drop stop words and short tokens.
+ * Indices from FNV-1a mod 30000; values from 1 + log(tf).
+ */
+export declare function tokenizeToSparse(text: string): SparseVector;
+export declare const bm25Tokenizer: {
+    tokenize: typeof tokenizeToSparse;
+};
+//# sourceMappingURL=bm25-tokenizer.d.ts.map

package/dist/services/embedding/bm25-tokenizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bm25-tokenizer.d.ts","sourceRoot":"","sources":["../../../src/services/embedding/bm25-tokenizer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoBH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAe3D;AAED,eAAO,MAAM,aAAa;;CAEzB,CAAC"}

package/dist/services/embedding/bm25-tokenizer.js

@@ -0,0 +1,47 @@
+/**
+ * Lightweight BM25-style tokenizer for sparse vectors.
+ * Converts text to { indices, values } for Qdrant sparse vector search.
+ * Tokenization: lowercase, split on non-alphanumeric, remove stop words.
+ * Index: FNV-1a hash mod 30000. Value: sublinear TF 1 + log(tf).
+ * No IDF client-side; Qdrant handles scoring.
+ */
+const SPARSE_DIM = 30000;
+const FNV_OFFSET = 2166136261;
+const FNV_PRIME = 16777619;
+const STOP_WORDS = new Set([
+    'a', 'an', 'and', 'are', 'as', 'at', 'be', 'by', 'for', 'from', 'has', 'he', 'in', 'is', 'it',
+    'its', 'of', 'on', 'that', 'the', 'to', 'was', 'were', 'will', 'with'
+]);
+function fnv1aMod(str) {
+    let h = FNV_OFFSET;
+    for (let i = 0; i < str.length; i++) {
+        h ^= str.charCodeAt(i);
+        h = Math.imul(h, FNV_PRIME);
+    }
+    return ((h >>> 0) % SPARSE_DIM + SPARSE_DIM) % SPARSE_DIM;
+}
+/**
+ * Tokenize text into a sparse vector for BM25 search.
+ * Lowercase, split on non-alphanumeric, drop stop words and short tokens.
+ * Indices from FNV-1a mod 30000; values from 1 + log(tf).
+ */
+export function tokenizeToSparse(text) {
+    const normalized = (text ?? '').toLowerCase();
+    const tokens = normalized.split(/[^a-z0-9]+/).filter(t => t.length > 1 && !STOP_WORDS.has(t));
+    const tf = new Map();
+    for (const t of tokens) {
+        const idx = fnv1aMod(t);
+        tf.set(idx, (tf.get(idx) ?? 0) + 1);
+    }
+    const indices = [];
+    const values = [];
+    for (const [idx, count] of tf) {
+        indices.push(idx);
+        values.push(1 + Math.log(count));
+    }
+    return { indices, values };
+}
+export const bm25Tokenizer = {
+    tokenize: tokenizeToSparse
+};
+//# sourceMappingURL=bm25-tokenizer.js.map

package/dist/services/embedding/bm25-tokenizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bm25-tokenizer.js","sourceRoot":"","sources":["../../../src/services/embedding/bm25-tokenizer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,UAAU,GAAG,KAAK,CAAC;AACzB,MAAM,UAAU,GAAG,UAAU,CAAC;AAC9B,MAAM,SAAS,GAAG,QAAQ,CAAC;AAE3B,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IACzB,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAC7F,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CACtE,CAAC,CAAC;AAEH,SAAS,QAAQ,CAAC,GAAW;IAC3B,IAAI,CAAC,GAAG,UAAU,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,GAAG,UAAU,CAAC,GAAG,UAAU,CAAC;AAC5D,CAAC;AAOD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,UAAU,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9C,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9F,MAAM,EAAE,GAAG,IAAI,GAAG,EAAkB,CAAC;IACrC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACxB,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACtC,CAAC;IACD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClB,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,QAAQ,EAAE,gBAAgB;CAC3B,CAAC"}

package/dist/services/embedding/config.d.ts

@@ -0,0 +1,11 @@
+import { OPENAI_EMBEDDING_MODEL } from '../../config.js';
+export { OPENAI_EMBEDDING_MODEL };
+export declare const OPENAI_ENDPOINT: string;
+export declare const TEI_EMBEDDING_ENDPOINT: string;
+/** Set embedding dimension from first API response; on subsequent calls asserts same value. */
+export declare function setResolvedEmbeddingDimension(dim: number): void;
+/** Return cached dimension; throws if not yet resolved (probe must run at startup). */
+export declare function getResolvedEmbeddingDimension(): number;
+/** Public API for dimension (same as getResolvedEmbeddingDimension after probe). */
+export declare function getEmbeddingDimension(): number;
+//# sourceMappingURL=config.d.ts.map

package/dist/services/embedding/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/services/embedding/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAgD,MAAM,iBAAiB,CAAC;AAEvG,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAClC,eAAO,MAAM,eAAe,QAAoC,CAAC;AAGjE,eAAO,MAAM,sBAAsB,QAE3B,CAAC;AAKT,+FAA+F;AAC/F,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAK/D;AAED,uFAAuF;AACvF,wBAAgB,6BAA6B,IAAI,MAAM,CAOtD;AAED,oFAAoF;AACpF,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C"}

package/dist/services/embedding/config.js

@@ -0,0 +1,32 @@
+import { logger } from '../../utils/structured-logger.js';
+import { OPENAI_EMBEDDING_MODEL, OPENAI_API_KEY, OPENAI_API_URL, TEI_BASE_URL } from '../../config.js';
+export { OPENAI_EMBEDDING_MODEL };
+export const OPENAI_ENDPOINT = `${OPENAI_API_URL}/v1/embeddings`;
+// TEI (Text Embeddings Inference) configuration
+export const TEI_EMBEDDING_ENDPOINT = TEI_BASE_URL
+    ? (TEI_BASE_URL.endsWith('/') ? TEI_BASE_URL.slice(0, -1) : TEI_BASE_URL) + '/v1/embeddings'
+    : '';
+/** Runtime cache for embedding dimension (set by first successful embed; validated on subsequent calls). */
+let _resolvedDimension = null;
+/** Set embedding dimension from first API response; on subsequent calls asserts same value. */
+export function setResolvedEmbeddingDimension(dim) {
+    if (_resolvedDimension !== null && _resolvedDimension !== dim) {
+        throw new Error(`Embedding dimension mismatch: got ${dim}, expected ${_resolvedDimension}`);
+    }
+    _resolvedDimension = dim;
+}
+/** Return cached dimension; throws if not yet resolved (probe must run at startup). */
+export function getResolvedEmbeddingDimension() {
+    if (_resolvedDimension === null) {
+        throw new Error('Embedding dimension not resolved. Ensure probeEmbeddingDimension() runs at startup before using Qdrant store or embedding-dependent code.');
+    }
+    return _resolvedDimension;
+}
+/** Public API for dimension (same as getResolvedEmbeddingDimension after probe). */
+export function getEmbeddingDimension() {
+    return getResolvedEmbeddingDimension();
+}
+if (!OPENAI_API_KEY) {
+    logger.debug('OPENAI_API_KEY not configured; OpenAI usage will be disabled unless explicitly requested.');
+}
+//# sourceMappingURL=config.js.map

package/dist/services/embedding/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/services/embedding/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEvG,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,cAAc,gBAAgB,CAAC;AAEjE,gDAAgD;AAChD,MAAM,CAAC,MAAM,sBAAsB,GAAG,YAAY;IAC9C,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,gBAAgB;IAC5F,CAAC,CAAC,EAAE,CAAC;AAET,4GAA4G;AAC5G,IAAI,kBAAkB,GAAkB,IAAI,CAAC;AAE7C,+FAA+F;AAC/F,MAAM,UAAU,6BAA6B,CAAC,GAAW;IACrD,IAAI,kBAAkB,KAAK,IAAI,IAAI,kBAAkB,KAAK,GAAG,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,qCAAqC,GAAG,cAAc,kBAAkB,EAAE,CAAC,CAAC;IAChG,CAAC;IACD,kBAAkB,GAAG,GAAG,CAAC;AAC7B,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,6BAA6B;IACzC,IAAI,kBAAkB,KAAK,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACX,2IAA2I,CAC9I,CAAC;IACN,CAAC;IACD,OAAO,kBAAkB,CAAC;AAC9B,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,qBAAqB;IACjC,OAAO,6BAA6B,EAAE,CAAC;AAC3C,CAAC;AAED,IAAI,CAAC,cAAc,EAAE,CAAC;IAClB,MAAM,CAAC,KAAK,CAAC,2FAA2F,CAAC,CAAC;AAC9G,CAAC"}

package/dist/services/embedding/health.d.ts

@@ -0,0 +1,5 @@
+export declare function runEmbeddingHealthCheck(): Promise<{
+    healthy: boolean;
+    message: string;
+}>;
+//# sourceMappingURL=health.d.ts.map

package/dist/services/embedding/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/services/embedding/health.ts"],"names":[],"mappings":"AAeA,wBAAsB,uBAAuB,IAAI,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAuG9F"}

package/dist/services/embedding/health.js

@@ -0,0 +1,112 @@
+import { logger } from '../../utils/structured-logger.js';
+import { EMBEDDING_PROVIDER, OPENAI_API_KEY, TEI_BASE_URL, TEI_MODEL, TEI_API_KEY } from '../../config.js';
+import { OPENAI_EMBEDDING_MODEL, TEI_EMBEDDING_ENDPOINT, setResolvedEmbeddingDimension } from './config.js';
+import { postEmbeddingsOpenAI, postEmbeddingsTEI } from './providers.js';
+export async function runEmbeddingHealthCheck() {
+    try {
+        const providerPref = EMBEDDING_PROVIDER;
+        if (providerPref === 'openai') {
+            if (!OPENAI_API_KEY || !OPENAI_EMBEDDING_MODEL) {
+                return { healthy: false, message: 'OpenAI requires OPENAI_API_KEY and OPENAI_EMBEDDING_MODEL' };
+            }
+            try {
+                const res = await postEmbeddingsOpenAI('health check');
+                return { healthy: Array.isArray(res) && res.length > 0, message: 'openai embeddings operational' };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                if (msg.includes('429'))
+                    return { healthy: true, message: 'openai is rate-limited (429) - reachable but throttled' };
+                if (msg.includes('401') || msg.toLowerCase().includes('authentication'))
+                    return { healthy: false, message: 'openai authentication failed - check OPENAI_API_KEY' };
+                return { healthy: false, message: `openai health check failed: ${msg}` };
+            }
+        }
+        if (providerPref === 'tei') {
+            if (!TEI_BASE_URL || !TEI_MODEL) {
+                return { healthy: false, message: 'TEI requires TEI_BASE_URL and TEI_MODEL' };
+            }
+            try {
+                const res = await postEmbeddingsTEI('health check');
+                return { healthy: Array.isArray(res) && res.length > 0, message: 'TEI embeddings operational' };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                if (msg.includes('401'))
+                    return { healthy: false, message: 'TEI authentication failed (401)' };
+                if (msg.includes('429'))
+                    return { healthy: true, message: 'TEI is rate-limited (429) - reachable but throttled' };
+                return { healthy: false, message: `TEI health check failed: ${msg}` };
+            }
+        }
+        if (OPENAI_API_KEY && OPENAI_EMBEDDING_MODEL) {
+            try {
+                const res = await postEmbeddingsOpenAI('health check');
+                return { healthy: Array.isArray(res) && res.length > 0, message: 'openai embeddings operational' };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                logger.warn(`[EmbeddingService] OpenAI health check failed, trying TEI fallback: ${msg}`);
+            }
+        }
+        if (TEI_BASE_URL && TEI_MODEL) {
+            try {
+                const url = TEI_EMBEDDING_ENDPOINT || TEI_BASE_URL;
+                const payload = { model: TEI_MODEL, input: ['health check'] };
+                const headers = { 'Content-Type': 'application/json' };
+                if (TEI_API_KEY)
+                    headers['x-api-key'] = TEI_API_KEY;
+                const resp = await fetch(url, {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify(payload)
+                });
+                let data = null;
+                try {
+                    data = await resp.json();
+                }
+                catch (parseErr) {
+                    logger.warn(`[EmbeddingService] TEI returned non-JSON response: ${String(parseErr)}`);
+                }
+                if (!resp.ok) {
+                    if (resp.status === 401) {
+                        return { healthy: false, message: 'TEI authentication failed (401)' };
+                    }
+                    if (resp.status === 429) {
+                        return { healthy: true, message: 'TEI is rate-limited (429) - reachable but throttled' };
+                    }
+                    return { healthy: false, message: `TEI returned HTTP ${resp.status}` };
+                }
+                let embeddings = null;
+                if (Array.isArray(data?.embeddings)) {
+                    embeddings = data.embeddings;
+                }
+                else if (Array.isArray(data?.data)) {
+                    embeddings = data.data.map((d) => d?.embedding ?? d);
+                }
+                else if (Array.isArray(data?.result)) {
+                    embeddings = data.result;
+                }
+                else if (Array.isArray(data)) {
+                    embeddings = data;
+                }
+                if (Array.isArray(embeddings) && embeddings.length > 0 && Array.isArray(embeddings[0])) {
+                    const dim = embeddings[0].length;
+                    setResolvedEmbeddingDimension(dim);
+                    return { healthy: true, message: 'TEI embeddings operational' };
+                }
+                return { healthy: false, message: 'TEI returned unexpected embedding shape or no embeddings' };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                return { healthy: false, message: `TEI health check error: ${msg}` };
+            }
+        }
+        return { healthy: false, message: 'No embedding provider configured (set OPENAI_API_KEY+OPENAI_EMBEDDING_MODEL or TEI_BASE_URL+TEI_MODEL)' };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { healthy: false, message: `Embedding health check error: ${msg}` };
+    }
+}
+//# sourceMappingURL=health.js.map

package/dist/services/embedding/health.js.map

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