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

package/dist/services/event-service.js

@@ -0,0 +1,110 @@
+/**
+ * Abstract base for event services.
+ * Concrete implementations decide how events are delivered.
+ */
+export class AbstractEventService {
+    listeners = new Set();
+    subscribe(listener) {
+        this.listeners.add(listener);
+    }
+    unsubscribe(listener) {
+        this.listeners.delete(listener);
+    }
+    notifyListeners(eventType, data, context) {
+        for (const listener of this.listeners) {
+            listener(eventType, data, context);
+        }
+    }
+}
+/**
+ * Default no-op event service (production-safe).
+ * When injected, emit() intentionally does nothing.
+ */
+export class DefaultEventService extends AbstractEventService {
+    emit(_eventType, _data, _context) {
+        // Intentionally empty: no-op event service.
+    }
+}
+/**
+ * Singleton default event service instance.
+ */
+export const DEFAULT_ABSTRACT_EVENT_SERVICE = new DefaultEventService();
+/**
+ * Check if a given service is the default no-op implementation.
+ */
+export function isDefaultEventService(service) {
+    return service === DEFAULT_ABSTRACT_EVENT_SERVICE || service instanceof DefaultEventService;
+}
+/**
+ * Compose a full event name from owner prefix and local name.
+ * Local names must not contain dots.
+ */
+export function composeEventName(ownerType, localName) {
+    if (!ownerType || ownerType.trim().length === 0) {
+        throw new Error('[EVENTS] ownerType is required to compose event names.');
+    }
+    if (ownerType.includes('.')) {
+        throw new Error(`[EVENTS] ownerType must not contain '.': "${ownerType}"`);
+    }
+    if (!localName || localName.trim().length === 0) {
+        throw new Error('[EVENTS] local event name is required.');
+    }
+    if (localName.includes('.')) {
+        throw new Error(`[EVENTS] Local event name must not contain '.': "${localName}"`);
+    }
+    return `${ownerType}.${localName}`;
+}
+/**
+ * A scoped event service that always emits with an owner binding applied.
+ */
+export class StructuredEventService extends AbstractEventService {
+    base;
+    binding;
+    constructor(base, binding) {
+        super();
+        this.base = base;
+        this.binding = binding;
+    }
+    emit(eventType, data, context) {
+        if (eventType.includes('.')) {
+            throw new Error(`[EVENTS] Local event name must not contain '.': "${eventType}"`);
+        }
+        const merged = {
+            ...context,
+            ownerType: this.binding.ownerType,
+            ownerId: this.binding.ownerId,
+            ownerPath: this.binding.ownerPath
+        };
+        const fullEventName = composeEventName(this.binding.ownerType, eventType);
+        this.base.emit(fullEventName, data, merged);
+    }
+    subscribe(listener) {
+        this.base.subscribe(listener);
+    }
+    unsubscribe(listener) {
+        this.base.unsubscribe(listener);
+    }
+}
+/**
+ * Bind an EventService to an explicit owner path.
+ * This is the standard entry point for scoped emission (path-only architecture).
+ */
+export function bindWithOwnerPath(base, binding) {
+    return new StructuredEventService(base, binding);
+}
+/**
+ * Alias for bindWithOwnerPath for historical call sites.
+ * Intentionally forwards to the single authoritative implementation.
+ */
+export function bindEventServiceOwner(base, binding) {
+    return bindWithOwnerPath(base, binding);
+}
+/**
+ * Observable EventService that notifies subscribed listeners.
+ */
+export class ObservableEventService extends AbstractEventService {
+    emit(eventType, data, context) {
+        this.notifyListeners(eventType, data, context);
+    }
+}
+//# sourceMappingURL=event-service.js.map

package/dist/services/event-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-service.js","sourceRoot":"","sources":["../../src/services/event-service.ts"],"names":[],"mappings":"AAoBA;;;GAGG;AACH,MAAM,OAAgB,oBAAoB;IAC9B,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAI9C,SAAS,CAAC,QAAwB;QAC9B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;IAED,WAAW,CAAC,QAAwB;QAChC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAES,eAAe,CAAC,SAAiB,EAAE,IAAoB,EAAE,OAAuB;QACtF,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACpC,QAAQ,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACvC,CAAC;IACL,CAAC;CACJ;AAED;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,oBAAoB;IACzD,IAAI,CAAC,UAAkB,EAAE,KAAqB,EAAE,QAAwB;QACpE,4CAA4C;IAChD,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAkB,IAAI,mBAAmB,EAAE,CAAC;AAEvF;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAsB;IACxD,OAAO,OAAO,KAAK,8BAA8B,IAAI,OAAO,YAAY,mBAAmB,CAAC;AAChG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,SAAiB;IACjE,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,6CAA6C,SAAS,GAAG,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,oDAAoD,SAAS,GAAG,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,GAAG,SAAS,IAAI,SAAS,EAAE,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,oBAAoB;IAC3C,IAAI,CAAgB;IACpB,OAAO,CAA4B;IAEpD,YAAY,IAAmB,EAAE,OAAkC;QAC/D,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED,IAAI,CAAC,SAAiB,EAAE,IAAoB,EAAE,OAAuB;QACjE,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,oDAAoD,SAAS,GAAG,CAAC,CAAC;QACtF,CAAC;QACD,MAAM,MAAM,GAAkB;YAC1B,GAAG,OAAO;YACV,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;YACjC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO;YAC7B,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;SACpC,CAAC;QACF,MAAM,aAAa,GAAG,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC1E,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAEQ,SAAS,CAAC,QAAwB;QACvC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAEQ,WAAW,CAAC,QAAwB;QACzC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;CACJ;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAmB,EAAE,OAAkC;IACrF,OAAO,IAAI,sBAAsB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAmB,EAAE,OAAkC;IACzF,OAAO,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,oBAAoB;IAC5D,IAAI,CAAC,SAAiB,EAAE,IAAoB,EAAE,OAAuB;QACjE,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;CACJ"}

