@robota-sdk/agent-core 3.0.0-beta.1

package/dist/plugins/performance/storages/memory-storage.js

@@ -0,0 +1,69 @@
+export class MemoryPerformanceStorage {
+    entries = [];
+    maxEntries;
+    constructor(maxEntries = 5000) {
+        this.maxEntries = maxEntries;
+    }
+    async save(entry) {
+        if (this.entries.length >= this.maxEntries) {
+            this.entries = this.entries.slice(-this.maxEntries + 1);
+        }
+        this.entries.push({ ...entry });
+    }
+    async getMetrics(operation, timeRange) {
+        let filtered = [...this.entries];
+        if (operation) {
+            filtered = filtered.filter(entry => entry.operation === operation);
+        }
+        if (timeRange) {
+            filtered = filtered.filter(entry => entry.timestamp >= timeRange.start && entry.timestamp <= timeRange.end);
+        }
+        return filtered;
+    }
+    async getAggregatedStats(timeRange) {
+        const metrics = await this.getMetrics(undefined, timeRange);
+        if (metrics.length === 0) {
+            return {
+                totalOperations: 0,
+                averageDuration: 0,
+                minDuration: 0,
+                maxDuration: 0,
+                successRate: 0,
+                errorRate: 0,
+                operationStats: {},
+                timeRangeStats: {
+                    startTime: timeRange?.start || new Date(),
+                    endTime: timeRange?.end || new Date(),
+                    period: 'empty'
+                }
+            };
+        }
+        const durations = metrics.map(m => m.duration);
+        const successCount = metrics.filter(m => m.success).length;
+        const errorCount = metrics.reduce((sum, m) => sum + m.errorCount, 0);
+        return {
+            totalOperations: metrics.length,
+            averageDuration: durations.reduce((sum, d) => sum + d, 0) / durations.length,
+            minDuration: Math.min(...durations),
+            maxDuration: Math.max(...durations),
+            successRate: successCount / metrics.length,
+            errorRate: errorCount / metrics.length,
+            operationStats: {},
+            timeRangeStats: {
+                startTime: timeRange?.start || metrics[0]?.timestamp || new Date(),
+                endTime: timeRange?.end || metrics[metrics.length - 1]?.timestamp || new Date(),
+                period: 'memory'
+            }
+        };
+    }
+    async clear() {
+        this.entries = [];
+    }
+    async flush() {
+        // Memory storage doesn't need flushing
+    }
+    async close() {
+        // Memory storage doesn't need closing
+    }
+}
+//# sourceMappingURL=memory-storage.js.map

package/dist/plugins/performance/storages/memory-storage.js.map

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

