@robota-sdk/agent-core 3.0.0-beta.14 → 3.0.0-beta.16

package/dist/abstracts/abstract-plugin.d.ts

@@ -1,332 +1,52 @@
+/**
+ * Abstract class for all plugins with type parameter support.
+ *
+ * Type definitions live in ./abstract-plugin-types.ts.
+ */
 import type { IRunOptions } from '../interfaces/agent';
 import type { TUniversalMessage } from '../interfaces/messages';
 import type { TToolParameters, IToolExecutionResult, IToolExecutionContext } from '../interfaces/tool';
 import type { IEventEmitterEventData, IEventEmitterPlugin, TEventName } from '../plugins/event-emitter/types';
+import { type ILogger } from '../utils/logger';
+import type { IPluginOptions, IPluginStats, IPluginConfig, IPluginData, IPluginContract, IPluginHooks, IPluginExecutionContext, IPluginExecutionResult, IPluginErrorContext } from './abstract-plugin-types';
+import { PluginCategory, PluginPriority } from './abstract-plugin-types';
+export type { IPluginOptions, IPluginStats, IPluginConfig, IPluginData, IPluginContract, IPluginHooks, IPluginExecutionContext, IPluginExecutionResult, IPluginErrorContext, };
+export type { IPlugin } from './abstract-plugin-types';
+export { PluginCategory, PluginPriority };
 /**
- * Plugin categories for classification
- */
-export declare enum PluginCategory {
-    /** Monitoring and observability */
-    MONITORING = "monitoring",
-    /** Logging and debugging */
-    LOGGING = "logging",
-    /** Data storage and persistence */
-    STORAGE = "storage",
-    /** External notifications and alerts */
-    NOTIFICATION = "notification",
-    /** Security and access control */
-    SECURITY = "security",
-    /** Performance optimization */
-    PERFORMANCE = "performance",
-    /** Error handling and recovery */
-    ERROR_HANDLING = "error_handling",
-    /** Rate limiting and throttling */
-    LIMITS = "limits",
-    /** Event processing and coordination */
-    EVENT_PROCESSING = "event_processing",
-    /** Custom or specialized functionality */
-    CUSTOM = "custom"
-}
-/**
- * Plugin priority levels
- */
-export declare enum PluginPriority {
-    /** Highest priority - executed first */
-    CRITICAL = 1000,
-    /** High priority */
-    HIGH = 800,
-    /** Normal priority (default) */
-    NORMAL = 500,
-    /** Low priority */
-    LOW = 200,
-    /** Lowest priority - executed last */
-    MINIMAL = 100
-}
-/**
- * Plugin execution context for all plugins
- */
-export interface IPluginExecutionContext {
-    executionId?: string;
-    sessionId?: string;
-    userId?: string;
-    messages?: TUniversalMessage[];
-    config?: Record<string, string | number | boolean>;
-    metadata?: Record<string, string | number | boolean | Date>;
-    [key: string]: string | number | boolean | Date | string[] | number[] | boolean[] | TUniversalMessage[] | Record<string, string | number | boolean> | Record<string, string | number | boolean | Date> | undefined;
-}
-/**
- * Plugin execution result for all plugins
- */
-export interface IPluginExecutionResult {
-    response?: string;
-    content?: string;
-    duration?: number;
-    tokensUsed?: number;
-    toolsExecuted?: number;
-    success?: boolean;
-    usage?: {
-        totalTokens?: number;
-        promptTokens?: number;
-        completionTokens?: number;
-    };
-    toolCalls?: Array<{
-        id?: string;
-        name?: string;
-        arguments?: Record<string, string | number | boolean>;
-        result?: string | number | boolean | null;
-    }>;
-    results?: Array<{
-        id?: string;
-        type?: string;
-        data?: string | number | boolean | null;
-        success?: boolean;
-    }>;
-    error?: Error;
-    metadata?: Record<string, string | number | boolean | Date>;
-}
-/**
- * Error context for plugin error handling
- */
-export interface IPluginErrorContext {
-    action: string;
-    tool?: string;
-    parameters?: TToolParameters;
-    result?: IToolExecutionResult;
-    error?: Error;
-    executionId?: string;
-    sessionId?: string;
-    userId?: string;
-    timestamp?: Date;
-    attempt?: number;
-    stack?: string;
-    metadata?: Record<string, string | number | boolean>;
-}
-/**
- * Plugin configuration interface
- */
-export interface IPluginConfig extends IPluginOptions {
-    options?: Record<string, string | number | boolean>;
-}
-/**
- * Plugin options that all plugin options should extend
- * This provides a common structure while allowing specific options
- */
-export interface IPluginOptions {
-    /** Whether the plugin is enabled */
-    enabled?: boolean;
-    /** Plugin category for classification */
-    category?: PluginCategory;
-    /** Plugin priority for execution order */
-    priority?: PluginPriority | number;
-    /** Events to subscribe to from modules */
-    moduleEvents?: TEventName[];
-    /** Whether to subscribe to all module events */
-    subscribeToAllModuleEvents?: boolean;
-}
-/**
- * Plugin data interface
- */
-export interface IPluginData {
-    name: string;
-    version: string;
-    enabled: boolean;
-    category: PluginCategory;
-    priority: number;
-    subscribedEvents: TEventName[];
-    metadata?: Record<string, string | number | boolean>;
-}
-/**
- * Type-safe plugin interface with specific type parameters
- *
- * @template TOptions - Plugin options type that extends IPluginOptions
- * @template TStats - Plugin statistics type (defaults to IPluginStats for type safety)
- */
-export interface IPluginContract<TOptions extends IPluginOptions = IPluginOptions, TStats = IPluginStats> {
-    name: string;
-    version: string;
-    enabled: boolean;
-    category: PluginCategory;
-    priority: number;
-    initialize(options?: TOptions): Promise<void>;
-    cleanup?(): Promise<void>;
-    getData?(): IPluginData;
-    getStats?(): TStats;
-    subscribeToModuleEvents?(eventEmitter: IEventEmitterPlugin): Promise<void>;
-    unsubscribeFromModuleEvents?(eventEmitter: IEventEmitterPlugin): Promise<void>;
-    onModuleEvent?(eventName: TEventName, eventData: IEventEmitterEventData): Promise<void> | void;
-}
-/**
- * Plugin statistics base interface with common metrics
- */
-export interface IPluginStats {
-    enabled: boolean;
-    calls: number;
-    errors: number;
-    lastActivity?: Date;
-    moduleEventsReceived?: number;
-    [key: string]: string | number | boolean | Date | string[] | number[] | boolean[] | Record<string, string | number | boolean | Date> | undefined;
-}
-/**
- * Plugin interface extending IPluginContract
- */
-export interface IPlugin extends IPluginContract<IPluginConfig, IPluginStats> {
-}
-/**
- * Plugin lifecycle hooks
- */
-export interface IPluginHooks {
-    /**
-     * Called before agent run
-     */
-    beforeRun?(input: string, options?: IRunOptions): Promise<void> | void;
-    /**
-     * Called after agent run
-     */
-    afterRun?(input: string, response: string, options?: IRunOptions): Promise<void> | void;
-    /**
-     * Called before execution with context
-     */
-    beforeExecution?(context: IPluginExecutionContext): Promise<void> | void;
-    /**
-     * Called after execution with context and result
-     */
-    afterExecution?(context: IPluginExecutionContext, result: IPluginExecutionResult): Promise<void> | void;
-    /**
-     * Called before conversation with context
-     */
-    beforeConversation?(context: IPluginExecutionContext): Promise<void> | void;
-    /**
-     * Called after conversation with context and result
-     */
-    afterConversation?(context: IPluginExecutionContext, result: IPluginExecutionResult): Promise<void> | void;
-    /**
-     * Called before tool execution
-     */
-    beforeToolCall?(toolName: string, parameters: TToolParameters): Promise<void> | void;
-    /**
-     * Called before tool execution with context
-     */
-    beforeToolExecution?(context: IPluginExecutionContext, toolData: IToolExecutionContext): Promise<void> | void;
-    /**
-     * Called after tool execution
-     */
-    afterToolCall?(toolName: string, parameters: TToolParameters, result: IToolExecutionResult): Promise<void> | void;
-    /**
-     * Called after tool execution with context
-     */
-    afterToolExecution?(context: IPluginExecutionContext, toolResults: IPluginExecutionResult): Promise<void> | void;
-    /**
-     * Called before AI provider call
-     */
-    beforeProviderCall?(messages: TUniversalMessage[]): Promise<void> | void;
-    /**
-     * Called after AI provider call
-     */
-    afterProviderCall?(messages: TUniversalMessage[], response: TUniversalMessage): Promise<void> | void;
-    /**
-     * Called on streaming chunk
-     */
-    onStreamingChunk?(chunk: TUniversalMessage): Promise<void> | void;
-    /**
-     * Called on error
-     */
-    onError?(error: Error, context?: IPluginErrorContext): Promise<void> | void;
-    /**
-     * Called on message added to history
-     */
-    onMessageAdded?(message: TUniversalMessage): Promise<void> | void;
-    /**
-     * Called when module events are received
-     */
-    onModuleEvent?(eventName: TEventName, eventData: IEventEmitterEventData): Promise<void> | void;
-}
-/**
- * Abstract class for all plugins with type parameter support
- * Provides plugin lifecycle management and common functionality
- *
- * Enhanced with:
- * - Plugin classification system (categories and priorities)
- * - EventEmitter integration for module event subscription
- * - Improved statistics tracking
- * - Better error handling and recovery
- *
+ * Abstract class for all plugins with type parameter support.
+ * Provides plugin lifecycle management and common functionality.
  * @template TOptions - Plugin options type that extends IPluginOptions
- * @template TStats - Plugin statistics type (defaults to IPluginStats for type safety)
+ * @template TStats - Plugin statistics type
  */
 export declare abstract class AbstractPlugin<TOptions extends IPluginOptions = IPluginOptions, TStats extends IPluginStats = IPluginStats> implements IPluginContract<TOptions, TStats>, IPluginHooks {
-    /** Plugin name */
     abstract readonly name: string;
-    /** Plugin version */
     abstract readonly version: string;
-    /** Plugin enabled state */
     enabled: boolean;
-    /** Plugin category for classification */
     category: PluginCategory;
-    /** Plugin priority for execution order */
     priority: number;
-    /** Plugin options */
     protected options: TOptions | undefined;
-    /** EventEmitter for module event subscription */
     protected eventEmitter: IEventEmitterPlugin | undefined;
-    /** Subscribed event types */
     protected subscribedEvents: TEventName[];
-    /** Event subscription handlers */
     protected eventHandlers: Map<TEventName, string[]>;
-    /** Plugin statistics */
+    protected readonly pluginLogger: ILogger;
     protected stats: {
         calls: number;
         errors: number;
         moduleEventsReceived: number;
         lastActivity: Date | undefined;
     };
-    /**
-     * Initialize the plugin with type-safe options
-     */
     initialize(options?: TOptions): Promise<void>;
-    /**
-     * Subscribe to module events through EventEmitter
-     */
     subscribeToModuleEvents(eventEmitter: IEventEmitterPlugin): Promise<void>;
-    /**
-     * Unsubscribe from module events
-     */
     unsubscribeFromModuleEvents(eventEmitter: IEventEmitterPlugin): Promise<void>;
-    /**
-     * Cleanup plugin resources
-     */
     dispose(): Promise<void>;
-    /**
-     * Enable the plugin
-     */
     enable(): void;
-    /**
-     * Disable the plugin
-     */
     disable(): void;
-    /**
-     * Check if plugin is enabled
-     */
     isEnabled(): boolean;
-    /**
-     * Get plugin configuration
-     */
     getConfig(): IPluginConfig;
-    /**
-     * Update plugin configuration
-     */
     updateConfig(_config: IPluginConfig): void;
-    /**
-     * Get plugin data - enhanced with classification information
-     */
     getData(): IPluginData;
-    /**
-     * Clear plugin data - common interface for all plugins
-     * This method should be implemented by plugins that store data
-     */
     clearData?(): void;
-    /**
-     * Get plugin status - enhanced with classification information
-     */
     getStatus(): {
         name: string;
         version: string;
@@ -337,17 +57,8 @@ export declare abstract class AbstractPlugin<TOptions extends IPluginOptions = I
         subscribedEventsCount: number;
         hasEventEmitter: boolean;
     };
-    /**
-     * Get plugin statistics - enhanced with module event tracking
-     */
     getStats(): TStats;
-    /**
-     * Update plugin call statistics
-     */
     protected updateCallStats(): void;
-    /**
-     * Update plugin error statistics
-     */
     protected updateErrorStats(): void;
     beforeRun?(input: string, options?: IRunOptions): Promise<void>;
     afterRun?(input: string, response: string, options?: IRunOptions): Promise<void>;

package/dist/abstracts/abstract-plugin.d.ts.map

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

package/dist/abstracts/abstract-plugin.js

@@ -1,123 +1,49 @@
 import { EVENT_EMITTER_EVENTS } from '../plugins/event-emitter/types';
+import { createLogger } from '../utils/logger';
+import { PluginCategory, PluginPriority } from './abstract-plugin-types';
+export { PluginCategory, PluginPriority };
 /**
- * Plugin categories for classification
- */
-export var PluginCategory;
-(function (PluginCategory) {
-    /** Monitoring and observability */
-    PluginCategory["MONITORING"] = "monitoring";
-    /** Logging and debugging */
-    PluginCategory["LOGGING"] = "logging";
-    /** Data storage and persistence */
-    PluginCategory["STORAGE"] = "storage";
-    /** External notifications and alerts */
-    PluginCategory["NOTIFICATION"] = "notification";
-    /** Security and access control */
-    PluginCategory["SECURITY"] = "security";
-    /** Performance optimization */
-    PluginCategory["PERFORMANCE"] = "performance";
-    /** Error handling and recovery */
-    PluginCategory["ERROR_HANDLING"] = "error_handling";
-    /** Rate limiting and throttling */
-    PluginCategory["LIMITS"] = "limits";
-    /** Event processing and coordination */
-    PluginCategory["EVENT_PROCESSING"] = "event_processing";
-    /** Custom or specialized functionality */
-    PluginCategory["CUSTOM"] = "custom";
-})(PluginCategory || (PluginCategory = {}));
-/**
- * Plugin priority levels
- */
-export var PluginPriority;
-(function (PluginPriority) {
-    /** Highest priority - executed first */
-    PluginPriority[PluginPriority["CRITICAL"] = 1000] = "CRITICAL";
-    /** High priority */
-    PluginPriority[PluginPriority["HIGH"] = 800] = "HIGH";
-    /** Normal priority (default) */
-    PluginPriority[PluginPriority["NORMAL"] = 500] = "NORMAL";
-    /** Low priority */
-    PluginPriority[PluginPriority["LOW"] = 200] = "LOW";
-    /** Lowest priority - executed last */
-    PluginPriority[PluginPriority["MINIMAL"] = 100] = "MINIMAL";
-})(PluginPriority || (PluginPriority = {}));
-/**
- * Abstract class for all plugins with type parameter support
- * Provides plugin lifecycle management and common functionality
- *
- * Enhanced with:
- * - Plugin classification system (categories and priorities)
- * - EventEmitter integration for module event subscription
- * - Improved statistics tracking
- * - Better error handling and recovery
- *
+ * Abstract class for all plugins with type parameter support.
+ * Provides plugin lifecycle management and common functionality.
  * @template TOptions - Plugin options type that extends IPluginOptions
- * @template TStats - Plugin statistics type (defaults to IPluginStats for type safety)
+ * @template TStats - Plugin statistics type
  */
 export class AbstractPlugin {
-    /** Plugin enabled state */
     enabled = true;
-    /** Plugin category for classification */
     category = PluginCategory.CUSTOM;
-    /** Plugin priority for execution order */
     priority = PluginPriority.NORMAL;
-    /** Plugin options */
     options;
-    /** EventEmitter for module event subscription */
     eventEmitter;
-    /** Subscribed event types */
     subscribedEvents = [];
-    /** Event subscription handlers */
     eventHandlers = new Map();
-    /** Plugin statistics */
+    pluginLogger = createLogger('AbstractPlugin');
     stats = {
         calls: 0,
         errors: 0,
         moduleEventsReceived: 0,
-        lastActivity: undefined
+        lastActivity: undefined,
     };
-    /**
-     * Initialize the plugin with type-safe options
-     */
     async initialize(options) {
         this.options = options;
-        // Set enabled state from options with default fallback
-        if (options && 'enabled' in options && typeof options.enabled === 'boolean') {
+        if (options && 'enabled' in options && typeof options.enabled === 'boolean')
             this.enabled = options.enabled;
-        }
-        else {
-            this.enabled = true; // Default to enabled
-        }
-        // Set category from options
-        if (options?.category) {
+        else
+            this.enabled = true;
+        if (options?.category)
             this.category = options.category;
-        }
-        // Set priority from options
-        if (options?.priority !== undefined) {
-            this.priority = typeof options.priority === 'number'
-                ? options.priority
-                : options.priority;
-        }
-        // Default implementation - can be overridden
+        if (options?.priority !== undefined)
+            this.priority = typeof options.priority === 'number' ? options.priority : options.priority;
     }
-    /**
-     * Subscribe to module events through EventEmitter
-     */
     async subscribeToModuleEvents(eventEmitter) {
         this.eventEmitter = eventEmitter;
-        if (!this.options) {
+        if (!this.options)
             return;
-        }
         const eventsToSubscribe = [];
-        // Subscribe to all module events if requested
         if (this.options.subscribeToAllModuleEvents) {
             eventsToSubscribe.push(EVENT_EMITTER_EVENTS.MODULE_INITIALIZE_START, EVENT_EMITTER_EVENTS.MODULE_INITIALIZE_COMPLETE, EVENT_EMITTER_EVENTS.MODULE_INITIALIZE_ERROR, EVENT_EMITTER_EVENTS.MODULE_EXECUTION_START, EVENT_EMITTER_EVENTS.MODULE_EXECUTION_COMPLETE, EVENT_EMITTER_EVENTS.MODULE_EXECUTION_ERROR, EVENT_EMITTER_EVENTS.MODULE_DISPOSE_START, EVENT_EMITTER_EVENTS.MODULE_DISPOSE_COMPLETE, EVENT_EMITTER_EVENTS.MODULE_DISPOSE_ERROR);
         }
-        // Subscribe to specific events if specified
-        if (this.options.moduleEvents) {
+        if (this.options.moduleEvents)
             eventsToSubscribe.push(...this.options.moduleEvents);
-        }
-        // Subscribe to events (no deduplication; duplicates must surface for debugging)
         for (const eventType of eventsToSubscribe) {
             const handlerId = this.eventEmitter.on(eventType, async (eventData) => {
                 try {
@@ -127,76 +53,46 @@ export class AbstractPlugin {
                 }
                 catch (error) {
                     this.stats.errors++;
-                    // Log error but don't throw to avoid breaking event processing
-                    // Plugin failed to handle module event
+                    const safeError = error instanceof Error ? error : new Error(String(error));
+                    this.pluginLogger.error(`Plugin "${this.name}" failed to handle module event "${String(eventType)}"`, { plugin: this.name, eventType: String(eventType), error: safeError.message });
                 }
             });
             const existing = this.eventHandlers.get(eventType);
-            if (existing) {
+            if (existing)
                 existing.push(handlerId);
-            }
-            else {
+            else
                 this.eventHandlers.set(eventType, [handlerId]);
-            }
             this.subscribedEvents.push(eventType);
         }
     }
-    /**
-     * Unsubscribe from module events
-     */
     async unsubscribeFromModuleEvents(eventEmitter) {
         for (const [eventType, handlerIds] of this.eventHandlers.entries()) {
-            for (const handlerId of handlerIds) {
+            for (const handlerId of handlerIds)
                 eventEmitter.off(eventType, handlerId);
-            }
         }
         this.eventHandlers.clear();
         this.subscribedEvents = [];
         this.eventEmitter = undefined;
     }
-    /**
-     * Cleanup plugin resources
-     */
     async dispose() {
-        // Unsubscribe from events if subscribed
-        if (this.eventEmitter) {
+        if (this.eventEmitter)
             await this.unsubscribeFromModuleEvents(this.eventEmitter);
-        }
-        // Default implementation - can be overridden
     }
-    /**
-     * Enable the plugin
-     */
     enable() {
         this.enabled = true;
     }
-    /**
-     * Disable the plugin
-     */
     disable() {
         this.enabled = false;
     }
-    /**
-     * Check if plugin is enabled
-     */
     isEnabled() {
         return this.enabled;
     }
-    /**
-     * Get plugin configuration
-     */
     getConfig() {
         return {};
     }
-    /**
-     * Update plugin configuration
-     */
     updateConfig(_config) {
-        // Default implementation - can be overridden
+        /* override in subclass */
     }
-    /**
-     * Get plugin data - enhanced with classification information
-     */
     getData() {
         return {
             name: this.name,
@@ -208,48 +104,36 @@ export class AbstractPlugin {
             metadata: {
                 moduleEventsReceived: this.stats.moduleEventsReceived,
                 totalCalls: this.stats.calls,
-                totalErrors: this.stats.errors
-            }
+                totalErrors: this.stats.errors,
+            },
         };
     }
-    /**
-     * Get plugin status - enhanced with classification information
-     */
     getStatus() {
         return {
             name: this.name,
             version: this.version,
             enabled: this.enabled,
-            initialized: true, // Can be overridden by plugins to track initialization state
+            initialized: true,
             category: this.category,
             priority: this.priority,
             subscribedEventsCount: this.subscribedEvents.length,
-            hasEventEmitter: !!this.eventEmitter
+            hasEventEmitter: !!this.eventEmitter,
         };
     }
-    /**
-     * Get plugin statistics - enhanced with module event tracking
-     */
     getStats() {
         const baseStats = {
             enabled: this.enabled,
             calls: this.stats.calls,
             errors: this.stats.errors,
             moduleEventsReceived: this.stats.moduleEventsReceived,
-            ...(this.stats.lastActivity && { lastActivity: this.stats.lastActivity })
+            ...(this.stats.lastActivity && { lastActivity: this.stats.lastActivity }),
         };
         return baseStats;
     }
-    /**
-     * Update plugin call statistics
-     */
     updateCallStats() {
         this.stats.calls++;
         this.stats.lastActivity = new Date();
     }
-    /**
-     * Update plugin error statistics
-     */
     updateErrorStats() {
         this.stats.errors++;
         this.stats.lastActivity = new Date();