@codemieai/code 0.0.11 → 0.0.12

package/dist/analytics/index.js

@@ -0,0 +1,322 @@
+/**
+ * Analytics system for CodeMie CLI
+ * Provides unified analytics tracking across all agents
+ */
+import { EventCollector } from './collector.js';
+import { AnalyticsWriter } from './writer.js';
+import { SessionManager } from './session.js';
+import { loadAnalyticsConfig } from './config.js';
+import { getInstallationId } from '../utils/installation-id.js';
+/**
+ * Main analytics class
+ * Handles event tracking, buffering, and persistence
+ */
+export class Analytics {
+    collector = null;
+    writer = null;
+    session;
+    config;
+    installationId = null;
+    // Plugin system for extensibility
+    plugins = [];
+    // Session metrics aggregation
+    sessionMetrics = {
+        totalLatencyMs: 0,
+        apiRequestCount: 0,
+    };
+    constructor(config = {}) {
+        this.config = loadAnalyticsConfig(config);
+        this.session = new SessionManager();
+        // Only initialize if enabled
+        if (this.config.enabled) {
+            this.initialize();
+        }
+    }
+    /**
+     * Register an analytics plugin (Open/Closed principle)
+     * Allows adding custom metrics without modifying core
+     */
+    registerPlugin(plugin) {
+        this.plugins.push(plugin);
+        // Initialize plugin if it has init method
+        if (plugin.initialize) {
+            plugin.initialize(this).catch(error => {
+                console.error(`Plugin "${plugin.name}" initialization failed:`, error);
+            });
+        }
+    }
+    /**
+     * Get all registered plugins
+     */
+    getPlugins() {
+        return [...this.plugins];
+    }
+    /**
+     * Get current metrics from all plugins
+     * Useful for displaying aggregated stats
+     */
+    getPluginMetrics() {
+        const allMetrics = {};
+        for (const plugin of this.plugins) {
+            if (plugin.getMetrics) {
+                try {
+                    allMetrics[plugin.name] = plugin.getMetrics();
+                }
+                catch (error) {
+                    console.error(`Error getting metrics from plugin "${plugin.name}":`, error);
+                    allMetrics[plugin.name] = { error: 'Failed to get metrics' };
+                }
+            }
+        }
+        return allMetrics;
+    }
+    /**
+     * Get metrics from a specific plugin by name
+     */
+    getPluginMetricsByName(pluginName) {
+        const plugin = this.plugins.find(p => p.name === pluginName);
+        if (!plugin || !plugin.getMetrics) {
+            return null;
+        }
+        try {
+            return plugin.getMetrics();
+        }
+        catch (error) {
+            console.error(`Error getting metrics from plugin "${pluginName}":`, error);
+            return null;
+        }
+    }
+    /**
+     * Initialize analytics components
+     */
+    initialize() {
+        this.collector = new EventCollector({
+            maxBufferSize: this.config.maxBufferSize,
+            flushInterval: this.config.flushInterval,
+        });
+        // Setup writer for local target
+        if (this.config.target === 'local' || this.config.target === 'both') {
+            this.writer = new AnalyticsWriter(this.config.localPath);
+        }
+        // Register flush callback
+        this.collector.onFlush(async (events) => {
+            if (this.writer) {
+                await this.writer.write(events);
+            }
+        });
+    }
+    /**
+     * Track an analytics event
+     */
+    async track(eventType, attributes = {}, metrics) {
+        if (!this.config.enabled || !this.collector || !this.session.isActive) {
+            return;
+        }
+        try {
+            // Lazy load installation ID
+            if (!this.installationId) {
+                this.installationId = await getInstallationId();
+            }
+            let event = {
+                timestamp: new Date().toISOString(),
+                eventType,
+                sessionId: this.session.id,
+                installationId: this.installationId,
+                agent: this.session.agent,
+                agentVersion: this.session.agentVersion,
+                cliVersion: this.session.cliVersion,
+                profile: this.session.profile,
+                provider: this.session.provider,
+                model: this.session.model,
+                attributes,
+                metrics: metrics || {},
+            };
+            // Process through plugins
+            for (const plugin of this.plugins) {
+                try {
+                    // 1. Allow plugins to transform event
+                    if (plugin.processEvent) {
+                        const processed = await plugin.processEvent(event);
+                        if (!processed) {
+                            // Plugin filtered out event
+                            return;
+                        }
+                        event = processed;
+                    }
+                    // 2. Enrich with plugin metrics
+                    if (plugin.enrichMetrics) {
+                        const pluginMetrics = await plugin.enrichMetrics(event);
+                        // Merge plugin metrics (cast to Record<string, number> for compatibility)
+                        event.metrics = { ...event.metrics, ...pluginMetrics };
+                    }
+                }
+                catch (pluginError) {
+                    // Plugin errors should not break analytics
+                    console.error(`Plugin "${plugin.name}" error:`, pluginError);
+                }
+            }
+            // Aggregate session metrics
+            if (eventType === 'api_request') {
+                this.sessionMetrics.apiRequestCount++;
+            }
+            if (eventType === 'api_response' && event.metrics?.latencyMs) {
+                this.sessionMetrics.totalLatencyMs += event.metrics.latencyMs;
+            }
+            this.collector.add(event);
+        }
+        catch (error) {
+            // Silently fail - don't block agent execution
+            console.error('Analytics tracking error:', error);
+        }
+    }
+    /**
+     * Track agent response
+     */
+    async trackAgentResponse(response, attributes = {}) {
+        const eventAttrs = {
+            ...attributes,
+            responseLength: response.length,
+        };
+        await this.track('agent_response', eventAttrs);
+    }
+    /**
+     * Track API response
+     */
+    async trackAPIResponse(data) {
+        const attributes = {};
+        if (data.statusCode) {
+            attributes.statusCode = data.statusCode;
+        }
+        const metrics = {};
+        if (data.latency)
+            metrics.latencyMs = data.latency;
+        await this.track('api_response', attributes, metrics);
+    }
+    /**
+     * Start analytics session
+     */
+    startSession(config) {
+        this.session.start(config);
+        this.resetMetrics(); // Reset metrics for new session
+        void this.track('session_start', {
+            workingDir: config.workingDir,
+            interactive: config.interactive,
+        });
+    }
+    /**
+     * End analytics session
+     */
+    async endSession(exitReason, metrics) {
+        if (!this.session.isActive) {
+            return;
+        }
+        // Combine session metrics with provided metrics
+        const sessionMetrics = {
+            durationSeconds: this.session.duration,
+            totalLatencyMs: this.sessionMetrics.totalLatencyMs,
+            averageLatencyMs: this.sessionMetrics.apiRequestCount > 0
+                ? this.sessionMetrics.totalLatencyMs / this.sessionMetrics.apiRequestCount
+                : 0,
+            apiRequestCount: this.sessionMetrics.apiRequestCount,
+            ...metrics,
+        };
+        const attributes = {
+            exitReason,
+        };
+        await this.track('session_end', attributes, sessionMetrics);
+        // Force flush on session end
+        await this.flush();
+        // Reset metrics
+        this.resetMetrics();
+        this.session.end();
+    }
+    /**
+     * Reset session metrics
+     */
+    resetMetrics() {
+        this.sessionMetrics = {
+            totalLatencyMs: 0,
+            apiRequestCount: 0,
+        };
+    }
+    /**
+     * Flush buffered events
+     */
+    async flush() {
+        if (this.collector) {
+            await this.collector.flush();
+        }
+    }
+    /**
+     * Cleanup and destroy analytics
+     */
+    async destroy() {
+        if (this.collector) {
+            await this.flush();
+            this.collector.destroy();
+        }
+    }
+    /**
+     * Check if analytics is enabled
+     */
+    get isEnabled() {
+        return this.config.enabled;
+    }
+}
+/**
+ * Singleton analytics instance
+ */
+let analyticsInstance = null;
+/**
+ * Initialize global analytics instance
+ * Automatically registers default plugins for API tracking
+ */
+export function initAnalytics(config = {}, options = { registerDefaultPlugins: true }) {
+    analyticsInstance = new Analytics(config);
+    // Register default plugins if enabled
+    if (options.registerDefaultPlugins && analyticsInstance.isEnabled) {
+        registerDefaultPlugins(analyticsInstance);
+    }
+}
+/**
+ * Register default analytics plugins
+ * Tracks API request/response patterns, success rates, and latency
+ */
+export function registerDefaultPlugins(analytics) {
+    try {
+        // Import plugins dynamically to avoid unnecessary loading
+        import('./plugins/index.js').then(({ APIMetricsPlugin, ModelMetricsPlugin, ProviderMetricsPlugin }) => {
+            analytics.registerPlugin(new APIMetricsPlugin());
+            analytics.registerPlugin(new ModelMetricsPlugin());
+            analytics.registerPlugin(new ProviderMetricsPlugin());
+        }).catch(error => {
+            // Plugins are optional - don't break if they fail to load
+            console.warn('Failed to load default analytics plugins:', error);
+        });
+    }
+    catch (error) {
+        console.warn('Failed to register default analytics plugins:', error);
+    }
+}
+/**
+ * Get global analytics instance
+ * Auto-initializes if not already initialized
+ */
+export function getAnalytics() {
+    if (!analyticsInstance) {
+        // Auto-initialize with defaults
+        initAnalytics();
+    }
+    return analyticsInstance; // Safe: always initialized above
+}
+/**
+ * Destroy global analytics instance
+ */
+export async function destroyAnalytics() {
+    if (analyticsInstance) {
+        await analyticsInstance.destroy();
+        analyticsInstance = null;
+    }
+}
+export { DEFAULT_ANALYTICS_CONFIG } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/analytics/index.js.map

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

