agentdb 1.5.8 → 1.6.0

package/dist/controllers/QUICServer.js

@@ -0,0 +1,383 @@
+/**
+ * QUICServer - QUIC Protocol Server for AgentDB Synchronization
+ *
+ * Implements a QUIC server for receiving and handling synchronization requests
+ * from remote AgentDB instances. Supports episodes, skills, and edge synchronization.
+ *
+ * Features:
+ * - Start/stop server lifecycle management
+ * - Client connection handling
+ * - Authentication and authorization
+ * - Rate limiting per client
+ * - Sync request processing (episodes, skills, edges)
+ * - Comprehensive error handling and logging
+ */
+import chalk from 'chalk';
+export class QUICServer {
+    db;
+    config;
+    isRunning = false;
+    connections = new Map();
+    rateLimitState = new Map();
+    server = null;
+    cleanupInterval = null;
+    constructor(db, config = {}) {
+        this.db = db;
+        this.config = {
+            host: config.host || '0.0.0.0',
+            port: config.port || 4433,
+            maxConnections: config.maxConnections || 100,
+            authToken: config.authToken || '',
+            rateLimit: config.rateLimit || {
+                maxRequestsPerMinute: 60,
+                maxBytesPerMinute: 10 * 1024 * 1024, // 10MB
+            },
+            tlsConfig: config.tlsConfig || {},
+        };
+    }
+    /**
+     * Start the QUIC server
+     */
+    async start() {
+        if (this.isRunning) {
+            console.log(chalk.yellow('⚠️  QUIC server is already running'));
+            return;
+        }
+        try {
+            console.log(chalk.blue('🚀 Starting QUIC server...'));
+            console.log(chalk.gray(`   Host: ${this.config.host}`));
+            console.log(chalk.gray(`   Port: ${this.config.port}`));
+            // Note: Actual QUIC implementation would use a library like @fails-components/webtransport
+            // or node-quic. This is a reference implementation showing the interface.
+            // Initialize server state
+            this.isRunning = true;
+            this.startCleanupInterval();
+            console.log(chalk.green('✓ QUIC server started successfully'));
+            console.log(chalk.gray(`  Max connections: ${this.config.maxConnections}`));
+            console.log(chalk.gray(`  Rate limit: ${this.config.rateLimit.maxRequestsPerMinute} req/min`));
+        }
+        catch (error) {
+            const err = error;
+            console.error(chalk.red('✗ Failed to start QUIC server:'), err.message);
+            throw new Error(`QUIC server start failed: ${err.message}`);
+        }
+    }
+    /**
+     * Stop the QUIC server
+     */
+    async stop() {
+        if (!this.isRunning) {
+            console.log(chalk.yellow('⚠️  QUIC server is not running'));
+            return;
+        }
+        try {
+            console.log(chalk.blue('🛑 Stopping QUIC server...'));
+            // Close all connections
+            for (const [clientId, connection] of this.connections.entries()) {
+                console.log(chalk.gray(`  Closing connection: ${clientId}`));
+                // Close connection logic here
+            }
+            this.connections.clear();
+            this.rateLimitState.clear();
+            // Stop cleanup interval
+            if (this.cleanupInterval) {
+                clearInterval(this.cleanupInterval);
+                this.cleanupInterval = null;
+            }
+            // Close server
+            if (this.server) {
+                // await this.server.close();
+                this.server = null;
+            }
+            this.isRunning = false;
+            console.log(chalk.green('✓ QUIC server stopped successfully'));
+        }
+        catch (error) {
+            const err = error;
+            console.error(chalk.red('✗ Error stopping QUIC server:'), err.message);
+            throw new Error(`QUIC server stop failed: ${err.message}`);
+        }
+    }
+    /**
+     * Handle incoming client connection
+     */
+    async handleConnection(clientId, address) {
+        // Check max connections
+        if (this.connections.size >= this.config.maxConnections) {
+            console.log(chalk.yellow(`⚠️  Max connections reached, rejecting ${clientId}`));
+            return false;
+        }
+        // Register connection
+        const connection = {
+            id: clientId,
+            address,
+            connectedAt: Date.now(),
+            requestCount: 0,
+            bytesReceived: 0,
+            lastRequestAt: 0,
+        };
+        this.connections.set(clientId, connection);
+        console.log(chalk.green(`✓ Client connected: ${clientId} from ${address}`));
+        console.log(chalk.gray(`  Active connections: ${this.connections.size}`));
+        return true;
+    }
+    /**
+     * Authenticate client request
+     */
+    authenticate(clientId, authToken) {
+        if (!this.config.authToken) {
+            return true; // No auth required
+        }
+        const isValid = authToken === this.config.authToken;
+        if (!isValid) {
+            console.log(chalk.red(`✗ Authentication failed for client: ${clientId}`));
+        }
+        return isValid;
+    }
+    /**
+     * Check rate limits for client
+     */
+    checkRateLimit(clientId, requestSize) {
+        const now = Date.now();
+        let state = this.rateLimitState.get(clientId);
+        if (!state || now - state.windowStart > 60000) {
+            // New window
+            state = {
+                requestCount: 0,
+                bytesTransferred: 0,
+                windowStart: now,
+            };
+            this.rateLimitState.set(clientId, state);
+        }
+        // Check limits
+        if (state.requestCount >= this.config.rateLimit.maxRequestsPerMinute) {
+            console.log(chalk.yellow(`⚠️  Rate limit exceeded (requests) for ${clientId}`));
+            return false;
+        }
+        if (state.bytesTransferred + requestSize > this.config.rateLimit.maxBytesPerMinute) {
+            console.log(chalk.yellow(`⚠️  Rate limit exceeded (bytes) for ${clientId}`));
+            return false;
+        }
+        // Update state
+        state.requestCount++;
+        state.bytesTransferred += requestSize;
+        return true;
+    }
+    /**
+     * Process sync request from client
+     */
+    async processSyncRequest(clientId, request, authToken) {
+        try {
+            // Authenticate
+            if (!this.authenticate(clientId, authToken)) {
+                return {
+                    success: false,
+                    error: 'Authentication failed',
+                };
+            }
+            // Check rate limit
+            const requestSize = JSON.stringify(request).length;
+            if (!this.checkRateLimit(clientId, requestSize)) {
+                return {
+                    success: false,
+                    error: 'Rate limit exceeded',
+                };
+            }
+            // Update connection stats
+            const connection = this.connections.get(clientId);
+            if (connection) {
+                connection.requestCount++;
+                connection.bytesReceived += requestSize;
+                connection.lastRequestAt = Date.now();
+            }
+            console.log(chalk.blue(`📥 Processing sync request from ${clientId}`));
+            console.log(chalk.gray(`   Type: ${request.type}`));
+            console.log(chalk.gray(`   Since: ${request.since || 'full sync'}`));
+            // Process based on type
+            let data;
+            let count = 0;
+            switch (request.type) {
+                case 'episodes':
+                    data = await this.syncEpisodes(request);
+                    count = data.length;
+                    break;
+                case 'skills':
+                    data = await this.syncSkills(request);
+                    count = data.length;
+                    break;
+                case 'edges':
+                    data = await this.syncEdges(request);
+                    count = data.length;
+                    break;
+                case 'full':
+                    data = await this.syncFull(request);
+                    count = data.episodes?.length + data.skills?.length + data.edges?.length || 0;
+                    break;
+                default:
+                    return {
+                        success: false,
+                        error: `Unknown sync type: ${request.type}`,
+                    };
+            }
+            console.log(chalk.green(`✓ Sync completed: ${count} items sent`));
+            return {
+                success: true,
+                data,
+                count,
+                hasMore: false, // Could implement pagination here
+            };
+        }
+        catch (error) {
+            const err = error;
+            console.error(chalk.red('✗ Sync request failed:'), err.message);
+            return {
+                success: false,
+                error: err.message,
+            };
+        }
+    }
+    /**
+     * Sync episodes data
+     */
+    async syncEpisodes(request) {
+        const { since, filters, batchSize = 1000 } = request;
+        let query = 'SELECT * FROM episodes WHERE 1=1';
+        const params = [];
+        if (since) {
+            query += ' AND ts > ?';
+            params.push(since);
+        }
+        // Apply filters
+        if (filters) {
+            if (filters.sessionId) {
+                query += ' AND session_id = ?';
+                params.push(filters.sessionId);
+            }
+            if (filters.success !== undefined) {
+                query += ' AND success = ?';
+                params.push(filters.success ? 1 : 0);
+            }
+        }
+        query += ` ORDER BY ts DESC LIMIT ${batchSize}`;
+        const stmt = this.db.prepare(query);
+        const rows = stmt.all(...params);
+        return rows.map((row) => ({
+            id: row.id,
+            ts: row.ts,
+            sessionId: row.session_id,
+            task: row.task,
+            input: row.input,
+            output: row.output,
+            critique: row.critique,
+            reward: row.reward,
+            success: row.success === 1,
+            latencyMs: row.latency_ms,
+            tokensUsed: row.tokens_used,
+            tags: row.tags ? JSON.parse(row.tags) : [],
+            metadata: row.metadata ? JSON.parse(row.metadata) : {},
+        }));
+    }
+    /**
+     * Sync skills data
+     */
+    async syncSkills(request) {
+        const { since, batchSize = 1000 } = request;
+        let query = 'SELECT * FROM skills WHERE 1=1';
+        const params = [];
+        if (since) {
+            query += ' AND ts > ?';
+            params.push(since);
+        }
+        query += ` ORDER BY ts DESC LIMIT ${batchSize}`;
+        const stmt = this.db.prepare(query);
+        const rows = stmt.all(...params);
+        return rows.map((row) => ({
+            id: row.id,
+            ts: row.ts,
+            name: row.name,
+            description: row.description,
+            code: row.code,
+            successRate: row.success_rate,
+            usageCount: row.usage_count,
+            avgReward: row.avg_reward,
+            tags: row.tags ? JSON.parse(row.tags) : [],
+            metadata: row.metadata ? JSON.parse(row.metadata) : {},
+        }));
+    }
+    /**
+     * Sync edges (skill relationships)
+     */
+    async syncEdges(request) {
+        const { since, batchSize = 1000 } = request;
+        let query = 'SELECT * FROM skill_edges WHERE 1=1';
+        const params = [];
+        if (since) {
+            query += ' AND ts > ?';
+            params.push(since);
+        }
+        query += ` ORDER BY ts DESC LIMIT ${batchSize}`;
+        const stmt = this.db.prepare(query);
+        const rows = stmt.all(...params);
+        return rows.map((row) => ({
+            id: row.id,
+            ts: row.ts,
+            fromSkillId: row.from_skill_id,
+            toSkillId: row.to_skill_id,
+            weight: row.weight,
+            coOccurrences: row.co_occurrences,
+        }));
+    }
+    /**
+     * Full sync of all data
+     */
+    async syncFull(request) {
+        const [episodes, skills, edges] = await Promise.all([
+            this.syncEpisodes(request),
+            this.syncSkills(request),
+            this.syncEdges(request),
+        ]);
+        return {
+            episodes,
+            skills,
+            edges,
+        };
+    }
+    /**
+     * Start cleanup interval for stale connections
+     */
+    startCleanupInterval() {
+        this.cleanupInterval = setInterval(() => {
+            const now = Date.now();
+            const staleThreshold = 5 * 60 * 1000; // 5 minutes
+            for (const [clientId, connection] of this.connections.entries()) {
+                if (now - connection.lastRequestAt > staleThreshold && connection.requestCount > 0) {
+                    console.log(chalk.gray(`🧹 Removing stale connection: ${clientId}`));
+                    this.connections.delete(clientId);
+                    this.rateLimitState.delete(clientId);
+                }
+            }
+        }, 60000); // Run every minute
+    }
+    /**
+     * Get server status
+     */
+    getStatus() {
+        let totalRequests = 0;
+        for (const connection of this.connections.values()) {
+            totalRequests += connection.requestCount;
+        }
+        return {
+            isRunning: this.isRunning,
+            activeConnections: this.connections.size,
+            totalRequests,
+            config: this.config,
+        };
+    }
+    /**
+     * Get connection info
+     */
+    getConnections() {
+        return Array.from(this.connections.values());
+    }
+}
+//# sourceMappingURL=QUICServer.js.map