package/dist/services/event-service.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=event-service.test.d.ts.map

package/dist/services/event-service.test.d.ts.map

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

package/dist/services/event-service.test.js

@@ -0,0 +1,86 @@
+import { describe, expect, it, vi } from 'vitest';
+import { bindEventServiceOwner, bindWithOwnerPath, composeEventName, DefaultEventService, ObservableEventService, StructuredEventService } from './event-service';
+class MockEventService {
+    events = [];
+    listeners = new Set();
+    emit(eventType, data, context) {
+        this.events.push({ eventType, data, context });
+        for (const listener of this.listeners) {
+            listener(eventType, data, context);
+        }
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+    }
+    unsubscribe(listener) {
+        this.listeners.delete(listener);
+    }
+}
+const binding = {
+    ownerType: 'execution',
+    ownerId: 'exec_1',
+    ownerPath: [{ type: 'execution', id: 'exec_1' }]
+};
+const eventData = {
+    timestamp: new Date(0)
+};
+describe('event-service', () => {
+    it('composeEventName should compose owner prefix and local name', () => {
+        expect(composeEventName('execution', 'start')).toBe('execution.start');
+    });
+    it('composeEventName should reject invalid owner/local names', () => {
+        expect(() => composeEventName('', 'start')).toThrow('ownerType is required');
+        expect(() => composeEventName('execution.root', 'start')).toThrow("must not contain '.'");
+        expect(() => composeEventName('execution', '')).toThrow('local event name is required');
+        expect(() => composeEventName('execution', 'start.now')).toThrow("must not contain '.'");
+    });
+    it('StructuredEventService should emit full event name with bound context', () => {
+        const base = new MockEventService();
+        const service = new StructuredEventService(base, binding);
+        const context = {
+            ownerType: 'ignored',
+            ownerId: 'ignored',
+            ownerPath: [{ type: 'tool', id: 'tool_1' }]
+        };
+        service.emit('start', eventData, context);
+        expect(base.events).toHaveLength(1);
+        expect(base.events[0]?.eventType).toBe('execution.start');
+        expect(base.events[0]?.context).toEqual({
+            ownerType: 'execution',
+            ownerId: 'exec_1',
+            ownerPath: [{ type: 'execution', id: 'exec_1' }]
+        });
+    });
+    it('StructuredEventService should reject dotted local event names', () => {
+        const base = new MockEventService();
+        const service = new StructuredEventService(base, binding);
+        expect(() => service.emit('execution.start', eventData)).toThrow("must not contain '.'");
+    });
+    it('bind helpers should return scoped services', () => {
+        const base = new MockEventService();
+        const a = bindWithOwnerPath(base, binding);
+        const b = bindEventServiceOwner(base, binding);
+        a.emit('start', eventData);
+        b.emit('complete', eventData);
+        expect(base.events.map(item => item.eventType)).toEqual(['execution.start', 'execution.complete']);
+    });
+    it('ObservableEventService should notify subscribed listeners', () => {
+        const service = new ObservableEventService();
+        const listener = vi.fn();
+        service.subscribe(listener);
+        service.emit('execution.start', eventData, {
+            ownerType: 'execution',
+            ownerId: 'exec_1',
+            ownerPath: [{ type: 'execution', id: 'exec_1' }]
+        });
+        expect(listener).toHaveBeenCalledTimes(1);
+        service.unsubscribe(listener);
+        service.emit('execution.complete', eventData);
+        expect(listener).toHaveBeenCalledTimes(1);
+    });
+    it('DefaultEventService should be no-op', () => {
+        const service = new DefaultEventService();
+        expect(() => service.emit('execution.start', eventData)).not.toThrow();
+    });
+});
+//# sourceMappingURL=event-service.test.js.map

package/dist/services/event-service.test.js.map

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

package/dist/services/execution-service.d.ts

