@defai.digital/automatosx 8.0.19 → 8.0.21

package/dist/src/services/MemoryQueryBuilder.js

@@ -1,298 +0,0 @@
-// Sprint 2 Day 14: Memory Query Builder
-// Type-safe query construction for SQLite FTS5 with filtering and pagination
-/**
- * Memory Query Builder
- *
- * Constructs type-safe SQL queries for FTS5 full-text search with filters
- *
- * @example
- * ```typescript
- * const builder = new MemoryQueryBuilder()
- * const query = builder
- *   .search('authentication implementation')
- *   .filterByAgent('backend')
- *   .filterByDateRange(new Date('2025-01-01'), new Date('2025-01-31'))
- *   .limit(10)
- *   .build()
- *
- * // Execute query
- * const results = db.prepare(query.sql).all(...query.params)
- * ```
- */
-export class MemoryQueryBuilder {
-    searchQuery;
-    exactMatch = false;
-    filters = {};
-    options = {
-        limit: 10,
-        offset: 0,
-        sortBy: 'relevance',
-        sortOrder: 'desc',
-    };
-    /**
-     * Set search query for FTS5
-     */
-    search(query, exactMatch = false) {
-        this.searchQuery = query;
-        this.exactMatch = exactMatch;
-        return this;
-    }
-    /**
-     * Filter by agent name
-     */
-    filterByAgent(agent) {
-        this.filters.agent = agent;
-        return this;
-    }
-    /**
-     * Filter by date range
-     */
-    filterByDateRange(from, to) {
-        this.filters.dateFrom = from;
-        this.filters.dateTo = to;
-        return this;
-    }
-    /**
-     * Filter by tags (OR condition)
-     */
-    filterByTags(tags) {
-        this.filters.tags = tags;
-        return this;
-    }
-    /**
-     * Filter by minimum relevance score
-     */
-    filterByRelevance(minScore) {
-        this.filters.minRelevance = minScore;
-        return this;
-    }
-    /**
-     * Set result limit
-     */
-    limit(count) {
-        this.options.limit = Math.min(count, 100); // Cap at 100
-        return this;
-    }
-    /**
-     * Set result offset for pagination
-     */
-    offset(count) {
-        this.options.offset = Math.max(count, 0);
-        return this;
-    }
-    /**
-     * Set sort order
-     */
-    sortBy(field, order = 'desc') {
-        this.options.sortBy = field;
-        this.options.sortOrder = order;
-        return this;
-    }
-    /**
-     * Build final SQL query
-     */
-    build() {
-        const params = [];
-        const whereClauses = [];
-        const joinClauses = [];
-        // Base table selection
-        let sql = `
-      SELECT
-        m.id,
-        m.agent,
-        m.content,
-        m.timestamp,
-        m.tags,
-        m.metadata
-    `;
-        // Add relevance score if using FTS5 search
-        if (this.searchQuery) {
-            sql += `,
-        rank AS relevance
-      `;
-        }
-        sql += `
-      FROM memories m
-    `;
-        // Join with FTS5 table if searching
-        if (this.searchQuery) {
-            sql += `
-      INNER JOIN memories_fts mfts ON m.id = mfts.rowid
-      `;
-            // Build FTS5 MATCH query
-            const matchQuery = this.exactMatch
-                ? `"${this.searchQuery}"`
-                : this.buildFTS5Query(this.searchQuery);
-            whereClauses.push(`mfts MATCH ?`);
-            params.push(matchQuery);
-        }
-        // Apply filters
-        if (this.filters.agent) {
-            whereClauses.push(`m.agent = ?`);
-            params.push(this.filters.agent);
-        }
-        if (this.filters.dateFrom) {
-            whereClauses.push(`m.timestamp >= ?`);
-            params.push(this.filters.dateFrom.toISOString());
-        }
-        if (this.filters.dateTo) {
-            whereClauses.push(`m.timestamp <= ?`);
-            params.push(this.filters.dateTo.toISOString());
-        }
-        if (this.filters.tags && this.filters.tags.length > 0) {
-            const tagConditions = this.filters.tags
-                .map(() => `m.tags LIKE ?`)
-                .join(' OR ');
-            whereClauses.push(`(${tagConditions})`);
-            this.filters.tags.forEach(tag => params.push(`%${tag}%`));
-        }
-        if (this.filters.minRelevance && this.searchQuery) {
-            whereClauses.push(`rank >= ?`);
-            params.push(this.filters.minRelevance);
-        }
-        // Add WHERE clause
-        if (whereClauses.length > 0) {
-            sql += `\n      WHERE ${whereClauses.join(' AND ')}`;
-        }
-        // Add ORDER BY
-        const sortColumn = this.getSortColumn();
-        sql += `\n      ORDER BY ${sortColumn} ${this.options.sortOrder?.toUpperCase()}`;
-        // Add LIMIT and OFFSET
-        sql += `\n      LIMIT ? OFFSET ?`;
-        params.push(this.options.limit, this.options.offset);
-        // Generate explanation
-        const explanation = this.generateExplanation();
-        return {
-            sql: sql.trim(),
-            params,
-            explanation,
-        };
-    }
-    /**
-     * Build FTS5 MATCH query with boolean operators
-     */
-    buildFTS5Query(query) {
-        // Split query into terms
-        const terms = query.toLowerCase().split(/\s+/).filter(t => t.length > 0);
-        // Build FTS5 query with implicit AND
-        return terms.join(' ');
-    }
-    /**
-     * Get sort column based on sort option
-     */
-    getSortColumn() {
-        switch (this.options.sortBy) {
-            case 'relevance':
-                return this.searchQuery ? 'rank' : 'm.timestamp';
-            case 'date':
-                return 'm.timestamp';
-            case 'agent':
-                return 'm.agent';
-            default:
-                return 'm.timestamp';
-        }
-    }
-    /**
-     * Generate human-readable query explanation
-     */
-    generateExplanation() {
-        const parts = [];
-        if (this.searchQuery) {
-            parts.push(`Search for "${this.searchQuery}" (${this.exactMatch ? 'exact' : 'fuzzy'})`);
-        }
-        if (this.filters.agent) {
-            parts.push(`Agent: ${this.filters.agent}`);
-        }
-        if (this.filters.dateFrom || this.filters.dateTo) {
-            const from = this.filters.dateFrom?.toISOString().split('T')[0] || 'beginning';
-            const to = this.filters.dateTo?.toISOString().split('T')[0] || 'now';
-            parts.push(`Date range: ${from} to ${to}`);
-        }
-        if (this.filters.tags && this.filters.tags.length > 0) {
-            parts.push(`Tags: ${this.filters.tags.join(', ')}`);
-        }
-        parts.push(`Sort by ${this.options.sortBy} (${this.options.sortOrder})`);
-        parts.push(`Limit: ${this.options.limit}, Offset: ${this.options.offset}`);
-        return parts.join(' | ');
-    }
-    /**
-     * Reset builder to initial state
-     */
-    reset() {
-        this.searchQuery = undefined;
-        this.exactMatch = false;
-        this.filters = {};
-        this.options = {
-            limit: 10,
-            offset: 0,
-            sortBy: 'relevance',
-            sortOrder: 'desc',
-        };
-        return this;
-    }
-    /**
-     * Clone builder with current state
-     */
-    clone() {
-        const cloned = new MemoryQueryBuilder();
-        cloned.searchQuery = this.searchQuery;
-        cloned.exactMatch = this.exactMatch;
-        cloned.filters = { ...this.filters };
-        cloned.options = { ...this.options };
-        return cloned;
-    }
-}
-/**
- * Quick query builders for common patterns
- */
-export class QueryPresets {
-    /**
-     * Search recent memories
-     */
-    static recentMemories(limit = 10) {
-        return new MemoryQueryBuilder()
-            .sortBy('date', 'desc')
-            .limit(limit);
-    }
-    /**
-     * Search by agent
-     */
-    static byAgent(agent, limit = 10) {
-        return new MemoryQueryBuilder()
-            .filterByAgent(agent)
-            .sortBy('date', 'desc')
-            .limit(limit);
-    }
-    /**
-     * Search today's memories
-     */
-    static today(limit = 10) {
-        const startOfDay = new Date();
-        startOfDay.setHours(0, 0, 0, 0);
-        return new MemoryQueryBuilder()
-            .filterByDateRange(startOfDay, new Date())
-            .sortBy('date', 'desc')
-            .limit(limit);
-    }
-    /**
-     * Full-text search with relevance ranking
-     */
-    static search(query, limit = 10) {
-        return new MemoryQueryBuilder()
-            .search(query)
-            .sortBy('relevance', 'desc')
-            .limit(limit);
-    }
-    /**
-     * Search with agent and date filters
-     */
-    static searchAgentDateRange(query, agent, from, to, limit = 10) {
-        return new MemoryQueryBuilder()
-            .search(query)
-            .filterByAgent(agent)
-            .filterByDateRange(from, to)
-            .sortBy('relevance', 'desc')
-            .limit(limit);
-    }
-}
-//# sourceMappingURL=MemoryQueryBuilder.js.map

