@robota-sdk/agent-core 3.0.0-beta.33 → 3.0.0-beta.34

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

@@ -1,152 +0,0 @@
-/**
- * Type definitions for AbstractPlugin.
- *
- * Extracted from abstract-plugin.ts to keep each file under 300 lines.
- */
-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';
-/** Plugin categories for classification */
-export declare enum PluginCategory {
-    MONITORING = "monitoring",
-    LOGGING = "logging",
-    STORAGE = "storage",
-    NOTIFICATION = "notification",
-    SECURITY = "security",
-    PERFORMANCE = "performance",
-    ERROR_HANDLING = "error_handling",
-    LIMITS = "limits",
-    EVENT_PROCESSING = "event_processing",
-    CUSTOM = "custom"
-}
-/** Plugin priority levels */
-export declare enum PluginPriority {
-    CRITICAL = 1000,
-    HIGH = 800,
-    NORMAL = 500,
-    LOW = 200,
-    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 */
-export interface IPluginOptions {
-    enabled?: boolean;
-    category?: PluginCategory;
-    priority?: PluginPriority | number;
-    moduleEvents?: TEventName[];
-    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 */
-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 {
-    beforeRun?(input: string, options?: IRunOptions): Promise<void> | void;
-    afterRun?(input: string, response: string, options?: IRunOptions): Promise<void> | void;
-    beforeExecution?(context: IPluginExecutionContext): Promise<void> | void;
-    afterExecution?(context: IPluginExecutionContext, result: IPluginExecutionResult): Promise<void> | void;
-    beforeConversation?(context: IPluginExecutionContext): Promise<void> | void;
-    afterConversation?(context: IPluginExecutionContext, result: IPluginExecutionResult): Promise<void> | void;
-    beforeToolCall?(toolName: string, parameters: TToolParameters): Promise<void> | void;
-    beforeToolExecution?(context: IPluginExecutionContext, toolData: IToolExecutionContext): Promise<void> | void;
-    afterToolCall?(toolName: string, parameters: TToolParameters, result: IToolExecutionResult): Promise<void> | void;
-    afterToolExecution?(context: IPluginExecutionContext, toolResults: IPluginExecutionResult): Promise<void> | void;
-    beforeProviderCall?(messages: TUniversalMessage[]): Promise<void> | void;
-    afterProviderCall?(messages: TUniversalMessage[], response: TUniversalMessage): Promise<void> | void;
-    onStreamingChunk?(chunk: TUniversalMessage): Promise<void> | void;
-    onError?(error: Error, context?: IPluginErrorContext): Promise<void> | void;
-    onMessageAdded?(message: TUniversalMessage): Promise<void> | void;
-    onModuleEvent?(eventName: TEventName, eventData: IEventEmitterEventData): Promise<void> | void;
-}
-//# sourceMappingURL=abstract-plugin-types.d.ts.map

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

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

package/dist/abstracts/abstract-plugin-types.js

@@ -1,29 +0,0 @@
-/** Plugin categories for classification */
-export var PluginCategory;
-(function (PluginCategory) {
-    PluginCategory["MONITORING"] = "monitoring";
-    PluginCategory["LOGGING"] = "logging";
-    PluginCategory["STORAGE"] = "storage";
-    PluginCategory["NOTIFICATION"] = "notification";
-    PluginCategory["SECURITY"] = "security";
-    PluginCategory["PERFORMANCE"] = "performance";
-    PluginCategory["ERROR_HANDLING"] = "error_handling";
-    PluginCategory["LIMITS"] = "limits";
-    PluginCategory["EVENT_PROCESSING"] = "event_processing";
-    PluginCategory["CUSTOM"] = "custom";
-})(PluginCategory || (PluginCategory = {}));
-const PRIORITY_CRITICAL = 1000;
-const PRIORITY_HIGH = 800;
-const PRIORITY_NORMAL = 500;
-const PRIORITY_LOW = 200;
-const PRIORITY_MINIMAL = 100;
-/** Plugin priority levels */
-export var PluginPriority;
-(function (PluginPriority) {
-    PluginPriority[PluginPriority["CRITICAL"] = 1000] = "CRITICAL";
-    PluginPriority[PluginPriority["HIGH"] = 800] = "HIGH";
-    PluginPriority[PluginPriority["NORMAL"] = 500] = "NORMAL";
-    PluginPriority[PluginPriority["LOW"] = 200] = "LOW";
-    PluginPriority[PluginPriority["MINIMAL"] = 100] = "MINIMAL";
-})(PluginPriority || (PluginPriority = {}));
-//# sourceMappingURL=abstract-plugin-types.js.map

package/dist/abstracts/abstract-plugin-types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"abstract-plugin-types.js","sourceRoot":"","sources":["../../src/abstracts/abstract-plugin-types.ts"],"names":[],"mappings":"AAkBA,2CAA2C;AAC3C,MAAM,CAAN,IAAY,cAWX;AAXD,WAAY,cAAc;IACxB,2CAAyB,CAAA;IACzB,qCAAmB,CAAA;IACnB,qCAAmB,CAAA;IACnB,+CAA6B,CAAA;IAC7B,uCAAqB,CAAA;IACrB,6CAA2B,CAAA;IAC3B,mDAAiC,CAAA;IACjC,mCAAiB,CAAA;IACjB,uDAAqC,CAAA;IACrC,mCAAiB,CAAA;AACnB,CAAC,EAXW,cAAc,KAAd,cAAc,QAWzB;AAED,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAC/B,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,MAAM,eAAe,GAAG,GAAG,CAAC;AAC5B,MAAM,YAAY,GAAG,GAAG,CAAC;AACzB,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B,6BAA6B;AAC7B,MAAM,CAAN,IAAY,cAMX;AAND,WAAY,cAAc;IACxB,8DAA4B,CAAA;IAC5B,qDAAoB,CAAA;IACpB,yDAAwB,CAAA;IACxB,mDAAkB,CAAA;IAClB,2DAA0B,CAAA;AAC5B,CAAC,EANW,cAAc,KAAd,cAAc,QAMzB"}

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

@@ -1,80 +0,0 @@
-/**
- * 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 };
-/**
- * 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
- */
-export declare abstract class AbstractPlugin<TOptions extends IPluginOptions = IPluginOptions, TStats extends IPluginStats = IPluginStats> implements IPluginContract<TOptions, TStats>, IPluginHooks {
-    abstract readonly name: string;
-    abstract readonly version: string;
-    enabled: boolean;
-    category: PluginCategory;
-    priority: number;
-    protected options: TOptions | undefined;
-    protected eventEmitter: IEventEmitterPlugin | undefined;
-    protected subscribedEvents: TEventName[];
-    protected eventHandlers: Map<TEventName, string[]>;
-    protected readonly pluginLogger: ILogger;
-    protected stats: {
-        calls: number;
-        errors: number;
-        moduleEventsReceived: number;
-        lastActivity: Date | undefined;
-    };
-    initialize(options?: TOptions): Promise<void>;
-    subscribeToModuleEvents(eventEmitter: IEventEmitterPlugin): Promise<void>;
-    unsubscribeFromModuleEvents(eventEmitter: IEventEmitterPlugin): Promise<void>;
-    dispose(): Promise<void>;
-    enable(): void;
-    disable(): void;
-    isEnabled(): boolean;
-    getConfig(): IPluginConfig;
-    updateConfig(_config: IPluginConfig): void;
-    getData(): IPluginData;
-    clearData?(): void;
-    getStatus(): {
-        name: string;
-        version: string;
-        enabled: boolean;
-        initialized: boolean;
-        category: PluginCategory;
-        priority: number;
-        subscribedEventsCount: number;
-        hasEventEmitter: boolean;
-    };
-    getStats(): TStats;
-    protected updateCallStats(): void;
-    protected updateErrorStats(): void;
-    beforeRun?(input: string, options?: IRunOptions): Promise<void>;
-    afterRun?(input: string, response: string, options?: IRunOptions): Promise<void>;
-    beforeExecution?(context: IPluginExecutionContext): Promise<void>;
-    afterExecution?(context: IPluginExecutionContext, result: IPluginExecutionResult): Promise<void>;
-    beforeConversation?(context: IPluginExecutionContext): Promise<void>;
-    afterConversation?(context: IPluginExecutionContext, result: IPluginExecutionResult): Promise<void>;
-    beforeToolCall?(toolName: string, parameters: TToolParameters): Promise<void>;
-    beforeToolExecution?(context: IPluginExecutionContext, toolData: IToolExecutionContext): Promise<void>;
-    afterToolCall?(toolName: string, parameters: TToolParameters, result: IToolExecutionResult): Promise<void>;
-    afterToolExecution?(context: IPluginExecutionContext, toolResults: IPluginExecutionResult): Promise<void>;
-    beforeProviderCall?(messages: TUniversalMessage[]): Promise<void>;
-    afterProviderCall?(messages: TUniversalMessage[], response: TUniversalMessage): Promise<void>;
-    onStreamingChunk?(chunk: TUniversalMessage): Promise<void>;
-    onError?(error: Error, context?: IPluginErrorContext): Promise<void>;
-    onMessageAdded?(message: TUniversalMessage): Promise<void>;
-    onModuleEvent?(eventName: TEventName, eventData: IEventEmitterEventData): Promise<void>;
-}
-//# sourceMappingURL=abstract-plugin.d.ts.map

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

@@ -1 +0,0 @@
-{"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,142 +0,0 @@
-import { EVENT_EMITTER_EVENTS } from '../plugins/event-emitter/types';
-import { createLogger } from '../utils/logger';
-import { PluginCategory, PluginPriority } from './abstract-plugin-types';
-export { PluginCategory, PluginPriority };
-/**
- * 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
- */
-export class AbstractPlugin {
-    enabled = true;
-    category = PluginCategory.CUSTOM;
-    priority = PluginPriority.NORMAL;
-    options;
-    eventEmitter;
-    subscribedEvents = [];
-    eventHandlers = new Map();
-    pluginLogger = createLogger('AbstractPlugin');
-    stats = {
-        calls: 0,
-        errors: 0,
-        moduleEventsReceived: 0,
-        lastActivity: undefined,
-    };
-    async initialize(options) {
-        this.options = options;
-        if (options && 'enabled' in options && typeof options.enabled === 'boolean')
-            this.enabled = options.enabled;
-        else
-            this.enabled = true;
-        if (options?.category)
-            this.category = options.category;
-        if (options?.priority !== undefined)
-            this.priority = typeof options.priority === 'number' ? options.priority : options.priority;
-    }
-    async subscribeToModuleEvents(eventEmitter) {
-        this.eventEmitter = eventEmitter;
-        if (!this.options)
-            return;
-        const eventsToSubscribe = [];
-        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);
-        }
-        if (this.options.moduleEvents)
-            eventsToSubscribe.push(...this.options.moduleEvents);
-        for (const eventType of eventsToSubscribe) {
-            const handlerId = this.eventEmitter.on(eventType, async (eventData) => {
-                try {
-                    this.stats.moduleEventsReceived++;
-                    this.stats.lastActivity = new Date();
-                    await this.onModuleEvent?.(eventType, eventData);
-                }
-                catch (error) {
-                    this.stats.errors++;
-                    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)
-                existing.push(handlerId);
-            else
-                this.eventHandlers.set(eventType, [handlerId]);
-            this.subscribedEvents.push(eventType);
-        }
-    }
-    async unsubscribeFromModuleEvents(eventEmitter) {
-        for (const [eventType, handlerIds] of this.eventHandlers.entries()) {
-            for (const handlerId of handlerIds)
-                eventEmitter.off(eventType, handlerId);
-        }
-        this.eventHandlers.clear();
-        this.subscribedEvents = [];
-        this.eventEmitter = undefined;
-    }
-    async dispose() {
-        if (this.eventEmitter)
-            await this.unsubscribeFromModuleEvents(this.eventEmitter);
-    }
-    enable() {
-        this.enabled = true;
-    }
-    disable() {
-        this.enabled = false;
-    }
-    isEnabled() {
-        return this.enabled;
-    }
-    getConfig() {
-        return {};
-    }
-    updateConfig(_config) {
-        /* override in subclass */
-    }
-    getData() {
-        return {
-            name: this.name,
-            version: this.version,
-            enabled: this.enabled,
-            category: this.category,
-            priority: this.priority,
-            subscribedEvents: [...this.subscribedEvents],
-            metadata: {
-                moduleEventsReceived: this.stats.moduleEventsReceived,
-                totalCalls: this.stats.calls,
-                totalErrors: this.stats.errors,
-            },
-        };
-    }
-    getStatus() {
-        return {
-            name: this.name,
-            version: this.version,
-            enabled: this.enabled,
-            initialized: true,
-            category: this.category,
-            priority: this.priority,
-            subscribedEventsCount: this.subscribedEvents.length,
-            hasEventEmitter: !!this.eventEmitter,
-        };
-    }
-    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 }),
-        };
-        return baseStats;
-    }
-    updateCallStats() {
-        this.stats.calls++;
-        this.stats.lastActivity = new Date();
-    }
-    updateErrorStats() {
-        this.stats.errors++;
-        this.stats.lastActivity = new Date();
-    }
-}
-//# sourceMappingURL=abstract-plugin.js.map