package/dist/analytics/plugins/api-metrics.plugin.d.ts

@@ -0,0 +1,23 @@
+/**
+ * API Metrics Plugin
+ *
+ * Tracks API request/response patterns, success/failure rates, and latency.
+ * Useful for monitoring 3rd party agent API health and performance.
+ */
+import { AnalyticsPlugin } from './types.js';
+import { AnalyticsEvent } from '../types.js';
+export declare class APIMetricsPlugin implements AnalyticsPlugin {
+    name: string;
+    version: string;
+    private sessionMetrics;
+    enrichMetrics(event: AnalyticsEvent): Promise<Record<string, unknown>>;
+    /**
+     * Get current aggregated metrics
+     */
+    getMetrics(): Record<string, unknown>;
+    /**
+     * Reset metrics (useful for new sessions)
+     */
+    reset(): void;
+}
+//# sourceMappingURL=api-metrics.plugin.d.ts.map

package/dist/analytics/plugins/api-metrics.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-metrics.plugin.d.ts","sourceRoot":"","sources":["../../../src/analytics/plugins/api-metrics.plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,qBAAa,gBAAiB,YAAW,eAAe;IACtD,IAAI,SAAiB;IACrB,OAAO,SAAW;IAGlB,OAAO,CAAC,cAAc,CASpB;IAEI,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAgE5E;;OAEG;IACH,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAsBrC;;OAEG;IACH,KAAK,IAAI,IAAI;CAYd"}