package/dist/controllers/QUICServer.js.map

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

package/dist/controllers/SyncCoordinator.d.ts

@@ -0,0 +1,120 @@
+/**
+ * SyncCoordinator - Orchestrate AgentDB Synchronization
+ *
+ * Coordinates bidirectional synchronization between local and remote AgentDB instances.
+ * Handles change detection, conflict resolution, batching, and progress tracking.
+ *
+ * Features:
+ * - Detect changes since last sync
+ * - Bidirectional sync (push and pull)
+ * - Conflict resolution strategies
+ * - Batch operations for efficiency
+ * - Progress tracking and reporting
+ * - Comprehensive error handling
+ * - Sync state persistence
+ */
+import { QUICClient } from './QUICClient.js';
+import { QUICServer } from './QUICServer.js';
+type Database = any;
+export interface SyncCoordinatorConfig {
+    db: Database;
+    client?: QUICClient;
+    server?: QUICServer;
+    conflictStrategy?: 'local-wins' | 'remote-wins' | 'latest-wins' | 'merge';
+    batchSize?: number;
+    autoSync?: boolean;
+    syncIntervalMs?: number;
+}
+export interface SyncState {
+    lastSyncAt: number;
+    lastEpisodeSync: number;
+    lastSkillSync: number;
+    lastEdgeSync: number;
+    totalItemsSynced: number;
+    totalBytesSynced: number;
+    syncCount: number;
+    lastError?: string;
+}
+export interface SyncProgress {
+    phase: 'detecting' | 'pushing' | 'pulling' | 'resolving' | 'applying' | 'completed' | 'error';
+    current: number;
+    total: number;
+    itemType?: string;
+    message?: string;
+    error?: string;
+}
+export interface SyncReport {
+    success: boolean;
+    startTime: number;
+    endTime: number;
+    durationMs: number;
+    itemsPushed: number;
+    itemsPulled: number;
+    conflictsResolved: number;
+    errors: string[];
+    bytesTransferred: number;
+}
+export declare class SyncCoordinator {
+    private db;
+    private client?;
+    private server?;
+    private config;
+    private syncState;
+    private isSyncing;
+    private autoSyncInterval;
+    constructor(config: SyncCoordinatorConfig);
+    /**
+     * Perform bidirectional synchronization
+     */
+    sync(onProgress?: (progress: SyncProgress) => void): Promise<SyncReport>;
+    /**
+     * Detect changes since last sync
+     */
+    private detectChanges;
+    /**
+     * Push local changes to remote
+     */
+    private pushChanges;
+    /**
+     * Pull changes from remote
+     */
+    private pullChanges;
+    /**
+     * Resolve conflicts between local and remote data
+     */
+    private resolveConflicts;
+    /**
+     * Apply pulled changes to local database
+     */
+    private applyChanges;
+    /**
+     * Load sync state from database
+     */
+    private loadSyncState;
+    /**
+     * Save sync state to database
+     */
+    private saveSyncState;
+    /**
+     * Start automatic synchronization
+     */
+    private startAutoSync;
+    /**
+     * Stop automatic synchronization
+     */
+    stopAutoSync(): void;
+    /**
+     * Get sync state
+     */
+    getSyncState(): SyncState;
+    /**
+     * Get sync status
+     */
+    getStatus(): {
+        isSyncing: boolean;
+        autoSyncEnabled: boolean;
+        state: SyncState;
+    };
+}
+export {};
+//# sourceMappingURL=SyncCoordinator.d.ts.map