package/dist/abstracts/abstract-plugin.js.map

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

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

@@ -1,175 +0,0 @@
-/**
- * @fileoverview Abstract Tool Base Class
- *
- * 🎯 ABSTRACT CLASS - DO NOT DEPEND ON CONCRETE IMPLEMENTATIONS
- *
- * This is a pure abstract base class that defines the interface and common behavior
- * for all tools. It follows strict architectural principles:
- *
- * - Depends ONLY on interfaces (EventService interface, not concrete implementations)
- * - Does NOT import concrete classes
- * - Uses Dependency Injection for all dependencies
- * - Handles undefined dependencies gracefully (Null Object Pattern)
- *
- * Concrete implementations should be handled
- * by the caller who creates the tool instance, not by this abstract class.
- *
- * @example
- * ```typescript
- * // ✅ CORRECT: Caller prepares an owner-bound EventService and injects it
- * // (Example: bind to the current tool call identity and ownerPath.)
- * const toolEventService = bindWithOwnerPath(baseEventService, {
- *   ownerType: 'tool',
- *   ownerId: toolCallId,
- *   ownerPath,
- * });
- * const tool = new MyTool({ eventService: toolEventService });
- *
- * // ❌ WRONG: AbstractTool creates concrete EventService
- * // This violates Dependency Inversion Principle
- * ```
- */
-import type { IToolResult, IToolExecutionContext, IParameterValidationResult, TToolParameters } from '../interfaces/tool';
-import type { IToolSchema } from '../interfaces/provider';
-import type { ILogger } from '../utils/logger';
-import type { IBaseEventData, IEventService } from '../interfaces/event-service';
-/**
- * Options for AbstractTool construction
- */
-export interface IAbstractToolOptions {
-    /**
-     * Optional logger for tool operations
-     * Defaults to SilentLogger if not provided
-     */
-    logger?: ILogger;
-    /**
-     * Optional event service for unified event emission
-     * If not provided, tool will operate silently without emitting events
-     *
-     * The caller should provide an EventService configured with appropriate settings
-     * (e.g., ownerPrefix='tool' for tool events)
-     *
-     * @since 2.1.0
-     */
-    eventService?: IEventService;
-}
-/**
- * Tool execution function type with proper parameter constraints
- */
-export type TToolExecutionFunction<TParams = TToolParameters, TResult = IToolResult> = (parameters: TParams) => Promise<TResult> | TResult;
-/**
- * Abstract tool interface with type parameters for enhanced type safety
- *
- * @template TParams - Tool parameters type (defaults to AbstractToolParameters for backward compatibility)
- * @template TResult - Tool result type (defaults to ToolResult for backward compatibility)
- */
-export interface IAbstractTool<TParams = TToolParameters, TResult = IToolResult> {
-    name: string;
-    description: string;
-    parameters: IToolSchema['parameters'];
-    execute: TToolExecutionFunction<TParams, TResult>;
-}
-/**
- * Type-safe tool interface with type parameters
- *
- * @template TParameters - Tool parameters type (defaults to AbstractToolParameters for backward compatibility)
- * @template TResult - Tool result type (defaults to ToolResult for backward compatibility)
- */
-export interface IToolContract<TParameters = TToolParameters, TResult = IToolResult> {
-    readonly schema: IToolSchema;
-    execute(parameters: TParameters, context: IToolExecutionContext): Promise<TResult>;
-    validate(parameters: TParameters): boolean;
-    validateParameters(parameters: TParameters): IParameterValidationResult;
-    getDescription(): string;
-    getName(): string;
-}
-/**
- * Runtime tool instance contract used by Robota internals.
- *
- * Tools passed into Agent configuration must support EventService injection
- * so Robota can emit unified tool lifecycle events.
- */
-export interface IToolWithEventService<TParameters = TToolParameters, TResult = IToolResult> extends IToolContract<TParameters, TResult> {
-    setEventService(eventService: IEventService | undefined): void;
-}
-/**
- * Abstract base class for tools with type parameter support
- * Provides type-safe parameter handling and result processing
- *
- * 🎯 ARCHITECTURAL PRINCIPLES:
- * - Pure abstract class - depends only on interfaces
- * - No concrete class dependencies (EventService interface only)
- * - Dependency Injection for all external dependencies
- * - Graceful degradation (undefined dependencies = silent operation)
- *
- * @template TParameters - Tool parameters type (defaults to TToolParameters)
- * @template TResult - Tool result type (defaults to ToolResult for backward compatibility)
- */
-export declare abstract class AbstractTool<TParameters = TToolParameters, TResult = IToolResult> implements IToolWithEventService<TParameters, TResult> {
-    abstract readonly schema: IToolSchema;
-    /**
-     * Logger for tool operations
-     */
-    protected readonly logger: ILogger;
-    /**
-     * EventService for direct event emission (optional)
-     * If undefined, tool operates silently without emitting events
-     */
-    private eventService;
-    /**
-     * Constructor with simplified options
-     *
-     * 🎯 DEPENDENCY INJECTION:
-     * All dependencies are injected via options parameter
-     * No concrete classes are instantiated within this constructor
-     *
-     * @param options - Configuration options for the tool
-     */
-    constructor(options?: IAbstractToolOptions);
-    /**
-     * Set EventService for post-construction injection
-     *
-     * 🎯 DEPENDENCY INJECTION:
-     * Accepts EventService as-is without transformation
-     * Caller is responsible for providing properly configured EventService
-     *
-     * @param eventService - EventService instance to use for event emission (or undefined for silent operation)
-     */
-    setEventService(eventService: IEventService | undefined): void;
-    /**
-     * Get current EventService (for testing/inspection)
-     */
-    protected getEventService(): IEventService | undefined;
-    /**
-     * Emit event through EventService (if available)
-     * If EventService is not available, silently ignores the event (Null Object Pattern)
-     *
-     * @param eventType - Type of event to emit
-     * @param data - Event data
-     */
-    protected emitEvent(eventType: string, data: IBaseEventData): void;
-    /**
-     * Execute tool with simplified lifecycle
-     * @param parameters - Tool parameters
-     * @param context - Optional execution context
-     * @returns Promise resolving to tool result
-     */
-    execute(parameters: TParameters, context: IToolExecutionContext): Promise<TResult>;
-    /**
-     * Concrete implementation of tool execution
-     * This method should be implemented by subclasses to provide actual tool logic
-     *
-     * @param parameters - Tool parameters
-     * @param context - Optional execution context
-     * @returns Promise resolving to tool result
-     */
-    protected abstract executeImpl(parameters: TParameters, context: IToolExecutionContext): Promise<TResult>;
-    validate(parameters: TParameters): boolean;
-    /**
-     * Validate tool parameters with detailed result (default implementation)
-     */
-    validateParameters(parameters: TParameters): IParameterValidationResult;
-    getDescription(): string;
-    getName(): string;
-}
-//# sourceMappingURL=abstract-tool.d.ts.map

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

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