package/dist/analytics/plugins/api-metrics.plugin.js

@@ -0,0 +1,113 @@
+/**
+ * API Metrics Plugin
+ *
+ * Tracks API request/response patterns, success/failure rates, and latency.
+ * Useful for monitoring 3rd party agent API health and performance.
+ */
+export class APIMetricsPlugin {
+    name = 'api-metrics';
+    version = '1.0.0';
+    // Track metrics per session
+    sessionMetrics = {
+        totalRequests: 0,
+        successfulRequests: 0,
+        failedRequests: 0,
+        totalLatency: 0,
+        minLatency: Infinity,
+        maxLatency: 0,
+        statusCodes: {},
+        errorTypes: {}
+    };
+    async enrichMetrics(event) {
+        // Track API request metrics
+        if (event.eventType === 'api_request') {
+            this.sessionMetrics.totalRequests++;
+        }
+        // Track API response metrics
+        if (event.eventType === 'api_response') {
+            const statusCode = event.attributes.statusCode;
+            const latency = event.metrics?.latencyMs;
+            // Count successful vs failed
+            if (statusCode >= 200 && statusCode < 400) {
+                this.sessionMetrics.successfulRequests++;
+            }
+            else {
+                this.sessionMetrics.failedRequests++;
+            }
+            // Track status codes
+            this.sessionMetrics.statusCodes[statusCode] =
+                (this.sessionMetrics.statusCodes[statusCode] || 0) + 1;
+            // Track latency stats
+            if (latency) {
+                this.sessionMetrics.totalLatency += latency;
+                this.sessionMetrics.minLatency = Math.min(this.sessionMetrics.minLatency, latency);
+                this.sessionMetrics.maxLatency = Math.max(this.sessionMetrics.maxLatency, latency);
+            }
+            // Calculate aggregated metrics
+            const successRate = this.sessionMetrics.totalRequests > 0
+                ? this.sessionMetrics.successfulRequests / this.sessionMetrics.totalRequests
+                : 0;
+            const averageLatency = this.sessionMetrics.successfulRequests > 0
+                ? this.sessionMetrics.totalLatency / this.sessionMetrics.successfulRequests
+                : 0;
+            return {
+                api_total_requests: this.sessionMetrics.totalRequests,
+                api_success_count: this.sessionMetrics.successfulRequests,
+                api_failure_count: this.sessionMetrics.failedRequests,
+                api_success_rate: Math.round(successRate * 100) / 100, // Round to 2 decimals
+                api_avg_latency_ms: Math.round(averageLatency),
+                api_min_latency_ms: this.sessionMetrics.minLatency === Infinity ? 0 : this.sessionMetrics.minLatency,
+                api_max_latency_ms: this.sessionMetrics.maxLatency
+            };
+        }
+        // Track proxy errors
+        if (event.eventType === 'proxy_error') {
+            const errorType = event.attributes.errorType || 'unknown';
+            this.sessionMetrics.errorTypes[errorType] =
+                (this.sessionMetrics.errorTypes[errorType] || 0) + 1;
+            return {
+                proxy_error_count: Object.values(this.sessionMetrics.errorTypes).reduce((a, b) => a + b, 0),
+                proxy_error_types: this.sessionMetrics.errorTypes
+            };
+        }
+        return {};
+    }
+    /**
+     * Get current aggregated metrics
+     */
+    getMetrics() {
+        const successRate = this.sessionMetrics.totalRequests > 0
+            ? this.sessionMetrics.successfulRequests / this.sessionMetrics.totalRequests
+            : 0;
+        const averageLatency = this.sessionMetrics.successfulRequests > 0
+            ? this.sessionMetrics.totalLatency / this.sessionMetrics.successfulRequests
+            : 0;
+        return {
+            totalRequests: this.sessionMetrics.totalRequests,
+            successfulRequests: this.sessionMetrics.successfulRequests,
+            failedRequests: this.sessionMetrics.failedRequests,
+            successRate: Math.round(successRate * 100) / 100,
+            averageLatencyMs: Math.round(averageLatency),
+            minLatencyMs: this.sessionMetrics.minLatency === Infinity ? 0 : this.sessionMetrics.minLatency,
+            maxLatencyMs: this.sessionMetrics.maxLatency,
+            statusCodes: { ...this.sessionMetrics.statusCodes },
+            errorTypes: { ...this.sessionMetrics.errorTypes }
+        };
+    }
+    /**
+     * Reset metrics (useful for new sessions)
+     */
+    reset() {
+        this.sessionMetrics = {
+            totalRequests: 0,
+            successfulRequests: 0,
+            failedRequests: 0,
+            totalLatency: 0,
+            minLatency: Infinity,
+            maxLatency: 0,
+            statusCodes: {},
+            errorTypes: {}
+        };
+    }
+}
+//# sourceMappingURL=api-metrics.plugin.js.map