package/dist/controllers/SyncCoordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SyncCoordinator.d.ts","sourceRoot":"","sources":["../../src/controllers/SyncCoordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,UAAU,EAA2B,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAe,MAAM,iBAAiB,CAAC;AAG1D,KAAK,QAAQ,GAAG,GAAG,CAAC;AAEpB,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,gBAAgB,CAAC,EAAE,YAAY,GAAG,aAAa,GAAG,aAAa,GAAG,OAAO,CAAC;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC;IAC9F,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,EAAE,CAAW;IACrB,OAAO,CAAC,MAAM,CAAC,CAAa;IAC5B,OAAO,CAAC,MAAM,CAAC,CAAa;IAC5B,OAAO,CAAC,MAAM,CAAoE;IAClF,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,gBAAgB,CAA+B;gBAE3C,MAAM,EAAE,qBAAqB;IAoBzC;;OAEG;IACG,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;IA0G9E;;OAEG;YACW,aAAa;IAyB3B;;OAEG;YACW,WAAW;IAezB;;OAEG;YACW,WAAW;IAuGzB;;OAEG;YACW,gBAAgB;IA4B9B;;OAEG;YACW,YAAY;IA2E1B;;OAEG;IACH,OAAO,CAAC,aAAa;IAiCrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAyCrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAiBrB;;OAEG;IACH,YAAY,IAAI,IAAI;IAQpB;;OAEG;IACH,YAAY,IAAI,SAAS;IAIzB;;OAEG;IACH,SAAS,IAAI;QACX,SAAS,EAAE,OAAO,CAAC;QACnB,eAAe,EAAE,OAAO,CAAC;QACzB,KAAK,EAAE,SAAS,CAAC;KAClB;CAOF"}