agentdb 3.0.0-alpha.2 → 3.0.0-alpha.4

package/dist/src/observability/telemetry.js

@@ -1,420 +0,0 @@
-/**
- * OpenTelemetry Observability for AgentDB
- *
- * Provides comprehensive metrics, traces, and logging for production monitoring.
- * Zero-dependency mode when disabled, graceful degradation if collector unavailable.
- */
-/**
- * Default telemetry configuration
- */
-const DEFAULT_CONFIG = {
-    enabled: process.env.NODE_ENV === 'production',
-    serviceName: 'agentdb',
-    serviceVersion: '2.0.0-alpha',
-    otlpTraceEndpoint: process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT || 'http://localhost:4318/v1/traces',
-    otlpMetricsEndpoint: process.env.OTEL_EXPORTER_OTLP_METRICS_ENDPOINT || 'http://localhost:4318/v1/metrics',
-    prometheusEnabled: true,
-    prometheusPort: 9464,
-    consoleEnabled: process.env.NODE_ENV === 'development',
-    samplingRate: 1.0,
-    autoInstrumentation: true,
-    resourceAttributes: {},
-};
-/**
- * Telemetry manager class
- */
-export class TelemetryManager {
-    static instance;
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- OTel NodeSDK type is optional
-    sdk = null;
-    tracer = null;
-    meter = null;
-    config;
-    // Metrics
-    queryLatencyHistogram;
-    cacheHitCounter;
-    cacheMissCounter;
-    errorCounter;
-    operationCounter;
-    throughputCounter;
-    cacheHitRateGauge;
-    // Statistics for gauge calculation
-    stats = {
-        cacheHits: 0,
-        cacheMisses: 0,
-    };
-    constructor(config = {}) {
-        this.config = { ...DEFAULT_CONFIG, ...config };
-    }
-    /**
-     * Get singleton instance
-     */
-    static getInstance(config) {
-        if (!TelemetryManager.instance) {
-            TelemetryManager.instance = new TelemetryManager(config);
-        }
-        return TelemetryManager.instance;
-    }
-    /**
-     * Initialize telemetry
-     */
-    async initialize() {
-        if (!this.config.enabled) {
-            console.log('[AgentDB] Telemetry disabled');
-            return;
-        }
-        try {
-            // Dynamic import of OpenTelemetry packages
-            const otelApi = await import('@opentelemetry/api');
-            const { NodeSDK } = await import('@opentelemetry/sdk-node');
-            const { Resource } = await import('@opentelemetry/resources');
-            const { SemanticResourceAttributes } = await import('@opentelemetry/semantic-conventions');
-            // Create resource with service information
-            const resource = new Resource({
-                [SemanticResourceAttributes.SERVICE_NAME]: this.config.serviceName,
-                [SemanticResourceAttributes.SERVICE_VERSION]: this.config.serviceVersion,
-                ...this.config.resourceAttributes,
-            });
-            // Basic SDK initialization without complex exporters for now
-            this.sdk = new NodeSDK({
-                resource,
-                instrumentations: [],
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any -- OTel SDK type mismatch
-            });
-            await this.sdk.start();
-            // Initialize tracer and meter
-            this.tracer = otelApi.trace.getTracer(this.config.serviceName, this.config.serviceVersion);
-            this.meter = otelApi.metrics.getMeter(this.config.serviceName, this.config.serviceVersion);
-            // Initialize metrics
-            this.initializeMetrics();
-            console.log('[AgentDB] Telemetry initialized successfully');
-        }
-        catch (error) {
-            console.error('[AgentDB] Failed to initialize telemetry:', error);
-            console.log('[AgentDB] Continuing without telemetry (graceful degradation)');
-            // Graceful degradation - continue without telemetry
-            this.config.enabled = false;
-        }
-    }
-    /**
-     * Initialize metric instruments
-     */
-    initializeMetrics() {
-        if (!this.meter)
-            return;
-        // Query latency histogram
-        this.queryLatencyHistogram = this.meter.createHistogram('agentdb.query.latency', {
-            description: 'Query execution latency in milliseconds',
-            unit: 'ms',
-        });
-        // Cache hit counter
-        this.cacheHitCounter = this.meter.createCounter('agentdb.cache.hits', {
-            description: 'Number of cache hits',
-        });
-        // Cache miss counter
-        this.cacheMissCounter = this.meter.createCounter('agentdb.cache.misses', {
-            description: 'Number of cache misses',
-        });
-        // Error counter
-        this.errorCounter = this.meter.createCounter('agentdb.errors', {
-            description: 'Number of errors',
-        });
-        // Operation counter
-        this.operationCounter = this.meter.createCounter('agentdb.operations', {
-            description: 'Number of database operations',
-        });
-        // Throughput counter
-        this.throughputCounter = this.meter.createCounter('agentdb.throughput', {
-            description: 'Number of operations completed',
-            unit: 'operations',
-        });
-        // Cache hit rate gauge
-        this.cacheHitRateGauge = this.meter.createObservableGauge('agentdb.cache.hit_rate', {
-            description: 'Cache hit rate percentage',
-            unit: '%',
-        });
-        this.cacheHitRateGauge.addCallback((observableResult) => {
-            const total = this.stats.cacheHits + this.stats.cacheMisses;
-            const hitRate = total > 0 ? (this.stats.cacheHits / total) * 100 : 0;
-            observableResult.observe(hitRate);
-        });
-    }
-    /**
-     * Get tracer instance
-     */
-    getTracer() {
-        return this.tracer;
-    }
-    /**
-     * Start a new span
-     */
-    startSpan(name, attributes) {
-        if (!this.config.enabled || !this.tracer) {
-            return null;
-        }
-        return this.tracer.startSpan(name, {
-            attributes,
-        });
-    }
-    /**
-     * Record query latency
-     */
-    recordQueryLatency(latencyMs, operationType, tableName, success = true) {
-        if (!this.config.enabled || !this.queryLatencyHistogram)
-            return;
-        this.queryLatencyHistogram.record(latencyMs, {
-            operation_type: operationType,
-            table_name: tableName || 'unknown',
-            success: success.toString(),
-        });
-    }
-    /**
-     * Record cache hit
-     */
-    recordCacheHit(key) {
-        if (!this.config.enabled || !this.cacheHitCounter)
-            return;
-        this.stats.cacheHits++;
-        this.cacheHitCounter.add(1, { key_type: this.getKeyType(key) });
-    }
-    /**
-     * Record cache miss
-     */
-    recordCacheMiss(key) {
-        if (!this.config.enabled || !this.cacheMissCounter)
-            return;
-        this.stats.cacheMisses++;
-        this.cacheMissCounter.add(1, { key_type: this.getKeyType(key) });
-    }
-    /**
-     * Record error
-     */
-    recordError(errorType, operation, message) {
-        if (!this.config.enabled || !this.errorCounter)
-            return;
-        this.errorCounter.add(1, {
-            error_type: errorType,
-            operation,
-            message: message || 'unknown',
-        });
-    }
-    /**
-     * Record operation
-     */
-    recordOperation(operationType, tableName, resultSize) {
-        if (!this.config.enabled || !this.operationCounter)
-            return;
-        this.operationCounter.add(1, {
-            operation_type: operationType,
-            table_name: tableName || 'unknown',
-            result_size: resultSize?.toString() || '0',
-        });
-        if (this.throughputCounter) {
-            this.throughputCounter.add(1, {
-                operation_type: operationType,
-            });
-        }
-    }
-    /**
-     * Get key type from cache key
-     */
-    getKeyType(key) {
-        if (key.startsWith('query:'))
-            return 'query';
-        if (key.startsWith('skill:'))
-            return 'skill';
-        if (key.startsWith('episode:'))
-            return 'episode';
-        return 'other';
-    }
-    /**
-     * Shutdown telemetry
-     */
-    async shutdown() {
-        if (this.sdk) {
-            await this.sdk.shutdown();
-            console.log('[AgentDB] Telemetry shut down');
-        }
-    }
-    /**
-     * Check if telemetry is enabled
-     */
-    isEnabled() {
-        return this.config.enabled;
-    }
-    /**
-     * Reset statistics (for testing)
-     */
-    resetStats() {
-        this.stats = {
-            cacheHits: 0,
-            cacheMisses: 0,
-        };
-    }
-}
-/**
- * Helper function to record metrics
- */
-export function recordMetric(type, data) {
-    const telemetry = TelemetryManager.getInstance();
-    switch (type) {
-        case 'query':
-            if (data.latencyMs !== undefined && data.operationType) {
-                telemetry.recordQueryLatency(data.latencyMs, data.operationType, data.tableName, data.success);
-            }
-            break;
-        case 'cache_hit':
-            if (data.key) {
-                telemetry.recordCacheHit(data.key);
-            }
-            break;
-        case 'cache_miss':
-            if (data.key) {
-                telemetry.recordCacheMiss(data.key);
-            }
-            break;
-        case 'error':
-            if (data.errorType && data.operation) {
-                telemetry.recordError(data.errorType, data.operation, data.message);
-            }
-            break;
-        case 'operation':
-            if (data.operationType) {
-                telemetry.recordOperation(data.operationType, data.tableName, data.resultSize);
-            }
-            break;
-    }
-}
-/**
- * Decorator for automatic tracing
- */
-export function traced(operationName, options = {}) {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- decorator target requires any
-    return function (target, propertyKey, descriptor) {
-        const originalMethod = descriptor.value;
-        const spanName = operationName || `${target.constructor.name}.${propertyKey}`;
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- decorator args require any
-        descriptor.value = async function (...args) {
-            const telemetry = TelemetryManager.getInstance();
-            if (!telemetry.isEnabled()) {
-                return originalMethod.apply(this, args);
-            }
-            const startTime = Date.now();
-            const span = telemetry.startSpan(spanName, options.attributes);
-            try {
-                const result = await originalMethod.apply(this, args);
-                if (span) {
-                    try {
-                        span.setStatus({ code: 1 }); // OK status code
-                        span.setAttribute('result_size', JSON.stringify(result).length);
-                    }
-                    catch {
-                        // Ignore span errors
-                    }
-                }
-                if (options.recordMetrics) {
-                    const latency = Date.now() - startTime;
-                    telemetry.recordQueryLatency(latency, spanName, undefined, true);
-                    telemetry.recordOperation(spanName);
-                }
-                return result;
-            }
-            catch (error) {
-                if (span) {
-                    try {
-                        span.setStatus({
-                            code: 2, // ERROR status code
-                            message: error instanceof Error ? error.message : 'Unknown error',
-                        });
-                        if (span.recordException) {
-                            span.recordException(error);
-                        }
-                    }
-                    catch {
-                        // Ignore span errors
-                    }
-                }
-                if (options.recordMetrics) {
-                    const latency = Date.now() - startTime;
-                    telemetry.recordQueryLatency(latency, spanName, undefined, false);
-                    telemetry.recordError(error instanceof Error ? error.name : 'UnknownError', spanName, error instanceof Error ? error.message : 'Unknown error');
-                }
-                throw error;
-            }
-            finally {
-                if (span && span.end) {
-                    try {
-                        span.end();
-                    }
-                    catch {
-                        // Ignore span errors
-                    }
-                }
-            }
-        };
-        return descriptor;
-    };
-}
-/**
- * Manual span wrapper for non-decorator usage
- */
-export async function withSpan(spanName, fn, attributes) {
-    const telemetry = TelemetryManager.getInstance();
-    if (!telemetry.isEnabled()) {
-        return fn(null);
-    }
-    const span = telemetry.startSpan(spanName, attributes);
-    try {
-        const result = await fn(span);
-        if (span && span.setStatus) {
-            try {
-                span.setStatus({ code: 1 }); // OK status code
-            }
-            catch {
-                // Ignore
-            }
-        }
-        return result;
-    }
-    catch (error) {
-        if (span) {
-            try {
-                if (span.setStatus) {
-                    span.setStatus({
-                        code: 2, // ERROR status code
-                        message: error instanceof Error ? error.message : 'Unknown error',
-                    });
-                }
-                if (span.recordException) {
-                    span.recordException(error);
-                }
-            }
-            catch {
-                // Ignore
-            }
-        }
-        throw error;
-    }
-    finally {
-        if (span && span.end) {
-            try {
-                span.end();
-            }
-            catch {
-                // Ignore
-            }
-        }
-    }
-}
-// Initialize telemetry on module load
-const telemetry = TelemetryManager.getInstance();
-telemetry.initialize().catch(console.error);
-// Graceful shutdown on process termination
-process.on('SIGTERM', async () => {
-    await telemetry.shutdown();
-});
-process.on('SIGINT', async () => {
-    await telemetry.shutdown();
-});
-export default TelemetryManager;
-//# sourceMappingURL=telemetry.js.map

