agentic-qe 1.9.4 → 2.1.0

package/dist/core/transport/QUICTransport.d.ts

@@ -0,0 +1,320 @@
+/**
+ * QUIC Transport Layer for AgentDB
+ * Provides low-latency, multiplexed connections with HTTP/2 fallback
+ *
+ * Since QUIC is experimental in Node.js, this implementation uses HTTP/2 as primary
+ * transport with the QUIC interface ready for future integration.
+ *
+ * Features:
+ * - Connection pooling with automatic scaling
+ * - Circuit breaker pattern for fault tolerance
+ * - Exponential backoff retry logic
+ * - Health monitoring and metrics
+ * - Automatic fallback from HTTP/2 to HTTP/1.1
+ * - Low-latency multiplexed streams
+ *
+ * @version 1.0.0
+ */
+import { EventEmitter } from 'events';
+/**
+ * QUIC Transport Configuration
+ */
+export interface QUICConfig {
+    /** Server host */
+    host: string;
+    /** Server port */
+    port: number;
+    /** Maximum concurrent streams per connection */
+    maxStreams: number;
+    /** Connection idle timeout in ms */
+    idleTimeout: number;
+    /** Enable HTTP/2 and HTTP/1.1 fallback */
+    enableFallback: boolean;
+    /** Number of retry attempts on failure */
+    retryAttempts: number;
+    /** Delay between retry attempts in ms */
+    retryDelay: number;
+    /** Connection pool size (min, max) */
+    poolSize?: {
+        min: number;
+        max: number;
+    };
+    /** Circuit breaker configuration */
+    circuitBreaker?: {
+        failureThreshold: number;
+        successThreshold: number;
+        timeout: number;
+    };
+    /** Enable TLS */
+    enableTLS?: boolean;
+    /** TLS certificate options */
+    tls?: {
+        cert?: Buffer;
+        key?: Buffer;
+        ca?: Buffer;
+        rejectUnauthorized?: boolean;
+    };
+}
+/**
+ * Connection health metrics
+ */
+export interface ConnectionHealth {
+    /** Average latency in ms */
+    latency: number;
+    /** Packet loss rate (0-1) */
+    packetLoss: number;
+    /** Throughput in bytes/sec */
+    throughput: number;
+    /** Active streams count */
+    activeStreams: number;
+    /** Last health check timestamp */
+    lastHealthCheck: Date;
+    /** Connection state */
+    state: 'healthy' | 'degraded' | 'unhealthy';
+    /** Transport protocol in use */
+    protocol: 'http2' | 'http1' | 'quic';
+}
+/**
+ * Transport metrics
+ */
+export interface TransportMetrics {
+    /** Total requests sent */
+    totalRequests: number;
+    /** Total successful requests */
+    successfulRequests: number;
+    /** Total failed requests */
+    failedRequests: number;
+    /** Average latency in ms */
+    avgLatency: number;
+    /** P50 latency in ms */
+    p50Latency: number;
+    /** P95 latency in ms */
+    p95Latency: number;
+    /** P99 latency in ms */
+    p99Latency: number;
+    /** Total bytes sent */
+    bytesSent: number;
+    /** Total bytes received */
+    bytesReceived: number;
+    /** Circuit breaker state */
+    circuitBreakerState: 'closed' | 'open' | 'half-open';
+    /** Active connections */
+    activeConnections: number;
+    /** Connection pool utilization (0-1) */
+    poolUtilization: number;
+}
+/**
+ * Circuit breaker state
+ */
+export interface CircuitBreakerState {
+    state: 'closed' | 'open' | 'half-open';
+    failureCount: number;
+    successCount: number;
+    lastFailure: Date | null;
+    nextRetryTime: Date | null;
+}
+/**
+ * Connection wrapper
+ */
+interface Connection {
+    id: string;
+    session: any;
+    endpoint: string;
+    protocol: 'http2' | 'http1';
+    createdAt: Date;
+    lastUsed: Date;
+    requestCount: number;
+    isHealthy: boolean;
+    streams: Set<number>;
+}
+/**
+ * Circuit Breaker Implementation
+ * Prevents cascading failures by stopping requests to unhealthy services
+ */
+export declare class CircuitBreaker {
+    private state;
+    private failureCount;
+    private successCount;
+    private lastFailure;
+    private nextRetryTime;
+    private readonly failureThreshold;
+    private readonly successThreshold;
+    private readonly timeout;
+    constructor(options: {
+        failureThreshold: number;
+        successThreshold: number;
+        timeout: number;
+    });
+    /**
+     * Execute operation with circuit breaker protection
+     */
+    execute<T>(operation: () => Promise<T>): Promise<T>;
+    /**
+     * Record successful operation
+     */
+    recordSuccess(): void;
+    /**
+     * Record failed operation
+     */
+    recordFailure(): void;
+    /**
+     * Get current circuit breaker state
+     */
+    getState(): CircuitBreakerState;
+    /**
+     * Reset circuit breaker
+     */
+    reset(): void;
+}
+/**
+ * Connection Pool Management
+ * Manages a pool of reusable connections
+ */
+export declare class ConnectionPool {
+    private connections;
+    private readonly maxSize;
+    private readonly minSize;
+    private readonly idleTimeout;
+    private cleanupInterval;
+    constructor(options: {
+        minSize: number;
+        maxSize: number;
+        idleTimeout: number;
+    });
+    /**
+     * Acquire a connection from the pool
+     */
+    acquire(): Promise<Connection>;
+    /**
+     * Release a connection back to the pool
+     */
+    release(conn: Connection): void;
+    /**
+     * Mark connection as unhealthy
+     */
+    markUnhealthy(conn: Connection): void;
+    /**
+     * Get pool statistics
+     */
+    getStats(): {
+        size: number;
+        healthy: number;
+        utilization: number;
+    };
+    /**
+     * Drain and close all connections
+     */
+    drain(): Promise<void>;
+    /**
+     * Cleanup idle connections
+     */
+    private cleanup;
+    /**
+     * Create a new connection (placeholder - implemented in QUICTransport)
+     */
+    private createConnection;
+    /**
+     * Close a connection
+     */
+    private closeConnection;
+    private sleep;
+}
+/**
+ * QUIC Transport Layer
+ * Main transport implementation with HTTP/2 fallback
+ */
+export declare class QUICTransport extends EventEmitter {
+    private readonly config;
+    private readonly pools;
+    private readonly circuitBreaker;
+    private readonly requests;
+    private metrics;
+    private latencyBuffer;
+    constructor(config: QUICConfig);
+    /**
+     * Connect to an endpoint
+     */
+    connect(endpoint: string): Promise<Connection>;
+    /**
+     * Disconnect from an endpoint
+     */
+    disconnect(endpoint: string): Promise<void>;
+    /**
+     * Send data to endpoint
+     */
+    send(endpoint: string, data: Buffer): Promise<Buffer>;
+    /**
+     * Check connection health
+     */
+    healthCheck(endpoint: string): Promise<ConnectionHealth>;
+    /**
+     * Get transport metrics
+     */
+    getMetrics(): TransportMetrics;
+    /**
+     * Execute operation with circuit breaker
+     */
+    withCircuitBreaker<T>(operation: () => Promise<T>): Promise<T>;
+    /**
+     * Execute operation with retry logic
+     */
+    withRetry<T>(operation: () => Promise<T>, attempts?: number): Promise<T>;
+    /**
+     * Close all connections and cleanup
+     */
+    close(): Promise<void>;
+    /**
+     * Get or create connection pool for endpoint
+     */
+    private getOrCreatePool;
+    /**
+     * Detect best protocol for endpoint
+     */
+    private detectBestProtocol;
+    /**
+     * Create HTTP/2 connection
+     */
+    private createHTTP2Connection;
+    /**
+     * Create HTTP/1.1 connection
+     */
+    private createHTTP1Connection;
+    /**
+     * Send data via HTTP/2
+     */
+    private sendHTTP2;
+    /**
+     * Send data via HTTP/1.1
+     */
+    private sendHTTP1;
+    /**
+     * Record request timing
+     */
+    private recordRequest;
+    /**
+     * Calculate throughput
+     */
+    private calculateThroughput;
+    /**
+     * Sleep utility
+     */
+    private sleep;
+    /**
+     * Fallback to HTTP/2 (already implemented as primary)
+     */
+    private fallbackToHTTP2;
+    /**
+     * Fallback to HTTP/1.1
+     */
+    private fallbackToHTTP1;
+}
+/**
+ * Default QUIC configuration
+ */
+export declare const DEFAULT_QUIC_CONFIG: QUICConfig;
+/**
+ * Create QUIC transport with default configuration
+ */
+export declare function createQUICTransport(config?: Partial<QUICConfig>): QUICTransport;
+export {};
+//# sourceMappingURL=QUICTransport.d.ts.map

package/dist/core/transport/QUICTransport.d.ts.map

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