@robota-sdk/agent-core 3.0.0-beta.2 → 3.0.0-beta.20

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

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-module.test.d.ts","sourceRoot":"","sources":["../../src/abstracts/abstract-module.test.ts"],"names":[],"mappings":""}

package/dist/abstracts/abstract-module.test.js

@@ -0,0 +1,150 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { AbstractModule, ModuleCategory, ModuleLayer } from './abstract-module';
+class TestModule extends AbstractModule {
+    name = 'test-module';
+    version = '1.0.0';
+    executeCalled = false;
+    disposeCalled = false;
+    shouldThrowOnExecute = false;
+    shouldThrowOnDispose = false;
+    getModuleType() {
+        return { type: 'test', category: ModuleCategory.CORE, layer: ModuleLayer.APPLICATION };
+    }
+    getCapabilities() {
+        return { capabilities: ['test-cap'] };
+    }
+    async onExecute(context) {
+        if (this.shouldThrowOnExecute)
+            throw new Error('execution error');
+        this.executeCalled = true;
+        return { success: true, data: { result: 'done' } };
+    }
+    async onDispose() {
+        if (this.shouldThrowOnDispose)
+            throw new Error('dispose error');
+        this.disposeCalled = true;
+    }
+}
+describe('AbstractModule', () => {
+    let module;
+    beforeEach(() => {
+        module = new TestModule();
+    });
+    describe('initialize', () => {
+        it('initializes the module', async () => {
+            await module.initialize();
+            expect(module.isInitialized()).toBe(true);
+        });
+        it('sets enabled from options', async () => {
+            await module.initialize({ enabled: false });
+            expect(module.isEnabled()).toBe(false);
+        });
+        it('emits events when eventEmitter is provided', async () => {
+            const emitter = { emit: vi.fn() };
+            await module.initialize({}, emitter);
+            expect(emitter.emit).toHaveBeenCalled();
+        });
+    });
+    describe('execute', () => {
+        it('executes successfully when initialized and enabled', async () => {
+            await module.initialize();
+            const result = await module.execute({ executionId: 'e1' });
+            expect(result.success).toBe(true);
+            expect(module.executeCalled).toBe(true);
+        });
+        it('throws when not enabled', async () => {
+            await module.initialize();
+            module.disable();
+            await expect(module.execute({})).rejects.toThrow('is disabled');
+        });
+        it('throws when not initialized', async () => {
+            await expect(module.execute({})).rejects.toThrow('is not initialized');
+        });
+        it('tracks execution stats on success', async () => {
+            await module.initialize();
+            await module.execute({});
+            const stats = module.getStats();
+            expect(stats.executionCount).toBe(1);
+            expect(stats.errorCount).toBe(0);
+        });
+        it('tracks error stats on failure', async () => {
+            await module.initialize();
+            module.shouldThrowOnExecute = true;
+            await expect(module.execute({})).rejects.toThrow('execution error');
+            const stats = module.getStats();
+            expect(stats.errorCount).toBe(1);
+        });
+        it('emits execution events with eventEmitter', async () => {
+            const emitter = { emit: vi.fn() };
+            await module.initialize({}, emitter);
+            emitter.emit.mockClear();
+            await module.execute({
+                executionId: 'e1',
+                sessionId: 's1',
+                userId: 'u1',
+                agentName: 'agent',
+            });
+            expect(emitter.emit).toHaveBeenCalled();
+        });
+    });
+    describe('dispose', () => {
+        it('disposes the module', async () => {
+            await module.initialize();
+            await module.dispose();
+            expect(module.isInitialized()).toBe(false);
+            expect(module.isEnabled()).toBe(false);
+            expect(module.disposeCalled).toBe(true);
+        });
+        it('emits dispose events with eventEmitter', async () => {
+            const emitter = { emit: vi.fn() };
+            await module.initialize({}, emitter);
+            emitter.emit.mockClear();
+            await module.dispose();
+            expect(emitter.emit).toHaveBeenCalled();
+        });
+        it('emits error event on dispose failure', async () => {
+            const emitter = { emit: vi.fn() };
+            await module.initialize({}, emitter);
+            module.shouldThrowOnDispose = true;
+            await expect(module.dispose()).rejects.toThrow('dispose error');
+        });
+    });
+    describe('enable/disable', () => {
+        it('enable sets enabled to true', () => {
+            module.disable();
+            module.enable();
+            expect(module.isEnabled()).toBe(true);
+        });
+        it('disable sets enabled to false', () => {
+            module.disable();
+            expect(module.isEnabled()).toBe(false);
+        });
+    });
+    describe('getData', () => {
+        it('returns module data', () => {
+            const data = module.getData();
+            expect(data.name).toBe('test-module');
+            expect(data.version).toBe('1.0.0');
+            expect(data.type).toBe('test');
+            expect(data.capabilities.capabilities).toContain('test-cap');
+        });
+    });
+    describe('getStatus', () => {
+        it('returns module status', () => {
+            const status = module.getStatus();
+            expect(status.name).toBe('test-module');
+            expect(status.initialized).toBe(false);
+            expect(status.hasEventEmitter).toBe(false);
+        });
+    });
+    describe('getStats', () => {
+        it('returns stats with averageExecutionTime after execution', async () => {
+            await module.initialize();
+            await module.execute({});
+            const stats = module.getStats();
+            expect(stats.executionCount).toBe(1);
+            expect(stats.averageExecutionTime).toBeDefined();
+        });
+    });
+});
+//# sourceMappingURL=abstract-module.test.js.map

package/dist/abstracts/abstract-module.test.js.map

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

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

@@ -0,0 +1,152 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,29 @@
+/** 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

@@ -0,0 +1 @@
+{"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"}