package/dist/analytics/plugins/api-metrics.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-metrics.plugin.js","sourceRoot":"","sources":["../../../src/analytics/plugins/api-metrics.plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,OAAO,gBAAgB;IAC3B,IAAI,GAAG,aAAa,CAAC;IACrB,OAAO,GAAG,OAAO,CAAC;IAElB,4BAA4B;IACpB,cAAc,GAAG;QACvB,aAAa,EAAE,CAAC;QAChB,kBAAkB,EAAE,CAAC;QACrB,cAAc,EAAE,CAAC;QACjB,YAAY,EAAE,CAAC;QACf,UAAU,EAAE,QAAQ;QACpB,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,EAA4B;QACzC,UAAU,EAAE,EAA4B;KACzC,CAAC;IAEF,KAAK,CAAC,aAAa,CAAC,KAAqB;QACvC,4BAA4B;QAC5B,IAAI,KAAK,CAAC,SAAS,KAAK,aAAa,EAAE,CAAC;YACtC,IAAI,CAAC,cAAc,CAAC,aAAa,EAAE,CAAC;QACtC,CAAC;QAED,6BAA6B;QAC7B,IAAI,KAAK,CAAC,SAAS,KAAK,cAAc,EAAE,CAAC;YACvC,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,UAAoB,CAAC;YACzD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,SAAmB,CAAC;YAEnD,6BAA6B;YAC7B,IAAI,UAAU,IAAI,GAAG,IAAI,UAAU,GAAG,GAAG,EAAE,CAAC;gBAC1C,IAAI,CAAC,cAAc,CAAC,kBAAkB,EAAE,CAAC;YAC3C,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,cAAc,CAAC,cAAc,EAAE,CAAC;YACvC,CAAC;YAED,qBAAqB;YACrB,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,UAAU,CAAC;gBACzC,CAAC,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAEzD,sBAAsB;YACtB,IAAI,OAAO,EAAE,CAAC;gBACZ,IAAI,CAAC,cAAc,CAAC,YAAY,IAAI,OAAO,CAAC;gBAC5C,IAAI,CAAC,cAAc,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBACnF,IAAI,CAAC,cAAc,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACrF,CAAC;YAED,+BAA+B;YAC/B,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,aAAa,GAAG,CAAC;gBACvD,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,kBAAkB,GAAG,IAAI,CAAC,cAAc,CAAC,aAAa;gBAC5E,CAAC,CAAC,CAAC,CAAC;YAEN,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,kBAAkB,GAAG,CAAC;gBAC/D,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,kBAAkB;gBAC3E,CAAC,CAAC,CAAC,CAAC;YAEN,OAAO;gBACL,kBAAkB,EAAE,IAAI,CAAC,cAAc,CAAC,aAAa;gBACrD,iBAAiB,EAAE,IAAI,CAAC,cAAc,CAAC,kBAAkB;gBACzD,iBAAiB,EAAE,IAAI,CAAC,cAAc,CAAC,cAAc;gBACrD,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC,GAAG,GAAG,EAAE,sBAAsB;gBAC7E,kBAAkB,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC;gBAC9C,kBAAkB,EAAE,IAAI,CAAC,cAAc,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU;gBACpG,kBAAkB,EAAE,IAAI,CAAC,cAAc,CAAC,UAAU;aACnD,CAAC;QACJ,CAAC;QAED,qBAAqB;QACrB,IAAI,KAAK,CAAC,SAAS,KAAK,aAAa,EAAE,CAAC;YACtC,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,CAAC,SAAmB,IAAI,SAAS,CAAC;YACpE,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,SAAS,CAAC;gBACvC,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAEvD,OAAO;gBACL,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC3F,iBAAiB,EAAE,IAAI,CAAC,cAAc,CAAC,UAAU;aAClD,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,UAAU;QACR,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,aAAa,GAAG,CAAC;YACvD,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,kBAAkB,GAAG,IAAI,CAAC,cAAc,CAAC,aAAa;YAC5E,CAAC,CAAC,CAAC,CAAC;QAEN,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,kBAAkB,GAAG,CAAC;YAC/D,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,kBAAkB;YAC3E,CAAC,CAAC,CAAC,CAAC;QAEN,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,cAAc,CAAC,aAAa;YAChD,kBAAkB,EAAE,IAAI,CAAC,cAAc,CAAC,kBAAkB;YAC1D,cAAc,EAAE,IAAI,CAAC,cAAc,CAAC,cAAc;YAClD,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC,GAAG,GAAG;YAChD,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC;YAC5C,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU;YAC9F,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC,UAAU;YAC5C,WAAW,EAAE,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE;YACnD,UAAU,EAAE,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE;SAClD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,cAAc,GAAG;YACpB,aAAa,EAAE,CAAC;YAChB,kBAAkB,EAAE,CAAC;YACrB,cAAc,EAAE,CAAC;YACjB,YAAY,EAAE,CAAC;YACf,UAAU,EAAE,QAAQ;YACpB,UAAU,EAAE,CAAC;YACb,WAAW,EAAE,EAAE;YACf,UAAU,EAAE,EAAE;SACf,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,15 @@
+/**
+ * Analytics Plugins
+ *
+ * Export all analytics plugins for easy registration.
+ *
+ * Default plugins track API request/response patterns:
+ * - APIMetricsPlugin: Overall API success/failure rates, latency
+ * - ModelMetricsPlugin: Metrics per model (Claude, GPT, Gemini)
+ * - ProviderMetricsPlugin: Metrics per provider (ai-run-sso, litellm, etc.)
+ */
+export { AnalyticsPlugin, AnalyticsPluginRegistry } from './types.js';
+export { APIMetricsPlugin } from './api-metrics.plugin.js';
+export { ModelMetricsPlugin } from './model-metrics.plugin.js';
+export { ProviderMetricsPlugin } from './provider-metrics.plugin.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analytics/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/analytics/plugins/index.js

