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

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

@@ -0,0 +1,26 @@
+import { IUsageStorage, IUsageStats, IAggregatedUsageStats } from '../types';
+/**
+ * Remote storage implementation for usage statistics with batching
+ */
+export declare class RemoteUsageStorage implements IUsageStorage {
+    private apiUrl;
+    private batchSize;
+    private flushInterval;
+    private batch;
+    private timer;
+    private logger;
+    constructor(apiUrl: string, _apiKey: string, _timeout: number, _headers?: Record<string, string>, batchSize?: number, flushInterval?: 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=remote-storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remote-storage.d.ts","sourceRoot":"","sources":["../../../../src/plugins/usage/storages/remote-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAO7E;;GAEG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IACpD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,MAAM,CAAU;gBAGpB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACrC,SAAS,GAAE,MAAW,EACtB,aAAa,GAAE,MAAc;IAY3B,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvC,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;IAmBjG,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;IAiCtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAM/B"}

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

@@ -0,0 +1,115 @@
+import { createLogger } from '../../../utils/logger';
+import { StorageError } from '../../../utils/errors';
+import { aggregateUsageStats } from '../aggregate-usage-stats';
+import { startPeriodicTask, stopPeriodicTask } from '../../../utils/periodic-task';
+/**
+ * Remote storage implementation for usage statistics with batching
+ */
+export class RemoteUsageStorage {
+    apiUrl;
+    batchSize;
+    flushInterval;
+    batch = [];
+    timer = null;
+    logger;
+    constructor(apiUrl, _apiKey, _timeout, _headers = {}, batchSize = 50, flushInterval = 60000 // 1 minute
+    ) {
+        this.apiUrl = apiUrl;
+        this.batchSize = batchSize;
+        this.flushInterval = flushInterval;
+        this.logger = createLogger('RemoteUsageStorage');
+        this.timer = startPeriodicTask(this.logger, { name: 'RemoteUsageStorage.flush', intervalMs: this.flushInterval }, async () => {
+            await this.flush();
+        });
+    }
+    async save(entry) {
+        this.batch.push(entry);
+        if (this.batch.length >= this.batchSize) {
+            await this.flush();
+        }
+    }
+    async getStats(conversationId, timeRange) {
+        try {
+            // Remote API call would be implemented here
+            this.logger.warn('Remote usage storage not fully implemented yet', {
+                endpoint: this.apiUrl,
+                operation: 'getStats',
+                conversationId,
+                timeRange
+            });
+            return [];
+        }
+        catch (error) {
+            throw new StorageError('Failed to get usage stats from remote endpoint', {
+                endpoint: this.apiUrl,
+                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 remote endpoint', {
+                endpoint: this.apiUrl,
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+    async clear() {
+        try {
+            // Remote API call would be implemented here
+            this.logger.warn('Remote usage storage not fully implemented yet', {
+                endpoint: this.apiUrl,
+                operation: 'clear'
+            });
+        }
+        catch (error) {
+            throw new StorageError('Failed to clear usage stats from remote endpoint', {
+                endpoint: this.apiUrl,
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+    async flush() {
+        if (this.batch.length === 0)
+            return;
+        const statsToSend = [...this.batch];
+        this.batch = [];
+        try {
+            // Remote API call would be implemented here
+            // This is a placeholder for actual HTTP requests
+            this.logger.warn('Remote usage storage not fully implemented yet', {
+                endpoint: this.apiUrl,
+                operation: 'flush',
+                batchSize: statsToSend.length,
+                sample: statsToSend.slice(0, 3).map(stat => ({
+                    timestamp: stat.timestamp.toISOString(),
+                    provider: stat.provider,
+                    model: stat.model,
+                    tokens: stat.tokensUsed.total,
+                    cost: stat.cost?.total,
+                    success: stat.success
+                }))
+            });
+        }
+        catch (error) {
+            // Re-add failed batch to the beginning of current batch
+            this.batch = [...statsToSend, ...this.batch];
+            throw new StorageError('Failed to send usage stats to remote endpoint', {
+                endpoint: this.apiUrl,
+                batchSize: statsToSend.length,
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+    async close() {
+        stopPeriodicTask(this.timer);
+        this.timer = null;
+        await this.flush();
+    }
+}
+//# sourceMappingURL=remote-storage.js.map

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

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

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

@@ -0,0 +1,19 @@
+import { IUsageStorage, IUsageStats, IAggregatedUsageStats } from '../types';
+/**
+ * Silent storage implementation for usage statistics (no-op)
+ */
+export declare class SilentUsageStorage implements IUsageStorage {
+    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=silent-storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"silent-storage.d.ts","sourceRoot":"","sources":["../../../../src/plugins/usage/storages/silent-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAG7E;;GAEG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IAC9C,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE;QAAE,KAAK,EAAE,IAAI,CAAC;QAAC,GAAG,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAKnG,kBAAkB,CAAC,UAAU,CAAC,EAAE;QAAE,KAAK,EAAE,IAAI,CAAC;QAAC,GAAG,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI3F,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}

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

@@ -0,0 +1,26 @@
+import { aggregateUsageStats } from '../aggregate-usage-stats';
+/**
+ * Silent storage implementation for usage statistics (no-op)
+ */
+export class SilentUsageStorage {
+    async save(_entry) {
+        // Silent mode - do nothing
+    }
+    async getStats(_conversationId, _timeRange) {
+        // Silent mode - return empty array
+        return [];
+    }
+    async getAggregatedStats(_timeRange) {
+        return aggregateUsageStats([], _timeRange);
+    }
+    async clear() {
+        // Silent mode - do nothing
+    }
+    async flush() {
+        // Silent mode - do nothing
+    }
+    async close() {
+        // Silent mode - do nothing
+    }
+}
+//# sourceMappingURL=silent-storage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"silent-storage.js","sourceRoot":"","sources":["../../../../src/plugins/usage/storages/silent-storage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAC3B,KAAK,CAAC,IAAI,CAAC,MAAmB;QAC1B,2BAA2B;IAC/B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,eAAwB,EAAE,UAAuC;QAC5E,mCAAmC;QACnC,OAAO,EAAE,CAAC;IACd,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,UAAuC;QAC5D,OAAO,mBAAmB,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,KAAK;QACP,2BAA2B;IAC/B,CAAC;IAED,KAAK,CAAC,KAAK;QACP,2BAA2B;IAC/B,CAAC;IAED,KAAK,CAAC,KAAK;QACP,2BAA2B;IAC/B,CAAC;CACJ"}

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

@@ -0,0 +1,127 @@
+/**
+ * Usage tracking strategy types
+ */
+export type TUsageTrackingStrategy = 'memory' | 'file' | 'remote' | 'silent';
+/**
+ * Usage statistics entry
+ */
+export interface IUsageStats {
+    conversationId?: string;
+    executionId?: string;
+    timestamp: Date;
+    provider: string;
+    model: string;
+    tokensUsed: {
+        input: number;
+        output: number;
+        total: number;
+    };
+    cost?: {
+        input: number;
+        output: number;
+        total: number;
+    };
+    requestCount: number;
+    duration: number;
+    success: boolean;
+    toolsUsed?: string[];
+    metadata?: Record<string, string | number | boolean | Date>;
+}
+/**
+ * Aggregated usage statistics
+ */
+export interface IAggregatedUsageStats {
+    totalRequests: number;
+    totalTokens: number;
+    totalCost: number;
+    totalDuration: number;
+    successRate: number;
+    providerStats: Record<string, {
+        requests: number;
+        tokens: number;
+        cost: number;
+        duration: number;
+    }>;
+    modelStats: Record<string, {
+        requests: number;
+        tokens: number;
+        cost: number;
+        duration: number;
+    }>;
+    toolStats: Record<string, {
+        usageCount: number;
+        successCount: number;
+        totalDuration: number;
+    }>;
+    timeRangeStats: {
+        startTime: Date;
+        endTime: Date;
+        period: string;
+    };
+}
+import type { IPluginOptions, IPluginStats } from '../../abstracts/abstract-plugin';
+/**
+ * Configuration options for usage plugin
+ */
+export interface IUsagePluginOptions extends IPluginOptions {
+    /** Usage tracking strategy to use */
+    strategy: TUsageTrackingStrategy;
+    /** File path for file strategy */
+    filePath?: string;
+    /** Remote endpoint for remote strategy */
+    remoteEndpoint?: string;
+    /** Headers for remote logging */
+    remoteHeaders?: Record<string, string>;
+    /** Maximum number of usage entries to keep in memory */
+    maxEntries?: number;
+    /** Whether to track token costs */
+    trackCosts?: boolean;
+    /** Cost per token rates for different models */
+    costRates?: Record<string, {
+        input: number;
+        output: number;
+    }>;
+    /** 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;
+}
+/**
+ * Usage storage interface
+ */
+export interface IUsageStorage {
+    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>;
+}
+/**
+ * Usage plugin statistics
+ */
+export interface IUsagePluginStats extends IPluginStats {
+    /** Total number of usage entries tracked */
+    entriesTracked: number;
+    /** Total tokens tracked */
+    totalTokens: number;
+    /** Total cost tracked */
+    totalCost: number;
+    /** Current tracking strategy */
+    strategy: TUsageTrackingStrategy;
+    /** Last tracking timestamp */
+    lastTrackTime?: Date;
+    /** Number of failed tracking attempts */
+    failedTracking: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/plugins/usage/types.js

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

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

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

package/dist/plugins/usage/usage-plugin.d.ts

@@ -0,0 +1,67 @@
+import { AbstractPlugin } from '../../abstracts/abstract-plugin';
+import type { IEventEmitterEventData, TEventName } from '../event-emitter-plugin';
+import { IUsageStats, IAggregatedUsageStats, IUsagePluginOptions, IUsagePluginStats } from './types';
+/**
+ * Plugin for tracking usage statistics
+ * Collects and stores usage data including tokens, costs, performance metrics
+ */
+export declare class UsagePlugin extends AbstractPlugin<IUsagePluginOptions, IUsagePluginStats> {
+    name: string;
+    version: string;
+    private storage;
+    private pluginOptions;
+    private logger;
+    private aggregationTimer?;
+    constructor(options: IUsagePluginOptions);
+    /**
+     * Handle module events for usage tracking
+     */
+    onModuleEvent(eventName: TEventName, eventData: IEventEmitterEventData): Promise<void>;
+    /**
+     * Record usage statistics
+     */
+    recordUsage(usage: Omit<IUsageStats, 'timestamp' | 'cost'>): Promise<void>;
+    /**
+     * Get usage statistics
+     */
+    getUsageStats(conversationId?: string, timeRange?: {
+        start: Date;
+        end: Date;
+    }): Promise<IUsageStats[]>;
+    /**
+     * Get aggregated usage statistics
+     */
+    getAggregatedStats(timeRange?: {
+        start: Date;
+        end: Date;
+    }): Promise<IAggregatedUsageStats>;
+    /**
+     * Clear all usage statistics
+     */
+    clearStats(): Promise<void>;
+    /**
+     * Flush pending statistics
+     */
+    flush(): Promise<void>;
+    /**
+     * Cleanup resources
+     */
+    destroy(): Promise<void>;
+    /**
+     * Calculate cost based on token usage and model rates
+     */
+    private calculateCost;
+    /**
+     * Validate plugin options
+     */
+    private validateOptions;
+    /**
+     * Create storage instance based on strategy
+     */
+    private createStorage;
+    /**
+     * Setup periodic aggregation
+     */
+    private setupAggregation;
+}
+//# sourceMappingURL=usage-plugin.d.ts.map

package/dist/plugins/usage/usage-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/usage/usage-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAkC,MAAM,iCAAiC,CAAC;AAGjG,OAAO,KAAK,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAIlF,OAAO,EACH,WAAW,EACX,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EAEpB,MAAM,SAAS,CAAC;AAQjB;;;GAGG;AACH,qBAAa,WAAY,SAAQ,cAAc,CAAC,mBAAmB,EAAE,iBAAiB,CAAC;IACnF,IAAI,SAAiB;IACrB,OAAO,SAAW;IAElB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,aAAa,CAAuH;IAC5I,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,gBAAgB,CAAC,CAAW;gBAExB,OAAO,EAAE,mBAAmB;IA+CxC;;OAEG;IACY,aAAa,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqErG;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BhF;;OAEG;IACG,aAAa,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;IAY5G;;OAEG;IACG,kBAAkB,CAAC,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,IAAI,CAAC;QAAC,GAAG,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAWhG;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAWjC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAe9B;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAqCvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAsBrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAe3B"}