@robota-sdk/agent-core 3.0.0-beta.1

package/dist/abstracts/abstract-executor.js

@@ -0,0 +1,156 @@
+import { SilentLogger } from '../utils/logger';
+/**
+ * @fileoverview Abstract Executor Base Class
+ *
+ * 🎯 ABSTRACT CLASS - DO NOT DEPEND ON CONCRETE IMPLEMENTATIONS
+ *
+ * Provides shared execution helpers (retry, timeout, validation, logging) for all
+ * executor implementations. Concrete executors should extend this class and inject
+ * their own logger implementation if they need custom logging behavior.
+ *
+ * @example
+ * ```typescript
+ * export class MyCustomExecutor extends AbstractExecutor {
+ *   async executeChat(request: IChatExecutionRequest): Promise<AssistantMessage> {
+ *     return this.withRetry(() => this.performChat(request));
+ *   }
+ * }
+ * ```
+ */
+export class AbstractExecutor {
+    /**
+     * Logger injected via constructor (defaults to abstract logger)
+     */
+    logger;
+    constructor(logger = SilentLogger) {
+        this.logger = logger;
+    }
+    /**
+     * Check if the executor supports tool calling
+     * Default implementation returns false, can be overridden
+     */
+    supportsTools() {
+        return false;
+    }
+    /**
+     * Validate executor configuration
+     * Default implementation returns true, can be overridden
+     */
+    validateConfig() {
+        return true;
+    }
+    /**
+     * Clean up resources when executor is no longer needed
+     * Default implementation does nothing, can be overridden
+     */
+    async dispose() {
+        // Default: no cleanup needed
+    }
+    /**
+     * Execute function with retry logic
+     *
+     * @param fn - Function to execute with retries
+     * @param maxRetries - Maximum number of retry attempts (default: 3)
+     * @param retryDelay - Delay between retries in milliseconds (default: 1000)
+     * @returns Promise resolving to function result
+     */
+    async withRetry(fn, maxRetries = 3, retryDelay = 1000) {
+        let lastError;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            try {
+                return await fn();
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                if (attempt < maxRetries) {
+                    this.logger.warn?.(`[${this.name}] Attempt ${attempt + 1} failed, retrying in ${retryDelay}ms`, {
+                        error: lastError.message,
+                        attempt: attempt + 1,
+                        maxRetries
+                    });
+                    await this.delay(retryDelay);
+                }
+            }
+        }
+        throw lastError;
+    }
+    /**
+     * Execute function with timeout
+     *
+     * @param promise - Promise to execute with timeout
+     * @param timeoutMs - Timeout in milliseconds
+     * @returns Promise resolving to function result
+     */
+    async withTimeout(promise, timeoutMs) {
+        const timeoutPromise = new Promise((_, reject) => {
+            setTimeout(() => {
+                reject(new Error(`Operation timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+        });
+        return Promise.race([promise, timeoutPromise]);
+    }
+    /**
+     * Delay execution for specified milliseconds
+     *
+     * @param ms - Milliseconds to delay
+     * @returns Promise that resolves after the delay
+     */
+    delay(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    /**
+     * Log debug information (only if logging is enabled)
+     *
+     * @param message - Log message
+     * @param data - Optional data to log
+     */
+    logDebug(message, data) {
+        this.logger.debug?.(`[${this.name}] ${message}`, data);
+    }
+    /**
+     * Log error information
+     *
+     * @param message - Log message
+     * @param error - Error object
+     * @param data - Optional additional data
+     */
+    logError(message, error, data) {
+        this.logger.error?.(`[${this.name}] ${message}`, {
+            error: error.message,
+            stack: error.stack,
+            ...data
+        });
+    }
+    /**
+     * Validate that request has required fields
+     *
+     * @param request - Chat execution request to validate
+     * @throws Error if validation fails
+     */
+    validateRequest(request) {
+        if (!request.messages || request.messages.length === 0) {
+            throw new Error('Request must include at least one message');
+        }
+        if (!request.provider) {
+            throw new Error('Request must specify a provider');
+        }
+        if (!request.model) {
+            throw new Error('Request must specify a model');
+        }
+    }
+    /**
+     * Validate that response is properly formatted
+     *
+     * @param response - Response to validate
+     * @throws Error if validation fails
+     */
+    validateResponse(response) {
+        if (!response.role) {
+            throw new Error('Response must have a role');
+        }
+        if (!response.content) {
+            throw new Error('Response must have content');
+        }
+    }
+}
+//# sourceMappingURL=abstract-executor.js.map

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

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

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

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview Abstract Manager Base Class
+ *
+ * 🎯 ABSTRACT CLASS - DO NOT IMPORT CONCRETE IMPLEMENTATIONS
+ *
+ * This class defines the common lifecycle contract for all manager implementations.
+ * It enforces explicit initialization/disposal semantics so that subclasses can
+ * provide their own resource management logic while sharing guard rails.
+ *
+ * Architectural rules:
+ * - Depends only on abstractions (no concrete manager implementations)
+ * - Provides finalize hooks (`doInitialize`, `doDispose`) for subclasses
+ * - Guards public APIs via `ensureInitialized`
+ */
+export declare abstract class AbstractManager {
+    protected initialized: boolean;
+    /**
+     * Initialize the manager (idempotent)
+     */
+    initialize(): Promise<void>;
+    /**
+     * Subclass-specific initialization logic
+     */
+    protected abstract doInitialize(): Promise<void>;
+    /**
+     * Dispose manager resources (idempotent)
+     */
+    dispose(): Promise<void>;
+    /**
+     * Subclass-specific disposal logic
+     */
+    protected abstract doDispose(): Promise<void>;
+    /**
+     * Whether the manager completed initialization
+     */
+    isInitialized(): boolean;
+    /**
+     * Ensure manager is initialized before performing operations
+     */
+    protected ensureInitialized(): void;
+}
+//# sourceMappingURL=abstract-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-manager.d.ts","sourceRoot":"","sources":["../../src/abstracts/abstract-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,8BAAsB,eAAe;IACjC,SAAS,CAAC,WAAW,UAAS;IAE9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAE7C;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,SAAS,CAAC,iBAAiB,IAAI,IAAI;CAKtC"}

package/dist/abstracts/abstract-manager.js

@@ -0,0 +1,49 @@
+/**
+ * @fileoverview Abstract Manager Base Class
+ *
+ * 🎯 ABSTRACT CLASS - DO NOT IMPORT CONCRETE IMPLEMENTATIONS
+ *
+ * This class defines the common lifecycle contract for all manager implementations.
+ * It enforces explicit initialization/disposal semantics so that subclasses can
+ * provide their own resource management logic while sharing guard rails.
+ *
+ * Architectural rules:
+ * - Depends only on abstractions (no concrete manager implementations)
+ * - Provides finalize hooks (`doInitialize`, `doDispose`) for subclasses
+ * - Guards public APIs via `ensureInitialized`
+ */
+export class AbstractManager {
+    initialized = false;
+    /**
+     * Initialize the manager (idempotent)
+     */
+    async initialize() {
+        if (this.initialized) {
+            return;
+        }
+        await this.doInitialize();
+        this.initialized = true;
+    }
+    /**
+     * Dispose manager resources (idempotent)
+     */
+    async dispose() {
+        await this.doDispose();
+        this.initialized = false;
+    }
+    /**
+     * Whether the manager completed initialization
+     */
+    isInitialized() {
+        return this.initialized;
+    }
+    /**
+     * Ensure manager is initialized before performing operations
+     */
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw new Error(`${this.constructor.name} is not initialized`);
+        }
+    }
+}
+//# sourceMappingURL=abstract-manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-manager.js","sourceRoot":"","sources":["../../src/abstracts/abstract-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAgB,eAAe;IACvB,WAAW,GAAG,KAAK,CAAC;IAE9B;;OAEG;IACH,KAAK,CAAC,UAAU;QACZ,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,OAAO;QACX,CAAC;QACD,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC5B,CAAC;IAOD;;OAEG;IACH,KAAK,CAAC,OAAO;QACT,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC7B,CAAC;IAOD;;OAEG;IACH,aAAa;QACT,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED;;OAEG;IACO,iBAAiB;QACvB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,qBAAqB,CAAC,CAAC;QACnE,CAAC;IACL,CAAC;CACJ"}

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

@@ -0,0 +1,365 @@
+/**
+ * @fileoverview Abstract Module Base Class
+ *
+ * 🎯 ABSTRACT CLASS - DO NOT DEPEND ON CONCRETE IMPLEMENTATIONS
+ *
+ * This class defines the core lifecycle contract for Robota modules.
+ * It only relies on abstract dependencies (EventEmitterPlugin interface and
+ * AbstractLogger) so that concrete modules can inject their own behaviors.
+ */
+import type { ILogger } from '../utils/logger';
+import { type IEventEmitterPlugin } from '../plugins/event-emitter/types';
+/**
+ * Module execution context for all modules
+ */
+export interface IModuleExecutionContext {
+    executionId?: string;
+    sessionId?: string;
+    userId?: string;
+    agentName?: string;
+    metadata?: Record<string, string | number | boolean | Date>;
+    [key: string]: string | number | boolean | Date | Record<string, string | number | boolean | Date> | undefined;
+}
+/**
+ * Module execution result for all modules
+ */
+export interface IModuleExecutionResult {
+    success: boolean;
+    data?: IModuleResultData;
+    error?: Error;
+    duration?: number;
+    metadata?: Record<string, string | number | boolean | Date>;
+}
+/**
+ * Module result data interface
+ */
+export interface IModuleResultData {
+    [key: string]: string | number | boolean | Record<string, string | number | boolean> | undefined;
+}
+/**
+ * Base module options that all module options should extend
+ */
+export interface IBaseModuleOptions {
+    /** Whether the module is enabled */
+    enabled?: boolean;
+    /** Module-specific configuration */
+    config?: Record<string, string | number | boolean>;
+}
+/**
+ * Module capabilities that define what the module can do
+ */
+export interface IModuleCapabilities {
+    /** List of capabilities this module provides */
+    capabilities: string[];
+    /** Dependencies on other modules */
+    dependencies?: string[];
+    /** Optional capabilities that enhance functionality if available */
+    optionalDependencies?: string[];
+}
+/**
+ * Module type descriptor for dynamic type system
+ */
+export interface IModuleDescriptor {
+    /** Unique type identifier */
+    type: string;
+    /** Module category */
+    category: ModuleCategory;
+    /** Module layer */
+    layer: ModuleLayer;
+    /** Required dependencies */
+    dependencies?: string[];
+    /** Provided capabilities */
+    capabilities?: string[];
+}
+/**
+ * Module categories for classification
+ */
+export declare enum ModuleCategory {
+    /** Core functionality modules */
+    CORE = "core",
+    /** Storage and data management */
+    STORAGE = "storage",
+    /** Processing and transformation */
+    PROCESSING = "processing",
+    /** External integration */
+    INTEGRATION = "integration",
+    /** User interface and interaction */
+    INTERFACE = "interface",
+    /** Specialized capabilities */
+    CAPABILITY = "capability"
+}
+/**
+ * Module layers for dependency management
+ */
+export declare enum ModuleLayer {
+    /** Infrastructure layer (lowest) */
+    INFRASTRUCTURE = "infrastructure",
+    /** Core services layer */
+    CORE = "core",
+    /** Application logic layer */
+    APPLICATION = "application",
+    /** Domain-specific layer */
+    DOMAIN = "domain",
+    /** Presentation layer (highest) */
+    PRESENTATION = "presentation"
+}
+/**
+ * Module data interface for introspection
+ */
+export interface IModuleData {
+    name: string;
+    version: string;
+    type: string;
+    enabled: boolean;
+    initialized: boolean;
+    capabilities: IModuleCapabilities;
+    metadata?: Record<string, string | number | boolean>;
+}
+/**
+ * Module statistics interface
+ */
+export interface IModuleStats {
+    enabled: boolean;
+    initialized: boolean;
+    executionCount: number;
+    errorCount: number;
+    lastActivity?: Date;
+    averageExecutionTime?: number;
+    [key: string]: string | number | boolean | Date | undefined;
+}
+/**
+ * Type-safe module interface with specific type parameters
+ *
+ * @template TOptions - Module options type that extends IBaseModuleOptions
+ * @template TStats - Module statistics type (defaults to IModuleStats)
+ */
+export interface IModule<TOptions extends IBaseModuleOptions = IBaseModuleOptions, TStats = IModuleStats> {
+    name: string;
+    version: string;
+    enabled: boolean;
+    initialize(options?: TOptions, eventEmitter?: IEventEmitterPlugin): Promise<void>;
+    dispose?(): Promise<void>;
+    execute?(context: IModuleExecutionContext): Promise<IModuleExecutionResult>;
+    getModuleType(): IModuleDescriptor;
+    getCapabilities(): IModuleCapabilities;
+    getData?(): IModuleData;
+    getStats?(): TStats;
+    isEnabled(): boolean;
+    isInitialized(): boolean;
+}
+/**
+ * Base module interface extending IModule
+ */
+export interface IBaseModule extends IModule<IBaseModuleOptions, IModuleStats> {
+}
+/**
+ * Module lifecycle hooks
+ */
+export interface IModuleHooks {
+    /**
+     * Called before module execution
+     */
+    beforeExecution?(context: IModuleExecutionContext): Promise<void> | void;
+    /**
+     * Called after module execution
+     */
+    afterExecution?(context: IModuleExecutionContext, result: IModuleExecutionResult): Promise<void> | void;
+    /**
+     * Called when module is activated
+     */
+    onActivate?(): Promise<void> | void;
+    /**
+     * Called when module is deactivated
+     */
+    onDeactivate?(): Promise<void> | void;
+    /**
+     * Called on module error
+     */
+    onError?(error: Error, context?: IModuleExecutionContext): Promise<void> | void;
+}
+/**
+ * Abstract base class for all modules with type parameter support
+ * Provides module lifecycle management and common functionality
+ *
+ * ⚠️ Core assumption: every Module must be an optional extension feature
+ * - ✅ Robota must work normally without any Module
+ * - ✅ Adding a Module should only grant new capabilities or features
+ * - ❌ If missing a Module breaks core logic, it must be implemented as an internal class instead
+ *
+ * @template TOptions - Module options type that extends IBaseModuleOptions
+ * @template TStats - Module statistics type (defaults to IModuleStats)
+ */
+export declare abstract class AbstractModule<TOptions extends IBaseModuleOptions = IBaseModuleOptions, TStats = IModuleStats> implements IModule<TOptions, TStats>, IModuleHooks {
+    /** Module name */
+    abstract readonly name: string;
+    /** Module version */
+    abstract readonly version: string;
+    /** Module enabled state */
+    enabled: boolean;
+    /** Module initialization state */
+    initialized: boolean;
+    /** Module options */
+    protected options: TOptions | undefined;
+    /** EventEmitter for module events */
+    protected eventEmitter: IEventEmitterPlugin | undefined;
+    /** Logger instance */
+    protected logger: ILogger;
+    /** Execution statistics */
+    protected stats: {
+        executionCount: number;
+        errorCount: number;
+        lastActivity: Date | undefined;
+        totalExecutionTime: number;
+    };
+    constructor(logger?: ILogger);
+    /**
+     * Get module type descriptor - must be implemented by each module
+     */
+    abstract getModuleType(): IModuleDescriptor;
+    /**
+     * Get module capabilities - must be implemented by each module
+     */
+    abstract getCapabilities(): IModuleCapabilities;
+    /**
+     * Initialize the module with type-safe options and EventEmitter
+     */
+    initialize(options?: TOptions, eventEmitter?: IEventEmitterPlugin): Promise<void>;
+    /**
+     * Custom initialization logic - can be overridden by modules
+     */
+    protected onInitialize(_options?: TOptions): Promise<void>;
+    /**
+     * Execute module functionality
+     */
+    execute(context: IModuleExecutionContext): Promise<IModuleExecutionResult>;
+    /**
+     * Custom execution logic - must be implemented by modules that support execution
+     */
+    protected onExecute(_context: IModuleExecutionContext): Promise<IModuleExecutionResult>;
+    /**
+     * Dispose module resources
+     */
+    dispose(): Promise<void>;
+    /**
+     * Custom disposal logic - can be overridden by modules
+     */
+    protected onDispose(): Promise<void>;
+    /**
+     * Enable the module
+     */
+    enable(): void;
+    /**
+     * Disable the module
+     */
+    disable(): void;
+    /**
+     * Check if module is enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Check if module is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Get module data for introspection
+     */
+    getData(): IModuleData;
+    /**
+     * Get module statistics
+     */
+    getStats(): TStats;
+    /**
+     * Get module status
+     */
+    getStatus(): {
+        name: string;
+        version: string;
+        type: string;
+        enabled: boolean;
+        initialized: boolean;
+        hasEventEmitter: boolean;
+    };
+    /**
+     * Convert module event data to event emitter data payload format.
+     */
+    private convertToEventData;
+    beforeExecution?(context: IModuleExecutionContext): Promise<void>;
+    afterExecution?(context: IModuleExecutionContext, result: IModuleExecutionResult): Promise<void>;
+    onActivate?(): Promise<void>;
+    onDeactivate?(): Promise<void>;
+    onError?(error: Error, context?: IModuleExecutionContext): Promise<void>;
+}
+/**
+ * Standard module event data structures for consistent event communication
+ */
+/**
+ * Base module event data interface
+ */
+export interface IBaseModuleEventData {
+    moduleName: string;
+    moduleType: string;
+    timestamp: Date;
+    metadata?: Record<string, string | number | boolean | Date>;
+}
+/**
+ * Module initialization event data
+ */
+export interface IModuleInitializationEventData extends IBaseModuleEventData {
+    phase: 'start' | 'complete' | 'error';
+    duration?: number;
+    error?: string;
+    options?: Record<string, string | number | boolean>;
+}
+/**
+ * Module execution event data
+ */
+export interface IModuleExecutionEventData extends IBaseModuleEventData {
+    phase: 'start' | 'complete' | 'error';
+    executionId: string;
+    duration?: number;
+    success?: boolean;
+    error?: string;
+    inputSize?: number;
+    outputSize?: number;
+    context?: {
+        sessionId?: string;
+        userId?: string;
+        agentName?: string;
+    };
+}
+/**
+ * Module disposal event data
+ */
+export interface IModuleDisposalEventData extends IBaseModuleEventData {
+    phase: 'start' | 'complete' | 'error';
+    duration?: number;
+    error?: string;
+    resourcesReleased?: string[];
+}
+/**
+ * Module capability event data (for capability registration/changes)
+ */
+export interface IModuleCapabilityEventData extends IBaseModuleEventData {
+    action: 'registered' | 'updated' | 'removed';
+    capabilities: string[];
+    dependencies?: string[];
+}
+/**
+ * Module health event data (for monitoring and diagnostics)
+ */
+export interface IModuleHealthEventData extends IBaseModuleEventData {
+    status: 'healthy' | 'warning' | 'error' | 'critical';
+    metrics: {
+        memoryUsage?: number;
+        cpuUsage?: number;
+        executionCount?: number;
+        errorCount?: number;
+        averageResponseTime?: number;
+    };
+    issues?: Array<{
+        severity: 'low' | 'medium' | 'high' | 'critical';
+        message: string;
+        code?: string;
+    }>;
+}
+//# sourceMappingURL=abstract-module.d.ts.map

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

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