@robota-sdk/agent-core 3.0.0-beta.4 → 3.0.0-beta.43

package/dist/plugins/event-emitter-plugin.d.ts

@@ -1,222 +0,0 @@
-import { AbstractPlugin, type IPluginExecutionContext, type IPluginExecutionResult, type IPluginErrorContext, type IPluginOptions, type IPluginStats } from '../abstracts/abstract-plugin';
-import type { IToolExecutionContext, TToolParameters, IToolResult } from '../interfaces/tool';
-import { type IEventEmitterEventData, type TEventName, type TEventEmitterListener } from './event-emitter/types';
-import { type IEventEmitterMetrics } from './event-emitter/metrics';
-export type { TEventName };
-/**
- * Basic event execution value types - compatible with IPluginExecutionResult
- */
-export type TEventExecutionValue = string | number | boolean | Date | string[] | number[] | boolean[] | Record<string, string | number | boolean | null> | null | undefined;
-/**
- * Event execution context data following semantic naming conventions
- * Supports nested structures with proper type safety
- */
-export interface IEventExecutionContextData {
-    messageCount?: number | undefined;
-    config?: Record<string, TEventExecutionValue> | undefined;
-    result?: IPluginExecutionResult | undefined;
-    duration?: number | undefined;
-    tokensUsed?: number | undefined;
-    toolsExecuted?: number | undefined;
-    messages?: Record<string, TEventExecutionValue>[] | undefined;
-    response?: string | undefined;
-    toolCalls?: Record<string, TEventExecutionValue>[] | undefined;
-    [key: string]: TEventExecutionValue | Record<string, TEventExecutionValue> | Record<string, TEventExecutionValue>[] | IPluginExecutionResult | undefined;
-}
-/**
- * Event metadata following semantic naming conventions
- */
-export type TEventEmitterMetadata = Record<string, string | number | boolean | Date | string[] | number[] | undefined>;
-/**
- * Plugin execution context for event emitter
- */
-export interface IEventEmitterPluginExecutionContext extends IPluginExecutionContext {
-}
-/**
- * Plugin execution result for event emitter
- */
-export interface IEventEmitterPluginExecutionResult {
-    content?: string;
-    response?: string;
-    duration?: number;
-    tokensUsed?: number;
-    toolsExecuted?: number;
-    usage?: Record<string, TEventExecutionValue>;
-    toolCalls?: Record<string, TEventExecutionValue>[];
-    [key: string]: TEventExecutionValue | Record<string, TEventExecutionValue> | Record<string, TEventExecutionValue>[] | undefined;
-}
-/**
- * Event data structure
- */
-export type { IEventEmitterEventData };
-/**
- * 🆕 Enhanced event data for hierarchical execution tracking
- * Extends IEventEmitterEventData with additional fields for parent-child relationships and real-time data
- */
-export interface IEventEmitterHierarchicalEventData extends IEventEmitterEventData {
-    /** Parent execution ID for hierarchical tracking */
-    parentExecutionId?: string;
-    /** Root execution ID (Team/Agent level) */
-    rootExecutionId?: string;
-    /** Execution depth level (0: Team, 1: Agent, 2: Tool, etc.) */
-    executionLevel: number;
-    /** Execution path showing complete hierarchy */
-    executionPath: string[];
-    /** Real-time execution data (no simulation) */
-    realTimeData?: {
-        /** Actual execution start time */
-        startTime: Date;
-        /** Actual duration in milliseconds (when completed) */
-        actualDuration?: number;
-        /** Actual input parameters */
-        actualParameters?: TToolParameters;
-        /** Actual execution result */
-        actualResult?: IToolResult;
-    };
-}
-/**
- * Event listener function
- */
-export type { TEventEmitterListener };
-/**
- * Event emitter configuration
- */
-export interface IEventEmitterPluginOptions extends IPluginOptions {
-    /** Events to listen for */
-    events?: TEventName[];
-    /** Maximum number of listeners per event type */
-    maxListeners?: number;
-    /** Whether to emit events asynchronously */
-    async?: boolean;
-    /** Whether to catch and log listener errors */
-    catchErrors?: boolean;
-    /** Custom event filters */
-    filters?: Record<TEventName, (event: IEventEmitterEventData) => boolean>;
-    /** Event buffering options */
-    buffer?: {
-        enabled: boolean;
-        maxSize: number;
-        flushInterval: number;
-    };
-    /** Metrics collector (optional) */
-    metrics?: IEventEmitterMetrics;
-}
-/**
- * Event emitter plugin statistics
- */
-export interface IEventEmitterPluginStats extends IPluginStats {
-    eventTypes: TEventName[];
-    listenerCounts: Record<TEventName, number>;
-    totalListeners: number;
-    bufferedEvents: number;
-    totalEmitted: number;
-    totalErrors: number;
-}
-/**
- * Plugin for event detection and propagation
- * Emits events during agent execution lifecycle
- */
-export declare class EventEmitterPlugin extends AbstractPlugin<IEventEmitterPluginOptions, IEventEmitterPluginStats> {
-    name: string;
-    version: string;
-    private pluginOptions;
-    private logger;
-    private handlers;
-    private eventBuffer;
-    private nextHandlerId;
-    private bufferTimer?;
-    private metrics;
-    constructor(options?: IEventEmitterPluginOptions);
-    /**
-     * Before execution starts
-     */
-    beforeExecution(context: IPluginExecutionContext): Promise<void>;
-    /**
-     * After execution completes
-     */
-    afterExecution(context: IPluginExecutionContext, result: IPluginExecutionResult): Promise<void>;
-    /**
-     * Before conversation starts
-     */
-    beforeConversation(context: IPluginExecutionContext): Promise<void>;
-    /**
-     * After conversation completes
-     */
-    afterConversation(context: IPluginExecutionContext, result: IPluginExecutionResult): Promise<void>;
-    /**
-     * Before tool execution - emits tool.beforeExecute event
-     */
-    beforeToolExecution(context: IPluginExecutionContext, toolData: IToolExecutionContext): Promise<void>;
-    /**
-     * After tool execution - emits tool.success or tool.error events
-     */
-    afterToolExecution(context: IPluginExecutionContext, toolResults: IPluginExecutionResult): Promise<void>;
-    /**
-     * On error
-     *
-     * REASON: Error context structure varies by execution phase and error type, needs flexible handling
-     * ALTERNATIVES_CONSIDERED:
-     * 1. Strict error context interface (breaks error handling flexibility)
-     * 2. Union types (insufficient for dynamic error contexts)
-     * 3. Generic constraints (too complex for error handling)
-     * 4. Interface definitions (too rigid for varied error contexts)
-     * 5. Type assertions (decreases type safety)
-     * TODO: Consider standardized error context interface
-     */
-    onError(error: Error, context?: IPluginErrorContext): Promise<void>;
-    /**
-     * Register event listener
-     */
-    on(eventType: TEventName, listener: TEventEmitterListener, options?: {
-        once?: boolean;
-        filter?: (event: IEventEmitterEventData) => boolean;
-    }): string;
-    /**
-     * Register one-time event listener
-     */
-    once(eventType: TEventName, listener: TEventEmitterListener, filter?: (event: IEventEmitterEventData) => boolean): string;
-    /**
-     * Remove event listener
-     */
-    off(eventType: TEventName, handlerIdOrListener: string | TEventEmitterListener): boolean;
-    /**
-     * Emit an event
-     */
-    emit(eventType: TEventName, eventData?: Partial<IEventEmitterEventData>): Promise<void>;
-    /**
-     * Process a single event
-     */
-    private processEvent;
-    private executeHandler;
-    /**
-     * Buffer an event
-     */
-    private bufferEvent;
-    /**
-     * Setup event buffering
-     */
-    private setupBuffering;
-    /**
-     * Flush buffered events
-     */
-    flushBuffer(): Promise<void>;
-    /**
-     * Get event emitter statistics
-     */
-    getStats(): IEventEmitterPluginStats;
-    /**
-     * Clear all listeners
-     */
-    clearAllListeners(): void;
-    /**
-     * Cleanup on plugin destruction
-     */
-    destroy(): Promise<void>;
-    /**
-     * Validates the plugin options.
-     * @param options The options to validate.
-     * @throws PluginError if options are invalid.
-     */
-    private validateOptions;
-}
-//# sourceMappingURL=event-emitter-plugin.d.ts.map

