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

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

@@ -1,76 +1,17 @@
 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';
+import type { IEventService } from '../interfaces/event-service';
+import type { ExecutionCacheService } from './cache/execution-cache-service';
+export { EXECUTION_EVENTS, EXECUTION_EVENT_PREFIX } from './execution-constants';
+import { type IExecutionContext, type IExecutionResult, type IExecutionServicePluginStats } from './execution-types';
+import { type TPluginWithHooks } from './plugin-hook-dispatcher';
 /**
- * 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
+ * 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;
@@ -79,73 +20,35 @@ export declare class ExecutionService {
     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
-     */
+    private eventEmitter;
+    private cacheService?;
+    constructor(aiProviders: IAIProviderManager, tools: IToolManager, conversationHistory: ConversationHistory, eventService?: IEventService, executionContext?: IExecutionContextInjection, cacheService?: ExecutionCacheService);
+    /** Register a plugin */
+    registerPlugin(plugin: TPluginWithHooks): 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
-     */
+    /** Get a plugin by name */
+    getPlugin(pluginName: string): TPluginWithHooks | undefined;
+    /** Get all registered plugins */
+    getPlugins(): TPluginWithHooks[];
+    /** Execute the full pipeline with centralized history management */
     execute(input: string, messages: TUniversalMessage[], config: IAgentConfig, context?: Partial<IExecutionContext>): Promise<IExecutionResult>;
-    /**
-     * Execute with streaming response
-     */
+    /** 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
-     */
+    /** Get execution statistics from plugins */
     getStats(): Promise<IExecutionServicePluginStats>;
-    /**
-     * Clear all plugins
-     */
+    /** 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 resolveProviderAndTools;
+    private validateProvider;
+    private initializeConversationSession;
+    private buildFinalResult;
+    private handleExecutionError;
+    private generateExecutionId;
     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

@@ -1 +1 @@
-{"version":3,"file":"execution-service.d.ts","sourceRoot":"","sources":["../../src/services/execution-service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"execution-service.d.ts","sourceRoot":"","sources":["../../src/services/execution-service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAGZ,0BAA0B,EAC3B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAE/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAI7E,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAGjF,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,4BAA4B,EAIlC,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAIjF;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,YAAY,CAAwB;IAC5C,OAAO,CAAC,YAAY,CAAC,CAAwB;gBAG3C,WAAW,EAAE,kBAAkB,EAC/B,KAAK,EAAE,YAAY,EACnB,mBAAmB,EAAE,mBAAmB,EACxC,YAAY,CAAC,EAAE,aAAa,EAC5B,gBAAgB,CAAC,EAAE,0BAA0B,EAC7C,YAAY,CAAC,EAAE,qBAAqB;IAetC,wBAAwB;IACxB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAkB9C,sBAAsB;IACtB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAUzC,2BAA2B;IAC3B,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI3D,iCAAiC;IACjC,UAAU,IAAI,gBAAgB,EAAE;IAIhC,oEAAoE;IAC9D,OAAO,CACX,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACnC,OAAO,CAAC,gBAAgB,CAAC;IA8J5B,sCAAsC;IAC/B,aAAa,CAClB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,iBAAiB,EAAE,EAC7B,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACnC,cAAc,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC;IAazD,4CAA4C;IACtC,QAAQ,IAAI,OAAO,CAAC,4BAA4B,CAAC;IAQvD,wBAAwB;IACxB,YAAY,IAAI,IAAI;IAOpB,OAAO,CAAC,uBAAuB;IA4B/B,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,6BAA6B;IAyCrC,OAAO,CAAC,gBAAgB;YAiDV,oBAAoB;IAmClC,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,qCAAqC;CAc9C"}