package/dist/src/observability/telemetry.js.map

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

package/dist/src/quantization/index.d.ts

@@ -1,7 +0,0 @@
-/**
- * Vector Quantization Module
- *
- * Exports all quantization utilities for AgentDB.
- */
-export { type QuantizationStats, type QuantizedVector, type ProductQuantizerConfig, type PQEncodedVector, type QuantizedVectorStoreConfig, type QuantizedSearchResult, quantize8bit, quantize4bit, dequantize8bit, dequantize4bit, calculateQuantizationError, getQuantizationStats, ProductQuantizer, QuantizedVectorStore, createScalar8BitStore, createScalar4BitStore, createProductQuantizedStore, } from './vector-quantization.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/src/quantization/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/quantization/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,0BAA0B,EAC/B,KAAK,qBAAqB,EAE1B,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,EACd,0BAA0B,EAC1B,oBAAoB,EAEpB,gBAAgB,EAEhB,oBAAoB,EAEpB,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,0BAA0B,CAAC"}

package/dist/src/quantization/index.js

@@ -1,15 +0,0 @@
-/**
- * Vector Quantization Module
- *
- * Exports all quantization utilities for AgentDB.
- */
-export { 
-// Scalar Quantization Functions
-quantize8bit, quantize4bit, dequantize8bit, dequantize4bit, calculateQuantizationError, getQuantizationStats, 
-// Product Quantization
-ProductQuantizer, 
-// Quantized Vector Store
-QuantizedVectorStore, 
-// Factory Functions
-createScalar8BitStore, createScalar4BitStore, createProductQuantizedStore, } from './vector-quantization.js';
-//# sourceMappingURL=index.js.map

package/dist/src/quantization/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/quantization/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO;AAQL,gCAAgC;AAChC,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,EACd,0BAA0B,EAC1B,oBAAoB;AACpB,uBAAuB;AACvB,gBAAgB;AAChB,yBAAyB;AACzB,oBAAoB;AACpB,oBAAoB;AACpB,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,0BAA0B,CAAC"}