@@ -0,0 +1,151 @@
+import { IAgentConfig, IExecutionContextInjection } from '../interfaces/agent';
+import { TMetadata } from '../interfaces/types';
+import type { IPluginContract, IPluginHooks, IPluginOptions, IPluginStats } from '../abstracts/abstract-plugin';
+import type { IAIProviderManager } from '../interfaces/manager';
+import type { IToolManager } from '../interfaces/manager';
+import { ConversationHistory } from '../managers/conversation-history-manager';
+import type { TUniversalMessage } from '../interfaces/messages';
+import { IEventService } from './event-service';
+/**
+ * ExecutionService owned events
+ * Local event names only (no dots). Full names are composed at emit time.
+ */
+export declare const EXECUTION_EVENTS: {
+    readonly START: "start";
+    readonly COMPLETE: "complete";
+    readonly ERROR: "error";
+    readonly ASSISTANT_MESSAGE_START: "assistant_message_start";
+    readonly ASSISTANT_MESSAGE_COMPLETE: "assistant_message_complete";
+    readonly USER_MESSAGE: "user_message";
+    readonly TOOL_RESULTS_TO_LLM: "tool_results_to_llm";
+    readonly TOOL_RESULTS_READY: "tool_results_ready";
+};
+export declare const EXECUTION_EVENT_PREFIX: "execution";
+/**
+ * Execution context passed through the pipeline
+ */
+/**
+ * Execution context for service operations
+ * Applies Type Deduplication Rule: Use standardized metadata type
+ */
+interface IExecutionContext {
+    conversationId?: string;
+    sessionId?: string;
+    userId?: string;
+    messages: TUniversalMessage[];
+    config: IAgentConfig;
+    metadata?: TMetadata;
+    startTime: Date;
+    executionId: string;
+}
+/**
+ * Execution result containing the response and execution metadata
+ */
+interface IExecutionResult {
+    response: string;
+    messages: TUniversalMessage[];
+    executionId: string;
+    duration: number;
+    tokensUsed?: number;
+    toolsExecuted: string[];
+    success: boolean;
+    error?: Error;
+}
+/**
+ * History statistics type returned by ConversationHistory.getStats()
+ */
+interface IHistoryStats {
+    totalConversations: number;
+    conversationIds: string[];
+    totalMessages: number;
+}
+/**
+ * Plugin statistics type - using a simpler structure
+ */
+interface IExecutionServicePluginStats {
+    pluginCount: number;
+    pluginNames: string[];
+    historyStats: IHistoryStats;
+}
+/**
+ * Service that orchestrates the entire execution pipeline
+ * Coordinates AI provider execution, tool execution service, and plugin lifecycle
+ * Uses centralized conversation history management
+ */
+export declare class ExecutionService {
+    private toolExecutionService;
+    private aiProviders;
+    private tools;
+    private conversationHistory;
+    private plugins;
+    private logger;
+    private baseEventService;
+    private executionContext?;
+    private ownerPathBase;
+    private toolEventServices;
+    private agentOwnerPathBase;
+    private lastResponseExecutionId?;
+    constructor(aiProviders: IAIProviderManager, tools: IToolManager, conversationHistory: ConversationHistory, eventService?: IEventService, executionContext?: IExecutionContextInjection);
+    /**
+     * Register a plugin
+     */
+    registerPlugin(plugin: IPluginContract<IPluginOptions, IPluginStats> & IPluginHooks): void;
+    /**
+     * Remove a plugin
+     */
+    removePlugin(pluginName: string): boolean;
+    /**
+     * Get a plugin by name
+     */
+    getPlugin(pluginName: string): (IPluginContract<IPluginOptions, IPluginStats> & IPluginHooks) | null;
+    /**
+     * Get all registered plugins
+     */
+    getPlugins(): Array<IPluginContract<IPluginOptions, IPluginStats> & IPluginHooks>;
+    /**
+     * Execute the full pipeline with centralized history management
+     */
+    execute(input: string, messages: TUniversalMessage[], config: IAgentConfig, context?: Partial<IExecutionContext>): Promise<IExecutionResult>;
+    /**
+     * Execute with streaming response
+     */
+    executeStream(input: string, messages: TUniversalMessage[], config: IAgentConfig, context?: Partial<IExecutionContext>): AsyncGenerator<{
+        chunk: string;
+        isComplete: boolean;
+    }>;
+    /**
+     * Generate a unique execution ID
+     */
+    private generateExecutionId;
+    /**
+     * Get execution statistics from plugins
+     */
+    getStats(): Promise<IExecutionServicePluginStats>;
+    /**
+     * Clear all plugins
+     */
+    clearPlugins(): void;
+    /**
+     * Call a hook method on all plugins that implement it
+     * Handles different hook signatures properly
+     */
+    private callPluginHook;
+    private ensureToolEventService;
+    private prepareOwnerPathBases;
+    private resetOwnerPathBases;
+    private buildBaseOwnerPath;
+    private buildExecutionOwnerContext;
+    private buildThinkingOwnerContext;
+    private buildToolOwnerContext;
+    private buildResponseOwnerContext;
+    private emitExecution;
+    private emitTool;
+    private emitWithContext;
+    private requireConversationId;
+    /**
+     * Convert IExecutionContext to IPluginContext compatible format
+     */
+    private convertExecutionContextToPluginFormat;
+}
+export {};
+//# sourceMappingURL=execution-service.d.ts.map

package/dist/services/execution-service.d.ts.map

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