agentic-qe 1.8.3 → 1.9.0

package/dist/persistence/event-store.js

@@ -0,0 +1,315 @@
+"use strict";
+/**
+ * @fileoverview Event store for telemetry and event history persistence
+ * @module persistence/event-store
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventStore = void 0;
+const uuid_1 = require("uuid");
+const schema_1 = require("./schema");
+/**
+ * EventStore provides persistence for telemetry events
+ *
+ * @example
+ * ```typescript
+ * const store = new EventStore({ dbPath: './data/events.db' });
+ *
+ * // Record an event
+ * const event = await store.recordEvent({
+ *   agent_id: 'test-generator',
+ *   event_type: 'test_generated',
+ *   payload: { testCount: 10, coverage: 85 },
+ *   session_id: 'session-123'
+ * });
+ *
+ * // Query events
+ * const agentEvents = store.getEventsByAgent('test-generator');
+ * ```
+ */
+class EventStore {
+    /**
+     * Create a new EventStore instance
+     * @param config - Persistence configuration
+     */
+    constructor(config = {}) {
+        this.config = { ...schema_1.DEFAULT_PERSISTENCE_CONFIG, ...config };
+        this.db = (0, schema_1.createDatabase)(this.config);
+        this.statements = this.prepareStatements();
+    }
+    /**
+     * Prepare SQL statements for performance
+     */
+    prepareStatements() {
+        return {
+            insert: this.db.prepare(`
+        INSERT INTO events (id, timestamp, agent_id, event_type, payload, correlation_id, session_id)
+        VALUES (?, ?, ?, ?, ?, ?, ?)
+      `),
+            getById: this.db.prepare(`
+        SELECT * FROM events WHERE id = ?
+      `),
+            getByAgent: this.db.prepare(`
+        SELECT * FROM events WHERE agent_id = ?
+        ORDER BY timestamp DESC
+        LIMIT ? OFFSET ?
+      `),
+            getByType: this.db.prepare(`
+        SELECT * FROM events WHERE event_type = ?
+        ORDER BY timestamp DESC
+        LIMIT ? OFFSET ?
+      `),
+            getByTimeRange: this.db.prepare(`
+        SELECT * FROM events
+        WHERE timestamp >= ? AND timestamp <= ?
+        ORDER BY timestamp DESC
+        LIMIT ? OFFSET ?
+      `),
+            getBySession: this.db.prepare(`
+        SELECT * FROM events WHERE session_id = ?
+        ORDER BY timestamp ASC
+      `),
+            getByCorrelation: this.db.prepare(`
+        SELECT * FROM events WHERE correlation_id = ?
+        ORDER BY timestamp ASC
+      `),
+            countByAgent: this.db.prepare(`
+        SELECT COUNT(*) as count FROM events WHERE agent_id = ?
+      `),
+            countByType: this.db.prepare(`
+        SELECT COUNT(*) as count FROM events WHERE event_type = ?
+      `),
+            deleteOlderThan: this.db.prepare(`
+        DELETE FROM events WHERE timestamp < ?
+      `),
+        };
+    }
+    /**
+     * Deserialize event record from database row
+     */
+    deserializeEvent(row) {
+        return {
+            id: row.id,
+            timestamp: row.timestamp,
+            agent_id: row.agent_id,
+            event_type: row.event_type,
+            payload: JSON.parse(row.payload),
+            correlation_id: row.correlation_id,
+            session_id: row.session_id,
+        };
+    }
+    /**
+     * Record a new event
+     * @param input - Event creation input
+     * @returns Created event record
+     */
+    recordEvent(input) {
+        const id = (0, uuid_1.v4)();
+        const timestamp = new Date().toISOString();
+        const payload = JSON.stringify(input.payload);
+        let retries = this.config.maxRetries || 3;
+        while (retries > 0) {
+            try {
+                this.statements.insert.run(id, timestamp, input.agent_id, input.event_type, payload, input.correlation_id || null, input.session_id);
+                break;
+            }
+            catch (error) {
+                retries--;
+                if (retries === 0) {
+                    const errorMessage = error instanceof Error ? error.message : String(error);
+                    throw new Error(`Failed to record event after retries: ${errorMessage}`);
+                }
+                // Small delay before retry
+                const start = Date.now();
+                while (Date.now() - start < 100) {
+                    // Busy wait for synchronous retry
+                }
+            }
+        }
+        return {
+            id,
+            timestamp,
+            agent_id: input.agent_id,
+            event_type: input.event_type,
+            payload: input.payload,
+            correlation_id: input.correlation_id || null,
+            session_id: input.session_id,
+        };
+    }
+    /**
+     * Get event by ID
+     * @param id - Event ID
+     * @returns Event record or null
+     */
+    getEventById(id) {
+        const row = this.statements.getById.get(id);
+        return row ? this.deserializeEvent(row) : null;
+    }
+    /**
+     * Get events by agent ID
+     * @param agentId - Agent identifier
+     * @param options - Query options
+     * @returns Array of event records
+     */
+    getEventsByAgent(agentId, options = {}) {
+        const { limit = 100, offset = 0 } = options;
+        const rows = this.statements.getByAgent.all(agentId, limit, offset);
+        return rows.map(row => this.deserializeEvent(row));
+    }
+    /**
+     * Get events by event type
+     * @param eventType - Event type to filter
+     * @param options - Query options
+     * @returns Array of event records
+     */
+    getEventsByType(eventType, options = {}) {
+        const { limit = 100, offset = 0 } = options;
+        const rows = this.statements.getByType.all(eventType, limit, offset);
+        return rows.map(row => this.deserializeEvent(row));
+    }
+    /**
+     * Get events within a time range
+     * @param timeRange - Start and end timestamps
+     * @param options - Query options
+     * @returns Array of event records
+     */
+    getEventsByTimeRange(timeRange, options = {}) {
+        const { limit = 1000, offset = 0 } = options;
+        const rows = this.statements.getByTimeRange.all(timeRange.start, timeRange.end, limit, offset);
+        return rows.map(row => this.deserializeEvent(row));
+    }
+    /**
+     * Get all events for a session
+     * @param sessionId - Session identifier
+     * @returns Array of event records in chronological order
+     */
+    getEventsBySession(sessionId) {
+        const rows = this.statements.getBySession.all(sessionId);
+        return rows.map(row => this.deserializeEvent(row));
+    }
+    /**
+     * Get correlated events
+     * @param correlationId - Correlation identifier
+     * @returns Array of correlated events
+     */
+    getEventsByCorrelation(correlationId) {
+        const rows = this.statements.getByCorrelation.all(correlationId);
+        return rows.map(row => this.deserializeEvent(row));
+    }
+    /**
+     * Count events by agent
+     * @param agentId - Agent identifier
+     * @returns Event count
+     */
+    countEventsByAgent(agentId) {
+        const result = this.statements.countByAgent.get(agentId);
+        return result.count;
+    }
+    /**
+     * Count events by type
+     * @param eventType - Event type
+     * @returns Event count
+     */
+    countEventsByType(eventType) {
+        const result = this.statements.countByType.get(eventType);
+        return result.count;
+    }
+    /**
+     * Get event counts grouped by agent
+     * @returns Map of agent ID to event count
+     */
+    getEventCountsByAgent() {
+        const rows = this.db.prepare(`
+      SELECT agent_id, COUNT(*) as count
+      FROM events
+      GROUP BY agent_id
+      ORDER BY count DESC
+    `).all();
+        const counts = new Map();
+        for (const row of rows) {
+            counts.set(row.agent_id, row.count);
+        }
+        return counts;
+    }
+    /**
+     * Get event counts grouped by type
+     * @returns Map of event type to count
+     */
+    getEventCountsByType() {
+        const rows = this.db.prepare(`
+      SELECT event_type, COUNT(*) as count
+      FROM events
+      GROUP BY event_type
+      ORDER BY count DESC
+    `).all();
+        const counts = new Map();
+        for (const row of rows) {
+            counts.set(row.event_type, row.count);
+        }
+        return counts;
+    }
+    /**
+     * Get recent events with pagination
+     * @param limit - Maximum number of events
+     * @param offset - Number of events to skip
+     * @returns Array of recent events
+     */
+    getRecentEvents(limit = 50, offset = 0) {
+        const rows = this.db.prepare(`
+      SELECT * FROM events
+      ORDER BY timestamp DESC
+      LIMIT ? OFFSET ?
+    `).all(limit, offset);
+        return rows.map(row => this.deserializeEvent(row));
+    }
+    /**
+     * Search events by payload content
+     * @param searchKey - Key to search in payload
+     * @param searchValue - Value to match
+     * @param limit - Maximum results
+     * @returns Matching events
+     */
+    searchByPayload(searchKey, searchValue, limit = 100) {
+        // SQLite JSON extraction
+        const pattern = `%"${searchKey}":${JSON.stringify(searchValue)}%`;
+        const rows = this.db.prepare(`
+      SELECT * FROM events
+      WHERE payload LIKE ?
+      ORDER BY timestamp DESC
+      LIMIT ?
+    `).all(pattern, limit);
+        return rows.map(row => this.deserializeEvent(row));
+    }
+    /**
+     * Delete events older than specified date
+     * @param olderThan - ISO timestamp cutoff
+     * @returns Number of deleted events
+     */
+    deleteEventsOlderThan(olderThan) {
+        const result = this.statements.deleteOlderThan.run(olderThan);
+        return result.changes;
+    }
+    /**
+     * Get database statistics
+     * @returns Statistics about stored events
+     */
+    getStatistics() {
+        const stats = this.db.prepare(`
+      SELECT
+        COUNT(*) as totalEvents,
+        COUNT(DISTINCT agent_id) as uniqueAgents,
+        COUNT(DISTINCT session_id) as uniqueSessions,
+        MIN(timestamp) as oldestEvent,
+        MAX(timestamp) as newestEvent
+      FROM events
+    `).get();
+        return stats;
+    }
+    /**
+     * Close database connection
+     */
+    close() {
+        (0, schema_1.closeDatabase)(this.db);
+    }
+}
+exports.EventStore = EventStore;
+//# sourceMappingURL=event-store.js.map