package/dist/plugins/performance/types.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Performance monitoring strategy types
+ */
+export type TPerformanceMonitoringStrategy = 'memory' | 'file' | 'prometheus' | 'remote' | 'silent';
+/**
+ * Performance metrics entry
+ */
+export interface IPerformanceMetrics {
+    executionId?: string;
+    conversationId?: string;
+    timestamp: Date;
+    operation: string;
+    duration: number;
+    memoryUsage?: {
+        used: number;
+        free: number;
+        total: number;
+        heap: {
+            used: number;
+            total: number;
+        };
+    };
+    cpuUsage?: {
+        user: number;
+        system: number;
+        percent: number;
+    };
+    networkStats?: {
+        requests: number;
+        bytesReceived: number;
+        bytesSent: number;
+        latency: number;
+    };
+    errorCount: number;
+    success: boolean;
+    metadata?: Record<string, string | number | boolean | Date>;
+}
+/**
+ * Aggregated performance statistics
+ */
+export interface IAggregatedPerformanceStats {
+    totalOperations: number;
+    averageDuration: number;
+    minDuration: number;
+    maxDuration: number;
+    successRate: number;
+    errorRate: number;
+    memoryStats?: {
+        averageUsed: number;
+        maxUsed: number;
+        averageHeapUsed: number;
+        maxHeapUsed: number;
+    };
+    cpuStats?: {
+        averagePercent: number;
+        maxPercent: number;
+    };
+    networkStats?: {
+        totalRequests: number;
+        totalBytesReceived: number;
+        totalBytesSent: number;
+        averageLatency: number;
+    };
+    operationStats: Record<string, {
+        count: number;
+        averageDuration: number;
+        successRate: number;
+        errorCount: number;
+    }>;
+    timeRangeStats: {
+        startTime: Date;
+        endTime: Date;
+        period: string;
+    };
+}
+import type { IPluginOptions, IPluginStats } from '../../abstracts/abstract-plugin';
+/**
+ * Configuration options for performance plugin
+ */
+export interface IPerformancePluginOptions extends IPluginOptions {
+    /** Performance monitoring strategy to use */
+    strategy: TPerformanceMonitoringStrategy;
+    /** File path for file strategy */
+    filePath?: string;
+    /** Remote endpoint for remote strategy */
+    remoteEndpoint?: string;
+    /** Prometheus endpoint for prometheus strategy */
+    prometheusEndpoint?: string;
+    /** Headers for remote monitoring */
+    remoteHeaders?: Record<string, string>;
+    /** Maximum number of performance entries to keep in memory */
+    maxEntries?: number;
+    /** Whether to monitor memory usage */
+    monitorMemory?: boolean;
+    /** Whether to monitor CPU usage */
+    monitorCPU?: boolean;
+    /** Whether to monitor network stats */
+    monitorNetwork?: boolean;
+    /** Batch size for remote reporting */
+    batchSize?: number;
+    /** Flush interval for batched reporting in milliseconds */
+    flushInterval?: number;
+    /** Whether to aggregate statistics */
+    aggregateStats?: boolean;
+    /** Aggregation interval in milliseconds */
+    aggregationInterval?: number;
+    /** Performance threshold in milliseconds to log warnings */
+    performanceThreshold?: number;
+}
+/**
+ * Performance storage interface
+ */
+export interface IPerformanceStorage {
+    save(entry: IPerformanceMetrics): Promise<void>;
+    getMetrics(operation?: string, timeRange?: {
+        start: Date;
+        end: Date;
+    }): Promise<IPerformanceMetrics[]>;
+    getAggregatedStats(timeRange?: {
+        start: Date;
+        end: Date;
+    }): Promise<IAggregatedPerformanceStats>;
+    clear(): Promise<void>;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+}
+/**
+ * System metrics collector interface
+ */
+export interface ISystemMetricsCollector {
+    getMemoryUsage(): Promise<IPerformanceMetrics['memoryUsage']>;
+    getCPUUsage(): Promise<IPerformanceMetrics['cpuUsage']>;
+    getNetworkStats(): Promise<IPerformanceMetrics['networkStats']>;
+}
+/**
+ * Performance plugin statistics
+ */
+export interface IPerformancePluginStats extends IPluginStats {
+    /** Total number of metrics recorded */
+    metricsRecorded: number;
+    /** Number of performance threshold violations */
+    thresholdViolations: number;
+    /** Current monitoring strategy */
+    strategy: TPerformanceMonitoringStrategy;
+    /** Monitoring status */
+    monitoring: {
+        memory: boolean;
+        cpu: boolean;
+        network: boolean;
+    };
+    /** Last metrics collection timestamp */
+    lastCollectionTime?: Date;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/performance/types.d.ts.map

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

package/dist/plugins/performance/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugins/performance/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/plugins/performance/types.ts"],"names":[],"mappings":""}

package/dist/plugins/usage/aggregate-usage-stats.d.ts

@@ -0,0 +1,12 @@
+import type { IAggregatedUsageStats, IUsageStats } from './types';
+interface IUsageTimeRange {
+    start: Date;
+    end: Date;
+}
+/**
+ * Aggregate usage statistics into a single summary object.
+ * This is a shared SSOT utility (composition over inheritance).
+ */
+export declare function aggregateUsageStats(stats: readonly IUsageStats[], timeRange?: IUsageTimeRange): IAggregatedUsageStats;
+export {};
+//# sourceMappingURL=aggregate-usage-stats.d.ts.map

package/dist/plugins/usage/aggregate-usage-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate-usage-stats.d.ts","sourceRoot":"","sources":["../../../src/plugins/usage/aggregate-usage-stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAElE,UAAU,eAAe;IACrB,KAAK,EAAE,IAAI,CAAC;IACZ,GAAG,EAAE,IAAI,CAAC;CACb;AA6CD;;;GAGG;AACH,wBAAgB,mBAAmB,CAC/B,KAAK,EAAE,SAAS,WAAW,EAAE,EAC7B,SAAS,CAAC,EAAE,eAAe,GAC5B,qBAAqB,CA4EvB"}

package/dist/plugins/usage/aggregate-usage-stats.js

@@ -0,0 +1,115 @@
+function determineUsagePeriod(timeRange) {
+    if (!timeRange)
+        return 'all';
+    const diff = timeRange.end.getTime() - timeRange.start.getTime();
+    const hours = diff / (1000 * 60 * 60);
+    if (hours <= 1)
+        return 'hour';
+    if (hours <= 24)
+        return 'day';
+    if (hours <= 168)
+        return 'week'; // 24 * 7
+    return 'month';
+}
+function resolveTimeRangeStats(stats, timeRange) {
+    if (timeRange) {
+        return {
+            startTime: timeRange.start,
+            endTime: timeRange.end,
+            period: determineUsagePeriod(timeRange)
+        };
+    }
+    if (stats.length > 0) {
+        const first = stats[0]?.timestamp;
+        const last = stats[stats.length - 1]?.timestamp;
+        const now = new Date();
+        return {
+            startTime: first ?? now,
+            endTime: last ?? now,
+            period: determineUsagePeriod(undefined)
+        };
+    }
+    const now = new Date();
+    return {
+        startTime: now,
+        endTime: now,
+        period: determineUsagePeriod(undefined)
+    };
+}
+/**
+ * Aggregate usage statistics into a single summary object.
+ * This is a shared SSOT utility (composition over inheritance).
+ */
+export function aggregateUsageStats(stats, timeRange) {
+    const timeRangeStats = resolveTimeRangeStats(stats, timeRange);
+    const aggregated = {
+        totalRequests: stats.length,
+        totalTokens: stats.reduce((sum, entry) => sum + entry.tokensUsed.total, 0),
+        totalCost: stats.reduce((sum, entry) => sum + (entry.cost?.total ?? 0), 0),
+        totalDuration: stats.reduce((sum, entry) => sum + entry.duration, 0),
+        successRate: stats.length > 0 ? stats.filter((entry) => entry.success).length / stats.length : 0,
+        providerStats: {},
+        modelStats: {},
+        toolStats: {},
+        timeRangeStats
+    };
+    // Aggregate by provider
+    for (const entry of stats) {
+        if (!aggregated.providerStats[entry.provider]) {
+            aggregated.providerStats[entry.provider] = {
+                requests: 0,
+                tokens: 0,
+                cost: 0,
+                duration: 0
+            };
+        }
+        const providerStat = aggregated.providerStats[entry.provider];
+        if (providerStat) {
+            providerStat.requests += entry.requestCount;
+            providerStat.tokens += entry.tokensUsed.total;
+            providerStat.cost += entry.cost?.total ?? 0;
+            providerStat.duration += entry.duration;
+        }
+    }
+    // Aggregate by model
+    for (const entry of stats) {
+        if (!aggregated.modelStats[entry.model]) {
+            aggregated.modelStats[entry.model] = {
+                requests: 0,
+                tokens: 0,
+                cost: 0,
+                duration: 0
+            };
+        }
+        const modelStat = aggregated.modelStats[entry.model];
+        if (modelStat) {
+            modelStat.requests += entry.requestCount;
+            modelStat.tokens += entry.tokensUsed.total;
+            modelStat.cost += entry.cost?.total ?? 0;
+            modelStat.duration += entry.duration;
+        }
+    }
+    // Aggregate by tools
+    for (const entry of stats) {
+        const toolsUsed = entry.toolsUsed;
+        if (!toolsUsed)
+            continue;
+        for (const tool of toolsUsed) {
+            if (!aggregated.toolStats[tool]) {
+                aggregated.toolStats[tool] = {
+                    usageCount: 0,
+                    successCount: 0,
+                    totalDuration: 0
+                };
+            }
+            const toolStat = aggregated.toolStats[tool];
+            toolStat.usageCount += 1;
+            if (entry.success) {
+                toolStat.successCount += 1;
+            }
+            toolStat.totalDuration += entry.duration;
+        }
+    }
+    return aggregated;
+}
+//# sourceMappingURL=aggregate-usage-stats.js.map

package/dist/plugins/usage/aggregate-usage-stats.js.map

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

package/dist/plugins/usage/index.d.ts

@@ -0,0 +1,5 @@
+export { UsagePlugin } from './usage-plugin';
+export { aggregateUsageStats } from './aggregate-usage-stats';
+export type { TUsageTrackingStrategy, IUsageStats, IAggregatedUsageStats, IUsagePluginOptions, IUsageStorage, IUsagePluginStats } from './types';
+export { MemoryUsageStorage, FileUsageStorage, RemoteUsageStorage, SilentUsageStorage } from './storages/index';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/usage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/usage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,YAAY,EACR,sBAAsB,EACtB,WAAW,EACX,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACpB,MAAM,SAAS,CAAC;AACjB,OAAO,EACH,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EACrB,MAAM,kBAAkB,CAAC"}

package/dist/plugins/usage/index.js

@@ -0,0 +1,4 @@
+export { UsagePlugin } from './usage-plugin';
+export { aggregateUsageStats } from './aggregate-usage-stats';
+export { MemoryUsageStorage, FileUsageStorage, RemoteUsageStorage, SilentUsageStorage } from './storages/index';
+//# sourceMappingURL=index.js.map

package/dist/plugins/usage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/usage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAS9D,OAAO,EACH,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EACrB,MAAM,kBAAkB,CAAC"}

package/dist/plugins/usage/storages/file-storage.d.ts

@@ -0,0 +1,22 @@
+import { IUsageStorage, IUsageStats, IAggregatedUsageStats } from '../types';
+/**
+ * File storage implementation for usage statistics
+ */
+export declare class FileUsageStorage implements IUsageStorage {
+    private filePath;
+    private logger;
+    constructor(filePath: string);
+    save(entry: IUsageStats): Promise<void>;
+    getStats(conversationId?: string, timeRange?: {
+        start: Date;
+        end: Date;
+    }): Promise<IUsageStats[]>;
+    getAggregatedStats(timeRange?: {
+        start: Date;
+        end: Date;
+    }): Promise<IAggregatedUsageStats>;
+    clear(): Promise<void>;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=file-storage.d.ts.map

package/dist/plugins/usage/storages/file-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-storage.d.ts","sourceRoot":"","sources":["../../../../src/plugins/usage/storages/file-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAK7E;;GAEG;AACH,qBAAa,gBAAiB,YAAW,aAAa;IAClD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAU;gBAEZ,QAAQ,EAAE,MAAM;IAKtB,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBvC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,IAAI,CAAC;QAAC,GAAG,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAkBjG,kBAAkB,CAAC,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,IAAI,CAAC;QAAC,GAAG,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAY1F,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAetB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IActB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAa/B"}

package/dist/plugins/usage/storages/file-storage.js

@@ -0,0 +1,111 @@
+import { createLogger } from '../../../utils/logger';
+import { StorageError } from '../../../utils/errors';
+import { aggregateUsageStats } from '../aggregate-usage-stats';
+/**
+ * File storage implementation for usage statistics
+ */
+export class FileUsageStorage {
+    filePath;
+    logger;
+    constructor(filePath) {
+        this.filePath = filePath;
+        this.logger = createLogger('FileUsageStorage');
+    }
+    async save(entry) {
+        try {
+            // File operations would be implemented here
+            // This is a placeholder for actual file system operations
+            this.logger.warn('File usage storage not fully implemented yet', {
+                filePath: this.filePath,
+                entry: {
+                    timestamp: entry.timestamp.toISOString(),
+                    provider: entry.provider,
+                    model: entry.model,
+                    tokens: entry.tokensUsed.total,
+                    cost: entry.cost?.total,
+                    success: entry.success
+                }
+            });
+        }
+        catch (error) {
+            throw new StorageError('Failed to save usage stats to file', {
+                filePath: this.filePath,
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+    async getStats(conversationId, timeRange) {
+        try {
+            // File operations would be implemented here
+            this.logger.warn('File usage storage not fully implemented yet', {
+                filePath: this.filePath,
+                conversationId,
+                timeRange
+            });
+            return [];
+        }
+        catch (error) {
+            throw new StorageError('Failed to load usage stats from file', {
+                filePath: this.filePath,
+                conversationId: conversationId || 'all',
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+    async getAggregatedStats(timeRange) {
+        try {
+            const stats = await this.getStats(undefined, timeRange);
+            return aggregateUsageStats(stats, timeRange);
+        }
+        catch (error) {
+            throw new StorageError('Failed to get aggregated usage stats from file', {
+                filePath: this.filePath,
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+    async clear() {
+        try {
+            // File operations would be implemented here
+            this.logger.warn('File usage storage not fully implemented yet', {
+                filePath: this.filePath,
+                operation: 'clear'
+            });
+        }
+        catch (error) {
+            throw new StorageError('Failed to clear usage stats from file', {
+                filePath: this.filePath,
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+    async flush() {
+        try {
+            // File flushing would be implemented here
+            this.logger.warn('File usage storage flush not fully implemented yet', {
+                filePath: this.filePath
+            });
+        }
+        catch (error) {
+            throw new StorageError('Failed to flush usage stats to file', {
+                filePath: this.filePath,
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+    async close() {
+        try {
+            // File closing would be implemented here
+            this.logger.warn('File usage storage close not fully implemented yet', {
+                filePath: this.filePath
+            });
+        }
+        catch (error) {
+            throw new StorageError('Failed to close usage stats file', {
+                filePath: this.filePath,
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+}
+//# sourceMappingURL=file-storage.js.map

package/dist/plugins/usage/storages/file-storage.js.map

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

package/dist/plugins/usage/storages/index.d.ts

@@ -0,0 +1,5 @@
+export { MemoryUsageStorage } from './memory-storage';
+export { FileUsageStorage } from './file-storage';
+export { RemoteUsageStorage } from './remote-storage';
+export { SilentUsageStorage } from './silent-storage';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/usage/storages/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/usage/storages/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/plugins/usage/storages/index.js

@@ -0,0 +1,5 @@
+export { MemoryUsageStorage } from './memory-storage';
+export { FileUsageStorage } from './file-storage';
+export { RemoteUsageStorage } from './remote-storage';
+export { SilentUsageStorage } from './silent-storage';
+//# sourceMappingURL=index.js.map

package/dist/plugins/usage/storages/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/plugins/usage/storages/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/plugins/usage/storages/memory-storage.d.ts

@@ -0,0 +1,22 @@
+import { IUsageStorage, IUsageStats, IAggregatedUsageStats } from '../types';
+/**
+ * Memory storage implementation for usage statistics
+ */
+export declare class MemoryUsageStorage implements IUsageStorage {
+    private entries;
+    private maxEntries;
+    constructor(maxEntries?: number);
+    save(entry: IUsageStats): Promise<void>;
+    getStats(conversationId?: string, timeRange?: {
+        start: Date;
+        end: Date;
+    }): Promise<IUsageStats[]>;
+    getAggregatedStats(timeRange?: {
+        start: Date;
+        end: Date;
+    }): Promise<IAggregatedUsageStats>;
+    clear(): Promise<void>;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=memory-storage.d.ts.map

package/dist/plugins/usage/storages/memory-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-storage.d.ts","sourceRoot":"","sources":["../../../../src/plugins/usage/storages/memory-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAG7E;;GAEG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IACpD,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,GAAE,MAAc;IAIhC,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IASvC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,IAAI,CAAC;QAAC,GAAG,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAgBjG,kBAAkB,CAAC,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,IAAI,CAAC;QAAC,GAAG,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAK1F,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK/B"}

package/dist/plugins/usage/storages/memory-storage.js

@@ -0,0 +1,42 @@
+import { aggregateUsageStats } from '../aggregate-usage-stats';
+/**
+ * Memory storage implementation for usage statistics
+ */
+export class MemoryUsageStorage {
+    entries = [];
+    maxEntries;
+    constructor(maxEntries = 10000) {
+        this.maxEntries = maxEntries;
+    }
+    async save(entry) {
+        // Remove oldest entries if limit exceeded
+        if (this.entries.length >= this.maxEntries) {
+            this.entries = this.entries.slice(-this.maxEntries + 1);
+        }
+        this.entries.push({ ...entry });
+    }
+    async getStats(conversationId, timeRange) {
+        let filtered = [...this.entries];
+        if (conversationId) {
+            filtered = filtered.filter(entry => entry.conversationId === conversationId);
+        }
+        if (timeRange) {
+            filtered = filtered.filter(entry => entry.timestamp >= timeRange.start && entry.timestamp <= timeRange.end);
+        }
+        return filtered;
+    }
+    async getAggregatedStats(timeRange) {
+        const stats = await this.getStats(undefined, timeRange);
+        return aggregateUsageStats(stats, timeRange);
+    }
+    async clear() {
+        this.entries = [];
+    }
+    async flush() {
+        // Memory storage doesn't need flushing
+    }
+    async close() {
+        // Memory storage doesn't need closing
+    }
+}
+//# sourceMappingURL=memory-storage.js.map

package/dist/plugins/usage/storages/memory-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-storage.js","sourceRoot":"","sources":["../../../../src/plugins/usage/storages/memory-storage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACnB,OAAO,GAAkB,EAAE,CAAC;IAC5B,UAAU,CAAS;IAE3B,YAAY,aAAqB,KAAK;QAClC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAkB;QACzB,0CAA0C;QAC1C,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACzC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,cAAuB,EAAE,SAAsC;QAC1E,IAAI,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAEjC,IAAI,cAAc,EAAE,CAAC;YACjB,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,cAAc,KAAK,cAAc,CAAC,CAAC;QACjF,CAAC;QAED,IAAI,SAAS,EAAE,CAAC;YACZ,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC/B,KAAK,CAAC,SAAS,IAAI,SAAS,CAAC,KAAK,IAAI,KAAK,CAAC,SAAS,IAAI,SAAS,CAAC,GAAG,CACzE,CAAC;QACN,CAAC;QAED,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,SAAsC;QAC3D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACxD,OAAO,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,KAAK;QACP,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,KAAK;QACP,uCAAuC;IAC3C,CAAC;IAED,KAAK,CAAC,KAAK;QACP,sCAAsC;IAC1C,CAAC;CAGJ"}