package/dist/src/services/MemoryQueryBuilder.js.map

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

package/dist/src/services/MetricsCollector.d.ts

@@ -1,183 +0,0 @@
-/**
- * MetricsCollector.ts
- *
- * Real-time metrics collection service for monitoring provider performance,
- * costs, cache efficiency, and rate limiting.
- *
- * Phase 3 Week 3 Day 11-12: Metrics Collection
- */
-import type { ProviderType } from '../types/schemas/provider.schema.js';
-/**
- * Metric event types
- */
-export type MetricType = 'request' | 'cache' | 'rate_limit';
-/**
- * Request metric event
- */
-export interface RequestMetric {
-    type: 'request';
-    provider: ProviderType;
-    model: string;
-    userId?: string;
-    latency: number;
-    success: boolean;
-    errorMessage?: string;
-    inputTokens?: number;
-    outputTokens?: number;
-    totalTokens?: number;
-    cost?: number;
-    metadata?: Record<string, any>;
-    timestamp: number;
-}
-/**
- * Cache metric event
- */
-export interface CacheMetric {
-    type: 'cache';
-    event: 'hit' | 'miss' | 'store';
-    provider?: ProviderType;
-    savedCost?: number;
-    savedTokens?: number;
-    timestamp: number;
-}
-/**
- * Rate limit metric event
- */
-export interface RateLimitMetric {
-    type: 'rate_limit';
-    event: 'allowed' | 'denied';
-    rateLimitType: 'user' | 'provider' | 'ip' | 'global';
-    key: string;
-    remaining?: number;
-    timestamp: number;
-}
-/**
- * Union type for all metrics
- */
-export type Metric = RequestMetric | CacheMetric | RateLimitMetric;
-/**
- * Metric query filters
- */
-export interface MetricQuery {
-    startTime?: number;
-    endTime?: number;
-    provider?: ProviderType;
-    model?: string;
-    userId?: string;
-    metricType?: MetricType;
-    limit?: number;
-    offset?: number;
-}
-/**
- * Aggregated metrics result
- */
-export interface AggregatedMetrics {
-    totalRequests: number;
-    successfulRequests: number;
-    failedRequests: number;
-    successRate: number;
-    avgLatency: number;
-    minLatency: number;
-    maxLatency: number;
-    p50Latency: number;
-    p95Latency: number;
-    p99Latency: number;
-    totalCost: number;
-    avgCostPerRequest: number;
-    totalTokens: number;
-    cacheHits: number;
-    cacheMisses: number;
-    cacheHitRate: number;
-    cacheSavedCost: number;
-    rateLimitAllowed: number;
-    rateLimitDenied: number;
-}
-/**
- * Provider health status
- */
-export interface ProviderHealth {
-    provider: ProviderType;
-    status: 'healthy' | 'degraded' | 'down';
-    latency: number;
-    p95Latency: number;
-    successRate: number;
-    errorRate: number;
-    requestCount: number;
-    requestsLastHour: number;
-    cost: number;
-    costToday: number;
-    lastRequest: number;
-}
-/**
- * Time series bucket data
- */
-export interface TimeSeriesBucket {
-    bucket: number;
-    count: number;
-    avgLatency: number;
-    totalCost: number;
-    successful: number;
-}
-/**
- * MetricsCollector - Real-time metrics collection and querying
- *
- * Features:
- * - Async metric recording (non-blocking)
- * - Batch writes for performance
- * - Time-series queries with filters
- * - Aggregated statistics
- * - Provider health monitoring
- */
-export declare class MetricsCollector {
-    private db;
-    private writeQueue;
-    private readonly batchSize;
-    private readonly flushInterval;
-    private flushTimer?;
-    constructor();
-    /**
-     * Record a metric event (async, non-blocking)
-     */
-    record(metric: Metric): Promise<void>;
-    /**
-     * Start periodic flush timer
-     */
-    private startFlushTimer;
-    /**
-     * Flush write queue to database
-     */
-    private flush;
-    /**
-     * Query raw metrics with filters
-     */
-    query(filters?: MetricQuery): Promise<Metric[]>;
-    /**
-     * Get aggregated metrics for a time range
-     */
-    getAggregated(filters?: MetricQuery): Promise<AggregatedMetrics>;
-    /**
-     * Get provider health status
-     */
-    getProviderHealth(): Promise<ProviderHealth[]>;
-    /**
-     * Get metrics grouped by time buckets
-     */
-    getTimeSeries(bucketSize: '1min' | '5min' | '1hour' | '1day', filters?: MetricQuery): Promise<TimeSeriesBucket[]>;
-    /**
-     * Clean up old metrics (retention policy)
-     */
-    cleanup(retentionDays?: number): Promise<number>;
-    /**
-     * Get total metric count
-     */
-    getCount(filters?: MetricQuery): Promise<number>;
-    /**
-     * Stop flush timer (cleanup)
-     */
-    destroy(): void;
-    /**
-     * Convert database row to Metric object
-     */
-    private rowToMetric;
-}
-//# sourceMappingURL=MetricsCollector.d.ts.map

package/dist/src/services/MetricsCollector.d.ts.map

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