package/dist/persistence/event-store.js.map

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

package/dist/persistence/index.d.ts

@@ -0,0 +1,145 @@
+/**
+ * @fileoverview Main entry point for AQE persistence layer
+ * @module persistence
+ */
+export { EventType, EventRecord, CreateEventInput, ThoughtType, ChainStatus, ReasoningChain, ReasoningStep, ReasoningChainWithSteps, StartChainInput, AddStepInput, AggregationPeriod, QualityMetric, AggregatedMetric, RecordMetricInput, MetricTrendPoint, AgentPerformance, PersistenceConfig, DEFAULT_PERSISTENCE_CONFIG, CURRENT_SCHEMA_VERSION, createDatabase, closeDatabase, initializeSchema, } from './schema';
+export { EventStore, EventQueryOptions, TimeRange } from './event-store';
+export { ReasoningStore, ChainQueryOptions } from './reasoning-store';
+export { MetricsAggregator, MetricQueryOptions, AggregationConfig } from './metrics-aggregator';
+import { EventStore } from './event-store';
+import { ReasoningStore } from './reasoning-store';
+import { MetricsAggregator } from './metrics-aggregator';
+/**
+ * Options for persistence initialization
+ */
+export interface InitPersistenceOptions {
+    /**
+     * Base directory for database files
+     * @default './data'
+     */
+    baseDir?: string;
+    /**
+     * Enable WAL mode for better concurrency
+     * @default true
+     */
+    enableWAL?: boolean;
+    /**
+     * Busy timeout in milliseconds
+     * @default 5000
+     */
+    busyTimeout?: number;
+    /**
+     * Maximum retry attempts for operations
+     * @default 3
+     */
+    maxRetries?: number;
+    /**
+     * Use separate databases for each store
+     * @default false (single database)
+     */
+    separateDatabases?: boolean;
+}
+/**
+ * Initialized persistence stores
+ */
+export interface PersistenceStores {
+    eventStore: EventStore;
+    reasoningStore: ReasoningStore;
+    metricsAggregator: MetricsAggregator;
+    /**
+     * Close all database connections
+     */
+    close: () => void;
+    /**
+     * Get statistics from all stores
+     */
+    getStatistics: () => {
+        events: ReturnType<EventStore['getStatistics']>;
+        reasoning: ReturnType<ReasoningStore['getStatistics']>;
+        metrics: ReturnType<MetricsAggregator['getStatistics']>;
+    };
+}
+/**
+ * Initialize the persistence layer
+ *
+ * @param options - Initialization options
+ * @returns Initialized persistence stores
+ *
+ * @example
+ * ```typescript
+ * // Initialize with default settings
+ * const persistence = initPersistence();
+ *
+ * // Record an event
+ * persistence.eventStore.recordEvent({
+ *   agent_id: 'test-gen',
+ *   event_type: 'test_generated',
+ *   payload: { count: 5 },
+ *   session_id: 'session-123'
+ * });
+ *
+ * // Start a reasoning chain
+ * const chain = persistence.reasoningStore.startChain({
+ *   session_id: 'session-123',
+ *   agent_id: 'test-gen'
+ * });
+ *
+ * // Record a metric
+ * persistence.metricsAggregator.recordMetric({
+ *   agent_id: 'test-gen',
+ *   metric_name: 'coverage',
+ *   metric_value: 85.5
+ * });
+ *
+ * // Clean up
+ * persistence.close();
+ * ```
+ */
+export declare function initPersistence(options?: InitPersistenceOptions): PersistenceStores;
+/**
+ * Quick utility to create an event store with default settings
+ * @param dbPath - Optional database path
+ * @returns Configured EventStore instance
+ */
+export declare function createEventStore(dbPath?: string): EventStore;
+/**
+ * Quick utility to create a reasoning store with default settings
+ * @param dbPath - Optional database path
+ * @returns Configured ReasoningStore instance
+ */
+export declare function createReasoningStore(dbPath?: string): ReasoningStore;
+/**
+ * Quick utility to create a metrics aggregator with default settings
+ * @param dbPath - Optional database path
+ * @returns Configured MetricsAggregator instance
+ */
+export declare function createMetricsAggregator(dbPath?: string): MetricsAggregator;
+/**
+ * Database cleanup utility
+ * @param baseDir - Directory containing database files
+ * @param olderThan - Delete data older than this ISO timestamp
+ * @returns Cleanup results
+ */
+export declare function cleanupOldData(baseDir: string | undefined, olderThan: string): {
+    eventsDeleted: number;
+    chainsDeleted: number;
+    metricsDeleted: number;
+    aggregatedDeleted: number;
+};
+/**
+ * Run metric aggregation for all periods
+ * @param baseDir - Directory containing database files
+ * @param periods - Periods to aggregate
+ * @returns Aggregation results
+ */
+export declare function runAggregation(baseDir?: string, periods?: Array<'1min' | '5min' | '1hour' | '1day'>): Record<string, number>;
+declare const _default: {
+    initPersistence: typeof initPersistence;
+    createEventStore: typeof createEventStore;
+    createReasoningStore: typeof createReasoningStore;
+    createMetricsAggregator: typeof createMetricsAggregator;
+    cleanupOldData: typeof cleanupOldData;
+    runAggregation: typeof runAggregation;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/persistence/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/persistence/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAEL,SAAS,EACT,WAAW,EACX,gBAAgB,EAGhB,WAAW,EACX,WAAW,EACX,cAAc,EACd,aAAa,EACb,uBAAuB,EACvB,eAAe,EACf,YAAY,EAGZ,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAGhB,iBAAiB,EACjB,0BAA0B,EAC1B,sBAAsB,EAGtB,cAAc,EACd,aAAa,EACb,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGhG,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGzD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,UAAU,CAAC;IACvB,cAAc,EAAE,cAAc,CAAC;IAC/B,iBAAiB,EAAE,iBAAiB,CAAC;IAErC;;OAEG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;IAElB;;OAEG;IACH,aAAa,EAAE,MAAM;QACnB,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC;QAChD,SAAS,EAAE,UAAU,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC;QACvD,OAAO,EAAE,UAAU,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC,CAAC;KACzD,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,iBAAiB,CAyDvF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,cAAc,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,YAAW,EAC1B,SAAS,EAAE,MAAM,GAChB;IACD,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAkBA;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,OAAO,GAAE,MAAiB,EAC1B,OAAO,GAAE,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAqC,GACrF,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAaxB;;;;;;;;;AAGD,wBAOE"}