@robota-sdk/agent-plugin 3.0.0-beta.64

package/src/execution-analytics/index.ts

@@ -0,0 +1,9 @@
+export { ExecutionAnalyticsPlugin } from './execution-analytics-plugin';
+export { aggregateExecutionStats } from './analytics-aggregation';
+export type {
+  IExecutionAnalyticsOptions,
+  IExecutionStats,
+  IAggregatedExecutionStats,
+  IExecutionAnalyticsPluginStats,
+  IExecutionAnalyticsContextData,
+} from './types';

package/src/execution-analytics/types.ts

@@ -0,0 +1,97 @@
+/**
+ * Analytics context data for execution tracking
+ */
+export interface IExecutionAnalyticsContextData {
+  executionId?: string;
+  sessionId?: string;
+  userId?: string;
+  operation?: string;
+  toolName?: string;
+  parameterCount?: number;
+  inputLength?: number;
+  responseLength?: number;
+  hasOptions?: boolean;
+  hasError?: boolean;
+  resultType?: string;
+  errorSource?: string;
+  contextType?: string;
+  hasContext?: boolean;
+  modelName?: string;
+}
+
+/**
+ * Execution statistics entry
+ */
+export interface IExecutionStats {
+  executionId: string;
+  operation: string;
+  startTime: Date;
+  endTime: Date;
+  duration: number;
+  success: boolean;
+  error?: {
+    message: string;
+    stack?: string;
+    type: string;
+  };
+  metadata?: Record<string, string | number | boolean | Date | string[]>;
+}
+
+/**
+ * Aggregated execution statistics
+ */
+export interface IAggregatedExecutionStats {
+  totalExecutions: number;
+  successfulExecutions: number;
+  failedExecutions: number;
+  successRate: number;
+  averageDuration: number;
+  totalDuration: number;
+  operationStats: Record<
+    string,
+    {
+      count: number;
+      successCount: number;
+      failureCount: number;
+      averageDuration: number;
+      totalDuration: number;
+    }
+  >;
+  errorStats: Record<string, number>;
+  timeRange: {
+    start: Date;
+    end: Date;
+  };
+}
+
+import type { IPluginOptions, IPluginStats } from '@robota-sdk/agent-core';
+
+/**
+ * Plugin options
+ */
+export interface IExecutionAnalyticsOptions extends IPluginOptions {
+  /** Maximum number of entries to keep in memory */
+  maxEntries?: number;
+  /** Whether to track error details */
+  trackErrors?: boolean;
+  /** Performance threshold in milliseconds for warnings */
+  performanceThreshold?: number;
+  /** Enable performance warnings */
+  enableWarnings?: boolean;
+}
+
+/**
+ * Execution analytics plugin statistics
+ */
+export interface IExecutionAnalyticsPluginStats extends IPluginStats {
+  /** Total number of executions recorded */
+  totalRecorded: number;
+  /** Number of active executions */
+  activeExecutions: number;
+  /** Memory usage in KB */
+  memoryUsage: number;
+  /** Oldest record timestamp */
+  oldestRecord?: Date;
+  /** Newest record timestamp */
+  newestRecord?: Date;
+}

package/src/index.ts

@@ -0,0 +1,8 @@
+export * from './conversation-history/index.js';
+export * from './error-handling/index.js';
+export * from './execution-analytics/index.js';
+export * from './limits/index.js';
+export * from './logging/index.js';
+export * from './performance/index.js';
+export * from './usage/index.js';
+export * from './webhook/index.js';