package/dist/plugins/event-emitter-plugin.d.ts.map

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

package/dist/plugins/event-emitter-plugin.js

@@ -1,432 +0,0 @@
-import { AbstractPlugin, PluginCategory, PluginPriority } from '../abstracts/abstract-plugin';
-import { createLogger } from '../utils/logger';
-import { PluginError } from '../utils/errors';
-import { EVENT_EMITTER_EVENTS } from './event-emitter/types';
-import { InMemoryEventEmitterMetrics } from './event-emitter/metrics';
-/**
- * Plugin for event detection and propagation
- * Emits events during agent execution lifecycle
- */
-export class EventEmitterPlugin extends AbstractPlugin {
-    name = 'EventEmitterPlugin';
-    version = '1.0.0';
-    pluginOptions;
-    logger;
-    handlers = new Map();
-    eventBuffer = [];
-    nextHandlerId = 1;
-    bufferTimer;
-    metrics;
-    constructor(options = {}) {
-        super();
-        this.logger = createLogger('EventEmitterPlugin');
-        this.metrics = options.metrics ?? new InMemoryEventEmitterMetrics();
-        // Validate options
-        this.validateOptions(options);
-        this.pluginOptions = {
-            enabled: options.enabled ?? true,
-            events: options.events ?? [
-                EVENT_EMITTER_EVENTS.AGENT_EXECUTION_START,
-                EVENT_EMITTER_EVENTS.AGENT_EXECUTION_COMPLETE,
-                EVENT_EMITTER_EVENTS.AGENT_EXECUTION_ERROR,
-                EVENT_EMITTER_EVENTS.TOOL_BEFORE_EXECUTE,
-                EVENT_EMITTER_EVENTS.TOOL_AFTER_EXECUTE,
-                EVENT_EMITTER_EVENTS.TOOL_SUCCESS,
-                EVENT_EMITTER_EVENTS.TOOL_ERROR
-            ],
-            maxListeners: options.maxListeners ?? 100,
-            async: options.async ?? true,
-            catchErrors: options.catchErrors ?? true,
-            filters: options.filters ?? {},
-            buffer: options.buffer ?? {
-                enabled: false,
-                maxSize: 1000,
-                flushInterval: 5000
-            },
-            // Add plugin options defaults
-            category: options.category ?? PluginCategory.EVENT_PROCESSING,
-            priority: options.priority ?? PluginPriority.HIGH,
-            moduleEvents: options.moduleEvents ?? [],
-            subscribeToAllModuleEvents: options.subscribeToAllModuleEvents ?? false
-        };
-        if (this.pluginOptions.buffer.enabled) {
-            this.setupBuffering();
-        }
-        this.logger.info('EventEmitterPlugin initialized', {
-            events: this.pluginOptions.events,
-            maxListeners: this.pluginOptions.maxListeners,
-            async: this.pluginOptions.async,
-            catchErrors: this.pluginOptions.catchErrors,
-            bufferEnabled: this.pluginOptions.buffer.enabled
-        });
-    }
-    /**
-     * Before execution starts
-     */
-    async beforeExecution(context) {
-        await this.emit(EVENT_EMITTER_EVENTS.AGENT_EXECUTION_START, {
-            executionId: context.executionId,
-            sessionId: context.sessionId,
-            userId: context.userId,
-            data: {
-                messageCount: context.messages?.length || 0,
-                ...(context.config && { config: context.config })
-            }
-        });
-    }
-    /**
-     * After execution completes
-     */
-    async afterExecution(context, result) {
-        await this.emit(EVENT_EMITTER_EVENTS.AGENT_EXECUTION_COMPLETE, {
-            executionId: context.executionId,
-            sessionId: context.sessionId,
-            userId: context.userId,
-            data: {
-                duration: result?.duration,
-                tokensUsed: result?.tokensUsed,
-                toolsExecuted: result?.toolsExecuted
-            }
-        });
-    }
-    /**
-     * Before conversation starts
-     */
-    async beforeConversation(context) {
-        await this.emit(EVENT_EMITTER_EVENTS.CONVERSATION_START, {
-            executionId: context.executionId,
-            sessionId: context.sessionId,
-            userId: context.userId,
-            data: {
-                messages: context.messages?.map(msg => ({
-                    role: msg.role,
-                    content: msg.content || '',
-                    timestamp: msg.timestamp ? msg.timestamp.toISOString() : new Date().toISOString()
-                })),
-                config: context.config
-            }
-        });
-    }
-    /**
-     * After conversation completes
-     */
-    async afterConversation(context, result) {
-        await this.emit(EVENT_EMITTER_EVENTS.CONVERSATION_COMPLETE, {
-            executionId: context.executionId,
-            sessionId: context.sessionId,
-            userId: context.userId,
-            data: {
-                response: result.content || result.response,
-                tokensUsed: result.usage?.totalTokens || result.tokensUsed,
-                toolCalls: result.toolCalls?.map(call => ({
-                    id: call.id || '',
-                    name: call.name || '',
-                    arguments: JSON.stringify(call.arguments || {}),
-                    result: String(call.result || '')
-                }))
-            }
-        });
-    }
-    /**
-     * Before tool execution - emits tool.beforeExecute event
-     */
-    async beforeToolExecution(context, toolData) {
-        if (!toolData) {
-            return;
-        }
-        const toolCalls = [toolData];
-        for (const toolCall of toolCalls) {
-            await this.emit(EVENT_EMITTER_EVENTS.TOOL_BEFORE_EXECUTE, {
-                executionId: context.executionId,
-                sessionId: context.sessionId,
-                userId: context.userId,
-                data: {
-                    toolName: toolCall.toolName,
-                    toolId: toolCall.executionId,
-                    arguments: JSON.stringify(toolCall.parameters ?? {})
-                }
-            });
-        }
-    }
-    /**
-     * After tool execution - emits tool.success or tool.error events
-     */
-    async afterToolExecution(context, toolResults) {
-        // Handle tool results from IPluginExecutionResult
-        if (toolResults.toolCalls && toolResults.toolCalls.length > 0) {
-            for (const toolCall of toolResults.toolCalls) {
-                const eventType = toolCall.result === null ? EVENT_EMITTER_EVENTS.TOOL_ERROR : EVENT_EMITTER_EVENTS.TOOL_SUCCESS;
-                await this.emit(eventType, {
-                    executionId: context.executionId,
-                    sessionId: context.sessionId,
-                    userId: context.userId,
-                    data: {
-                        toolName: toolCall.name || '',
-                        toolId: toolCall.id || '',
-                        toolResult: toolCall.result !== null ? String(toolCall.result) : undefined,
-                        duration: toolResults.duration,
-                        success: toolCall.result !== null
-                    }
-                });
-                // Also emit generic afterExecute event
-                await this.emit(EVENT_EMITTER_EVENTS.TOOL_AFTER_EXECUTE, {
-                    executionId: context.executionId,
-                    sessionId: context.sessionId,
-                    userId: context.userId,
-                    data: {
-                        toolName: toolCall.name || '',
-                        toolId: toolCall.id || '',
-                        toolResult: String(toolCall.result || ''),
-                        duration: toolResults.duration,
-                        success: toolCall.result !== null
-                    }
-                });
-            }
-        }
-    }
-    /**
-     * On error
-     *
-     * REASON: Error context structure varies by execution phase and error type, needs flexible handling
-     * ALTERNATIVES_CONSIDERED:
-     * 1. Strict error context interface (breaks error handling flexibility)
-     * 2. Union types (insufficient for dynamic error contexts)
-     * 3. Generic constraints (too complex for error handling)
-     * 4. Interface definitions (too rigid for varied error contexts)
-     * 5. Type assertions (decreases type safety)
-     * TODO: Consider standardized error context interface
-     */
-    async onError(error, context) {
-        await this.emit(EVENT_EMITTER_EVENTS.AGENT_EXECUTION_ERROR, {
-            executionId: context?.executionId,
-            sessionId: context?.sessionId,
-            userId: context?.userId,
-            error: error instanceof Error ? error : new Error(String(error)),
-            data: {
-                action: context?.action,
-                tool: context?.tool,
-                attempt: context?.attempt
-            }
-        });
-    }
-    /**
-     * Register event listener
-     */
-    on(eventType, listener, options) {
-        const handlerId = `handler_${this.nextHandlerId++}`;
-        if (!this.handlers.has(eventType)) {
-            this.handlers.set(eventType, []);
-        }
-        const handlers = this.handlers.get(eventType);
-        if (handlers.length >= this.pluginOptions.maxListeners) {
-            throw new PluginError(`Maximum listeners (${this.pluginOptions.maxListeners}) exceeded for event type: ${eventType}`, this.name, { eventType, currentListeners: handlers.length });
-        }
-        handlers.push({
-            id: handlerId,
-            listener,
-            once: options?.once ?? false,
-            ...(options?.filter && { filter: options.filter })
-        });
-        this.logger.debug('Event listener registered', {
-            eventType,
-            handlerId,
-            once: options?.once ?? false,
-            hasFilter: options?.filter ? true : false
-        });
-        return handlerId;
-    }
-    /**
-     * Register one-time event listener
-     */
-    once(eventType, listener, filter) {
-        return this.on(eventType, listener, {
-            once: true,
-            ...(filter && { filter })
-        });
-    }
-    /**
-     * Remove event listener
-     */
-    off(eventType, handlerIdOrListener) {
-        const handlers = this.handlers.get(eventType);
-        if (!handlers) {
-            return false;
-        }
-        const index = typeof handlerIdOrListener === 'string'
-            ? handlers.findIndex(h => h.id === handlerIdOrListener)
-            : handlers.findIndex(h => h.listener === handlerIdOrListener);
-        if (index !== -1) {
-            const removed = handlers.splice(index, 1)[0];
-            if (removed) {
-                this.logger.debug('Event listener removed', {
-                    eventType,
-                    handlerId: removed.id
-                });
-            }
-            return true;
-        }
-        return false;
-    }
-    /**
-     * Emit an event
-     */
-    async emit(eventType, eventData = {}) {
-        if (!this.pluginOptions.events.includes(eventType)) {
-            return;
-        }
-        const event = {
-            type: eventType,
-            timestamp: new Date(),
-            ...eventData
-        };
-        // Apply global filter if exists
-        const globalFilter = this.pluginOptions.filters[eventType];
-        if (globalFilter && !globalFilter(event)) {
-            return;
-        }
-        this.metrics.incrementEmitted();
-        // Buffer events if enabled
-        if (this.pluginOptions.buffer.enabled) {
-            this.bufferEvent(event);
-            return;
-        }
-        await this.processEvent(event);
-    }
-    /**
-     * Process a single event
-     */
-    async processEvent(event) {
-        const handlers = this.handlers.get(event.type);
-        if (!handlers || handlers.length === 0) {
-            return;
-        }
-        const handlersToCall = handlers.filter(handler => {
-            return !handler.filter || handler.filter(event);
-        });
-        if (handlersToCall.length === 0) {
-            return;
-        }
-        this.logger.debug('Emitting event', {
-            type: event.type,
-            handlersCount: handlersToCall.length,
-            executionId: event.executionId || 'undefined'
-        });
-        // Remove one-time handlers
-        const oneTimeHandlers = handlersToCall.filter(h => h.once);
-        for (const handler of oneTimeHandlers) {
-            this.off(event.type, handler.id);
-        }
-        // Execute handlers without fallback path.
-        if (this.pluginOptions.async) {
-            await Promise.all(handlersToCall.map(handler => this.executeHandler(handler, event)));
-            return;
-        }
-        for (const handler of handlersToCall) {
-            await this.executeHandler(handler, event);
-        }
-    }
-    async executeHandler(handler, event) {
-        try {
-            await handler.listener(event);
-        }
-        catch (error) {
-            this.metrics.incrementErrors();
-            if (this.pluginOptions.catchErrors) {
-                this.logger.error('Event handler error', {
-                    eventType: event.type,
-                    handlerId: handler.id,
-                    error: error instanceof Error ? error.message : String(error)
-                });
-            }
-            throw error instanceof Error ? error : new Error(String(error));
-        }
-    }
-    /**
-     * Buffer an event
-     */
-    bufferEvent(event) {
-        this.eventBuffer.push(event);
-        if (this.eventBuffer.length >= this.pluginOptions.buffer.maxSize) {
-            this.flushBuffer();
-        }
-    }
-    /**
-     * Setup event buffering
-     */
-    setupBuffering() {
-        this.bufferTimer = setInterval(() => {
-            this.flushBuffer();
-        }, this.pluginOptions.buffer.flushInterval);
-    }
-    /**
-     * Flush buffered events
-     */
-    async flushBuffer() {
-        if (this.eventBuffer.length === 0) {
-            return;
-        }
-        const events = [...this.eventBuffer];
-        this.eventBuffer = [];
-        this.logger.debug('Flushing event buffer', { eventCount: events.length });
-        for (const event of events) {
-            await this.processEvent(event);
-        }
-    }
-    /**
-     * Get event emitter statistics
-     */
-    getStats() {
-        const base = super.getStats();
-        const metrics = this.metrics.getSnapshot();
-        const listenerCounts = {};
-        let totalListeners = 0;
-        for (const [eventType, handlers] of this.handlers) {
-            listenerCounts[eventType] = handlers.length;
-            totalListeners += handlers.length;
-        }
-        return {
-            ...base,
-            eventTypes: Array.from(this.handlers.keys()),
-            listenerCounts,
-            totalListeners,
-            bufferedEvents: this.eventBuffer.length,
-            totalEmitted: metrics.totalEmitted,
-            totalErrors: metrics.totalErrors
-        };
-    }
-    /**
-     * Clear all listeners
-     */
-    clearAllListeners() {
-        this.handlers.clear();
-        this.logger.info('All event listeners cleared');
-    }
-    /**
-     * Cleanup on plugin destruction
-     */
-    async destroy() {
-        if (this.bufferTimer) {
-            clearInterval(this.bufferTimer);
-        }
-        await this.flushBuffer();
-        this.clearAllListeners();
-        this.logger.info('EventEmitterPlugin destroyed');
-    }
-    /**
-     * Validates the plugin options.
-     * @param options The options to validate.
-     * @throws PluginError if options are invalid.
-     */
-    validateOptions(options) {
-        if (options.maxListeners !== undefined && options.maxListeners < 0) {
-            throw new PluginError(`Invalid maxListeners option: ${options.maxListeners}. Must be a non-negative number.`, this.name, { maxListeners: options.maxListeners });
-        }
-        if (options.buffer !== undefined && options.buffer.maxSize !== undefined && options.buffer.maxSize < 0) {
-            throw new PluginError(`Invalid buffer.maxSize option: ${options.buffer.maxSize}. Must be a non-negative number.`, this.name, { bufferMaxSize: options.buffer.maxSize });
-        }
-        if (options.buffer !== undefined && options.buffer.flushInterval !== undefined && options.buffer.flushInterval < 0) {
-            throw new PluginError(`Invalid buffer.flushInterval option: ${options.buffer.flushInterval}. Must be a non-negative number.`, this.name, { bufferFlushInterval: options.buffer.flushInterval });
-        }
-    }
-}
-//# sourceMappingURL=event-emitter-plugin.js.map