@@ -0,0 +1,15 @@
+/**
+ * Analytics Plugins
+ *
+ * Export all analytics plugins for easy registration.
+ *
+ * Default plugins track API request/response patterns:
+ * - APIMetricsPlugin: Overall API success/failure rates, latency
+ * - ModelMetricsPlugin: Metrics per model (Claude, GPT, Gemini)
+ * - ProviderMetricsPlugin: Metrics per provider (ai-run-sso, litellm, etc.)
+ */
+export { AnalyticsPluginRegistry } from './types.js';
+export { APIMetricsPlugin } from './api-metrics.plugin.js';
+export { ModelMetricsPlugin } from './model-metrics.plugin.js';
+export { ProviderMetricsPlugin } from './provider-metrics.plugin.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analytics/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAmB,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/analytics/plugins/model-metrics.plugin.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Model Metrics Plugin
+ *
+ * Tracks metrics per model (Claude, GPT, Gemini, etc.).
+ * Helps identify which models perform better for different use cases.
+ */
+import { AnalyticsPlugin } from './types.js';
+import { AnalyticsEvent } from '../types.js';
+interface ModelStats {
+    requestCount: number;
+    successCount: number;
+    failureCount: number;
+    totalLatency: number;
+    totalTokens: number;
+}
+export declare class ModelMetricsPlugin implements AnalyticsPlugin {
+    name: string;
+    version: string;
+    private modelMetrics;
+    enrichMetrics(event: AnalyticsEvent): Promise<Record<string, unknown>>;
+    /**
+     * Get current aggregated metrics for all models
+     */
+    getMetrics(): Record<string, unknown>;
+    /**
+     * Reset metrics (useful for new sessions)
+     */
+    reset(): void;
+    /**
+     * Get all model metrics (useful for session end reporting)
+     * @deprecated Use getMetrics() instead
+     */
+    getAllModelMetrics(): Record<string, ModelStats>;
+}
+export {};
+//# sourceMappingURL=model-metrics.plugin.d.ts.map

package/dist/analytics/plugins/model-metrics.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-metrics.plugin.d.ts","sourceRoot":"","sources":["../../../src/analytics/plugins/model-metrics.plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,UAAU,UAAU;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,kBAAmB,YAAW,eAAe;IACxD,IAAI,SAAmB;IACvB,OAAO,SAAW;IAGlB,OAAO,CAAC,YAAY,CAAiC;IAE/C,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAuE5E;;OAEG;IACH,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IA4BrC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACH,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;CAOjD"}