@robota-sdk/agent-core 3.0.0-beta.3 → 3.0.0-beta.31

package/dist/managers/module-registry.d.ts

@@ -1,27 +1,23 @@
+/**
+ * Registry for managing module instances.
+ *
+ * Validation helpers live in ./module-registry-validation.ts.
+ */
 import type { IBaseModuleOptions, IModule, IModuleExecutionContext, IModuleExecutionResult } from '../abstracts/abstract-module';
 import type { IEventEmitterPlugin } from '../plugins/event-emitter/types';
+import { ModuleDescriptorRegistry } from './module-type-registry';
+import type { IModuleExecutionStats, IModuleRegistryStats } from './module-registry-validation';
+export type { IModuleExecutionStats };
 export declare const MODULE_REGISTRY_EVENTS: {
-    /** Emitted when a module is registered in ModuleRegistry */
     readonly REGISTERED: "module.registered";
-    /** Emitted when a module is unregistered in ModuleRegistry */
     readonly UNREGISTERED: "module.unregistered";
 };
-/**
- * Module registration options
- */
 export interface IModuleRegistrationOptions {
-    /** Whether to initialize the module immediately */
     autoInitialize?: boolean;
-    /** Custom initialization options */
     initOptions?: IBaseModuleOptions;
-    /** Whether to validate dependencies */
     validateDependencies?: boolean;
-    /** Custom initialization timeout */
     initTimeout?: number;
 }
-/**
- * Module status information
- */
 export interface IModuleStatus {
     name: string;
     type: string;
@@ -34,28 +30,6 @@ export interface IModuleStatus {
     dependencies: string[];
     dependents: string[];
 }
-/**
- * Module execution statistics
- */
-export interface IModuleExecutionStats {
-    totalExecutions: number;
-    successfulExecutions: number;
-    failedExecutions: number;
-    averageExecutionTime: number;
-    lastExecutionTime?: Date;
-    totalExecutionTime: number;
-}
-/**
- * Registry for managing module instances
- * Handles module lifecycle, dependencies, and execution coordination
- *
- * Key features:
- * - Dependency-based initialization ordering
- * - Module lifecycle management (register, initialize, dispose)
- * - Event-driven communication through EventEmitter
- * - Module status tracking and statistics
- * - Error handling and recovery
- */
 export declare class ModuleRegistry {
     private modules;
     private moduleOptions;
@@ -67,95 +41,23 @@ export declare class ModuleRegistry {
     private eventEmitter;
     private logger;
     private isDisposing;
-    constructor(eventEmitter?: IEventEmitterPlugin);
-    /**
-     * Register a module instance
-     */
+    constructor(eventEmitter?: IEventEmitterPlugin, typeRegistry?: ModuleDescriptorRegistry);
     registerModule(module: IModule, options?: IModuleRegistrationOptions): Promise<void>;
-    /**
-     * Unregister a module
-     */
     unregisterModule(moduleName: string): Promise<boolean>;
-    /**
-     * Initialize a specific module
-     */
     initializeModule(moduleName: string, timeout?: number): Promise<void>;
-    /**
-     * Initialize all registered modules in dependency order
-     */
     initializeAllModules(timeout?: number): Promise<void>;
-    /**
-     * Execute a module by name
-     */
     executeModule(moduleName: string, context: IModuleExecutionContext): Promise<IModuleExecutionResult>;
-    /**
-     * Get a module by name
-     */
-    getModule(moduleName: string): IModule | null;
-    /**
-     * Get modules by type
-     */
+    getModule(moduleName: string): IModule | undefined;
     getModulesByType(moduleType: string): IModule[];
-    /**
-     * Get all registered modules
-     */
     getAllModules(): IModule[];
-    /**
-     * Get module names
-     */
     getModuleNames(): string[];
-    /**
-     * Check if a module is registered
-     */
     hasModule(moduleName: string): boolean;
-    /**
-     * Get module status
-     */
-    getModuleStatus(moduleName: string): IModuleStatus | null;
-    /**
-     * Get all module statuses
-     */
+    getModuleStatus(moduleName: string): IModuleStatus | undefined;
     getAllModuleStatuses(): IModuleStatus[];
-    /**
-     * Get module execution statistics
-     */
-    getModuleStats(moduleName: string): IModuleExecutionStats | null;
-    /**
-     * Get all module execution statistics
-     */
+    getModuleStats(moduleName: string): IModuleExecutionStats | undefined;
     getAllModuleStats(): Record<string, IModuleExecutionStats>;
-    /**
-     * Dispose all modules in reverse initialization order
-     */
     disposeAllModules(): Promise<void>;
-    /**
-     * Clear all modules (for testing)
-     */
     clearAllModules(): void;
-    /**
-     * Get registry statistics
-     */
-    getRegistryStats(): {
-        totalModules: number;
-        initializedModules: number;
-        enabledModules: number;
-        modulesByType: Record<string, number>;
-        totalExecutions: number;
-        totalSuccessfulExecutions: number;
-        totalFailedExecutions: number;
-        averageExecutionTime: number;
-    };
-    /**
-     * Validate a module before registration
-     */
-    private validateModule;
-    /**
-     * Validate module dependencies
-     */
-    private validateModuleDependencies;
-    /**
-     * Find modules that depend on the given module
-     */
-    private findDependentModules;
+    getRegistryStats(): IModuleRegistryStats;
 }
 //# sourceMappingURL=module-registry.d.ts.map

package/dist/managers/module-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-registry.d.ts","sourceRoot":"","sources":["../../src/managers/module-registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"module-registry.d.ts","sourceRoot":"","sources":["../../src/managers/module-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EACV,kBAAkB,EAClB,OAAO,EACP,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AASlE,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEhG,YAAY,EAAE,qBAAqB,EAAE,CAAC;AAEtC,eAAO,MAAM,sBAAsB;;;CAGzB,CAAC;AAEX,MAAM,WAAW,0BAA0B;IACzC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,IAAI,CAAC;IACvB,kBAAkB,CAAC,EAAE,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,aAAa,CAAyC;IAC9D,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,WAAW,CAA4C;IAC/D,OAAO,CAAC,iBAAiB,CAAgB;IACzC,OAAO,CAAC,mBAAmB,CAAgB;IAC3C,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,WAAW,CAAS;gBAEhB,YAAY,CAAC,EAAE,mBAAmB,EAAE,YAAY,CAAC,EAAE,wBAAwB;IAMjF,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,GAAE,0BAA+B,GAAG,OAAO,CAAC,IAAI,CAAC;IAwCxF,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA0BtD,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BrE,oBAAoB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BrD,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,sBAAsB,CAAC;IAgClC,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAGlD,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,EAAE;IAG/C,aAAa,IAAI,OAAO,EAAE;IAG1B,cAAc,IAAI,MAAM,EAAE;IAG1B,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAGtC,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAG9D,oBAAoB,IAAI,aAAa,EAAE;IAGvC,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAGrE,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC;IAMpD,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBxC,eAAe,IAAI,IAAI;IAUvB,gBAAgB,IAAI,oBAAoB;CAGzC"}