@robota-sdk/agent-core 3.0.0-beta.64 → 3.0.0-beta.66

package/dist/browser/index.d.ts

@@ -210,6 +210,71 @@ declare const TypeUtils: {
   isUniversalValue: (value: TUniversalValue) => value is TUniversalValue;
 };
 //#endregion
+//#region src/interfaces/cache.d.ts
+/**
+ * Cache key identifying a unique LLM execution request
+ */
+interface ICacheKey {
+  /** SHA-256 hash of the serialized request */
+  hash: string;
+  /** Model identifier */
+  model: string;
+  /** Provider name */
+  provider: string;
+}
+/**
+ * Cached LLM response entry
+ */
+interface ICacheEntry {
+  /** Cache key that produced this entry */
+  key: ICacheKey;
+  /** Cached response content */
+  response: string;
+  /** When the entry was cached */
+  timestamp: number;
+  /** SHA-256 integrity hash of the response */
+  integrityHash: string;
+}
+/**
+ * Cache storage interface for pluggable backends
+ */
+interface ICacheStorage {
+  /** Retrieve a cached entry by key hash */
+  get(hash: string): ICacheEntry | undefined;
+  /** Store a cache entry */
+  set(entry: ICacheEntry): void;
+  /** Delete a cached entry by key hash */
+  delete(hash: string): boolean;
+  /** Clear all cached entries */
+  clear(): void;
+  /** Get cache statistics */
+  getStats(): ICacheStats;
+}
+/**
+ * Cache performance statistics
+ */
+interface ICacheStats {
+  /** Number of cache hits */
+  hits: number;
+  /** Number of cache misses */
+  misses: number;
+  /** Current number of cached entries */
+  entries: number;
+  /** Hit rate (hits / (hits + misses)), 0 if no lookups */
+  hitRate: number;
+}
+/**
+ * Configuration options for execution caching
+ */
+interface ICacheOptions {
+  /** Whether caching is enabled */
+  enabled: boolean;
+  /** Maximum number of cached entries */
+  maxEntries: number;
+  /** Time-to-live in milliseconds */
+  ttlMs: number;
+}
+//#endregion
 //#region src/interfaces/provider-capabilities.d.ts
 interface IProviderFunctionCallingCapability {
   supported: boolean;
@@ -492,99 +557,370 @@ type TProviderOptionValueBase = string | number | boolean | undefined | null | T
   [key: string]: TProviderOptionValueBase;
 };
 //#endregion
-//#region src/event-service/interfaces.d.ts
+//#region src/plugins/event-emitter/types.d.ts
+declare const EXECUTION_EVENT_NAMES: {
+  readonly START: "execution.start";
+  readonly COMPLETE: "execution.complete";
+  readonly ERROR: "execution.error";
+};
+declare const TOOL_EVENT_NAMES: {
+  readonly CALL_START: "tool.call_start";
+  readonly CALL_COMPLETE: "tool.call_complete";
+  readonly CALL_ERROR: "tool.call_error";
+};
+declare const AGENT_EVENT_NAMES: {
+  readonly EXECUTION_START: "agent.execution_start";
+  readonly EXECUTION_COMPLETE: "agent.execution_complete";
+  readonly EXECUTION_ERROR: "agent.execution_error";
+  readonly CREATED: "agent.created";
+};
+type TExecutionEventName = (typeof EXECUTION_EVENT_NAMES)[keyof typeof EXECUTION_EVENT_NAMES];
+type TToolEventName = (typeof TOOL_EVENT_NAMES)[keyof typeof TOOL_EVENT_NAMES];
+type TAgentEventName = (typeof AGENT_EVENT_NAMES)[keyof typeof AGENT_EVENT_NAMES];
 /**
- * @fileoverview Event service interface definitions.
+ * Event types that can be emitted.
  *
- * These interfaces are the single source of truth for event-related contracts
- * within @robota-sdk/agent-core.
+ * IMPORTANT:
+ * - Do not use string literals for event names outside this module.
+ * - Import and use EVENT_EMITTER_EVENTS instead.
  */
+declare const EVENT_EMITTER_EVENTS: {
+  readonly EXECUTION_START: "execution.start";
+  readonly EXECUTION_COMPLETE: "execution.complete";
+  readonly EXECUTION_ERROR: "execution.error";
+  readonly TOOL_BEFORE_EXECUTE: "tool.beforeExecute";
+  readonly TOOL_AFTER_EXECUTE: "tool.afterExecute";
+  readonly TOOL_SUCCESS: "tool.success";
+  readonly TOOL_ERROR: "tool.call_error";
+  readonly CONVERSATION_START: "conversation.start";
+  readonly CONVERSATION_COMPLETE: "conversation.complete";
+  readonly CONVERSATION_ERROR: "conversation.error";
+  readonly AGENT_EXECUTION_START: "agent.execution_start";
+  readonly AGENT_EXECUTION_COMPLETE: "agent.execution_complete";
+  readonly AGENT_EXECUTION_ERROR: "agent.execution_error";
+  readonly AGENT_CREATED: "agent.created";
+  readonly AGENT_DESTROYED: "agent.destroyed";
+  readonly PLUGIN_LOADED: "plugin.loaded";
+  readonly PLUGIN_UNLOADED: "plugin.unloaded";
+  readonly PLUGIN_ERROR: "plugin.error";
+  readonly ERROR_OCCURRED: "error.occurred";
+  readonly WARNING_OCCURRED: "warning.occurred";
+  readonly MODULE_INITIALIZE_START: "module.initialize.start";
+  readonly MODULE_INITIALIZE_COMPLETE: "module.initialize.complete";
+  readonly MODULE_INITIALIZE_ERROR: "module.initialize.error";
+  readonly MODULE_EXECUTION_START: "module.execution.start";
+  readonly MODULE_EXECUTION_COMPLETE: "module.execution.complete";
+  readonly MODULE_EXECUTION_ERROR: "module.execution.error";
+  readonly MODULE_DISPOSE_START: "module.dispose.start";
+  readonly MODULE_DISPOSE_COMPLETE: "module.dispose.complete";
+  readonly MODULE_DISPOSE_ERROR: "module.dispose.error";
+  readonly MODULE_REGISTERED: "module.registered";
+  readonly MODULE_UNREGISTERED: "module.unregistered";
+  readonly EXECUTION_HIERARCHY: "execution.hierarchy";
+  readonly EXECUTION_REALTIME: "execution.realtime";
+  readonly TOOL_REALTIME: "tool.realtime";
+  readonly CUSTOM: "custom";
+};
+type TEventName = TExecutionEventName | TToolEventName | TAgentEventName | 'tool.beforeExecute' | 'tool.afterExecute' | 'tool.success' | 'conversation.start' | 'conversation.complete' | 'conversation.error' | 'agent.destroyed' | 'plugin.loaded' | 'plugin.unloaded' | 'plugin.error' | 'error.occurred' | 'warning.occurred' | 'module.initialize.start' | 'module.initialize.complete' | 'module.initialize.error' | 'module.execution.start' | 'module.execution.complete' | 'module.execution.error' | 'module.dispose.start' | 'module.dispose.complete' | 'module.dispose.error' | 'module.registered' | 'module.unregistered' | 'execution.hierarchy' | 'execution.realtime' | 'tool.realtime' | 'custom';
 /**
- * Primitive value types for event payloads.
+ * Valid event data value types
  */
-type TEventPrimitiveValue = string | number | boolean | null | undefined;
+type TEventDataValue = string | number | boolean | Date | null | undefined | TEventDataValue[] | {
+  [key: string]: TEventDataValue;
+};
 /**
- * Recursive universal value type for event payloads (JSON-like + Date).
+ * Event data structure
  */
-type TEventUniversalValue = TEventPrimitiveValue | Date | TEventUniversalValue[] | IEventObjectValue;
-interface IEventObjectValue {
-  [key: string]: TEventUniversalValue;
+interface IEventEmitterEventData {
+  type: TEventName;
+  timestamp: Date;
+  executionId?: string;
+  sessionId?: string;
+  userId?: string;
+  data?: Record<string, TEventDataValue>;
+  error?: Error;
+  metadata?: Record<string, TEventDataValue>;
 }
 /**
- * Logger data type for event metadata.
+ * Event listener function
  */
-type TEventLoggerData = Record<string, TEventUniversalValue | Date | Error>;
+type TEventEmitterListener = (event: IEventEmitterEventData) => void | Promise<void>;
 /**
- * A single segment in an explicit ownerPath.
+ * Console-like interface for the EventEmitterPlugin.
  *
- * Path-only rule:
- * - Relationships must be derived from these explicit segments, not from parsing IDs.
+ * Use this interface for typing instead of the concrete EventEmitterPlugin class.
  */
-interface IOwnerPathSegment {
-  type: string;
-  id: string;
+interface IEventEmitterPlugin {
+  on(eventType: TEventName, listener: TEventEmitterListener, options?: {
+    once?: boolean;
+    filter?: (event: IEventEmitterEventData) => boolean;
+  }): string;
+  once(eventType: TEventName, listener: TEventEmitterListener, filter?: (event: IEventEmitterEventData) => boolean): string;
+  off(eventType: TEventName, handlerIdOrListener: string | TEventEmitterListener): boolean;
+  emit(eventType: TEventName, eventData?: Partial<IEventEmitterEventData>): Promise<void>;
 }
-/**
- * Event context that accompanies an emitted event.
- * This is the single source of truth for deterministic linking in subscribers.
- */
-interface IEventContext {
-  ownerType: string;
-  ownerId: string;
-  ownerPath: IOwnerPathSegment[];
-  /** Depth of the current execution in the hierarchy (0 = root) */
-  depth?: number;
-  /** Unique span identifier for distributed tracing correlation */
-  spanId?: string;
-  /** Optional structured metadata for debugging/observability */
-  metadata?: TEventLoggerData;
+//#endregion
+//#region src/abstracts/abstract-module-types.d.ts
+/** Module execution context */
+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;
 }
-/**
- * Allowed extension values for event payloads.
- */
-type TEventExtensionValue = TEventUniversalValue | TEventLoggerData | Error | IEventContext | IOwnerPathSegment[];
-/**
- * Base event payload shape.
- * Emitters may add additional fields, but MUST keep linkage information explicit.
- */
-interface IBaseEventData {
-  /** Timestamp when the event was emitted. This is required for deterministic ordering. */
-  timestamp: Date;
-  /** Optional structured metadata */
-  metadata?: TEventLoggerData;
-  /** Extensible fields for event-specific payloads */
-  [key: string]: TEventExtensionValue | undefined;
+/** Module execution result */
+interface IModuleExecutionResult {
+  success: boolean;
+  data?: IModuleResultData;
+  error?: Error;
+  duration?: number;
+  metadata?: Record<string, string | number | boolean | Date>;
 }
-/**
- * Execution-related event payload.
- */
-interface IExecutionEventData extends IBaseEventData {}
-/**
- * Tool-related event payload.
- */
-interface IToolEventData extends IBaseEventData {
-  toolName?: string;
-  parameters?: Record<string, TEventUniversalValue>;
+/** Module result data */
+interface IModuleResultData {
+  [key: string]: string | number | boolean | Record<string, string | number | boolean> | undefined;
 }
-/**
- * Agent-related event payload.
- */
-interface IAgentEventData extends IBaseEventData {
-  agentId?: string;
+/** Base module options */
+interface IBaseModuleOptions {
+  enabled?: boolean;
+  config?: Record<string, string | number | boolean>;
 }
-type TEventListener = (eventType: string, data: IBaseEventData, context?: IEventContext) => void;
-/**
- * Minimal EventService contract for emitting events.
- */
-interface IEventService {
-  emit(eventType: string, data: IBaseEventData, context?: IEventContext): void;
-  subscribe(listener: TEventListener): void;
-  unsubscribe(listener: TEventListener): void;
+/** Module capabilities */
+interface IModuleCapabilities {
+  capabilities: string[];
+  dependencies?: string[];
+  optionalDependencies?: string[];
 }
-/**
- * Explicit owner binding information used for scoped event emission.
- */
-interface IEventServiceOwnerBinding {
+/** Module type descriptor */
+interface IModuleDescriptor {
+  type: string;
+  category: ModuleCategory;
+  layer: ModuleLayer;
+  dependencies?: string[];
+  capabilities?: string[];
+}
+/** Module categories */
+declare enum ModuleCategory {
+  CORE = "core",
+  STORAGE = "storage",
+  PROCESSING = "processing",
+  INTEGRATION = "integration",
+  INTERFACE = "interface",
+  CAPABILITY = "capability"
+}
+/** Module layers */
+declare enum ModuleLayer {
+  INFRASTRUCTURE = "infrastructure",
+  CORE = "core",
+  APPLICATION = "application",
+  DOMAIN = "domain",
+  PRESENTATION = "presentation"
+}
+/** Module data for introspection */
+interface IModuleData {
+  name: string;
+  version: string;
+  type: string;
+  enabled: boolean;
+  initialized: boolean;
+  capabilities: IModuleCapabilities;
+  metadata?: Record<string, string | number | boolean>;
+}
+/** Module statistics */
+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 */
+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;
+}
+//#endregion
+//#region src/utils/logger.d.ts
+/**
+ * Reusable type definitions for logger utility
+ */
+/**
+ * Log levels for the logger
+ */
+type TUtilLogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+/**
+ * Log entry structure
+ */
+interface IUtilLogEntry {
+  timestamp: string;
+  level: TUtilLogLevel;
+  message: string;
+  context?: TLoggerData;
+  packageName?: string;
+}
+/**
+ * Logger interface
+ */
+interface ILogger {
+  debug(...args: Array<TUniversalValue | TLoggerData | Error>): void;
+  info(...args: Array<TUniversalValue | TLoggerData | Error>): void;
+  warn(...args: Array<TUniversalValue | TLoggerData | Error>): void;
+  error(...args: Array<TUniversalValue | TLoggerData | Error>): void;
+  log(...args: Array<TUniversalValue | TLoggerData | Error>): void;
+  group?(label?: string): void;
+  groupEnd?(): void;
+}
+/**
+ * Silent logger that does nothing (Null Object Pattern)
+ *
+ * IMPORTANT:
+ * - This library must not write to stdio by default.
+ * - Inject a real logger explicitly if you want output.
+ */
+declare const SilentLogger: ILogger;
+/**
+ * Console logger implementation
+ * @internal
+ */
+declare class ConsoleLogger implements ILogger {
+  private level?;
+  private packageName;
+  private sinkLogger;
+  constructor(packageName: string, logger?: ILogger);
+  debug(...args: Array<TUniversalValue | TLoggerData | Error>): void;
+  info(...args: Array<TUniversalValue | TLoggerData | Error>): void;
+  warn(...args: Array<TUniversalValue | TLoggerData | Error>): void;
+  error(...args: Array<TUniversalValue | TLoggerData | Error>): void;
+  log(...args: Array<TUniversalValue | TLoggerData | Error>): void;
+  private getLevel;
+  private shouldLog;
+  private forward;
+}
+/**
+ * Create a named logger instance for a package or module.
+ * Use this to create loggers with a specific name prefix for easy log filtering.
+ */
+declare function createLogger(packageName: string, logger?: ILogger): ILogger;
+/**
+ * Set global log level for all loggers
+ */
+declare function setGlobalLogLevel(level: TUtilLogLevel): void;
+/**
+ * Get global log level
+ */
+declare function getGlobalLogLevel(): TUtilLogLevel;
+/**
+ * Default logger for the agents package
+ */
+declare const logger: ILogger;
+//#endregion
+//#region src/event-service/interfaces.d.ts
+/**
+ * @fileoverview Event service interface definitions.
+ *
+ * These interfaces are the single source of truth for event-related contracts
+ * within @robota-sdk/agent-core.
+ */
+/**
+ * Primitive value types for event payloads.
+ */
+type TEventPrimitiveValue = string | number | boolean | null | undefined;
+/**
+ * Recursive universal value type for event payloads (JSON-like + Date).
+ */
+type TEventUniversalValue = TEventPrimitiveValue | Date | TEventUniversalValue[] | IEventObjectValue;
+interface IEventObjectValue {
+  [key: string]: TEventUniversalValue;
+}
+/**
+ * Logger data type for event metadata.
+ */
+type TEventLoggerData = Record<string, TEventUniversalValue | Date | Error>;
+/**
+ * A single segment in an explicit ownerPath.
+ *
+ * Path-only rule:
+ * - Relationships must be derived from these explicit segments, not from parsing IDs.
+ */
+interface IOwnerPathSegment {
+  type: string;
+  id: string;
+}
+/**
+ * Event context that accompanies an emitted event.
+ * This is the single source of truth for deterministic linking in subscribers.
+ */
+interface IEventContext {
+  ownerType: string;
+  ownerId: string;
+  ownerPath: IOwnerPathSegment[];
+  /** Depth of the current execution in the hierarchy (0 = root) */
+  depth?: number;
+  /** Unique span identifier for distributed tracing correlation */
+  spanId?: string;
+  /** Optional structured metadata for debugging/observability */
+  metadata?: TEventLoggerData;
+}
+/**
+ * Allowed extension values for event payloads.
+ */
+type TEventExtensionValue = TEventUniversalValue | TEventLoggerData | Error | IEventContext | IOwnerPathSegment[];
+/**
+ * Base event payload shape.
+ * Emitters may add additional fields, but MUST keep linkage information explicit.
+ */
+interface IBaseEventData {
+  /** Timestamp when the event was emitted. This is required for deterministic ordering. */
+  timestamp: Date;
+  /** Optional structured metadata */
+  metadata?: TEventLoggerData;
+  /** Extensible fields for event-specific payloads */
+  [key: string]: TEventExtensionValue | undefined;
+}
+/**
+ * Execution-related event payload.
+ */
+interface IExecutionEventData extends IBaseEventData {}
+/**
+ * Tool-related event payload.
+ */
+interface IToolEventData extends IBaseEventData {
+  toolName?: string;
+  parameters?: Record<string, TEventUniversalValue>;
+}
+/**
+ * Agent-related event payload.
+ */
+interface IAgentEventData extends IBaseEventData {
+  agentId?: string;
+}
+type TEventListener = (eventType: string, data: IBaseEventData, context?: IEventContext) => void;
+/**
+ * Minimal EventService contract for emitting events.
+ */
+interface IEventService {
+  emit(eventType: string, data: IBaseEventData, context?: IEventContext): void;
+  subscribe(listener: TEventListener): void;
+  unsubscribe(listener: TEventListener): void;
+}
+/**
+ * Explicit owner binding information used for scoped event emission.
+ */
+interface IEventServiceOwnerBinding {
   ownerType: string;
   ownerId: string;
   ownerPath: IOwnerPathSegment[];
@@ -839,183 +1175,6 @@ interface IToolRegistry {
   clear(): void;
 }
 //#endregion
-//#region src/plugins/event-emitter/types.d.ts
-declare const EXECUTION_EVENT_NAMES: {
-  readonly START: "execution.start";
-  readonly COMPLETE: "execution.complete";
-  readonly ERROR: "execution.error";
-};
-declare const TOOL_EVENT_NAMES: {
-  readonly CALL_START: "tool.call_start";
-  readonly CALL_COMPLETE: "tool.call_complete";
-  readonly CALL_ERROR: "tool.call_error";
-};
-declare const AGENT_EVENT_NAMES: {
-  readonly EXECUTION_START: "agent.execution_start";
-  readonly EXECUTION_COMPLETE: "agent.execution_complete";
-  readonly EXECUTION_ERROR: "agent.execution_error";
-  readonly CREATED: "agent.created";
-};
-type TExecutionEventName = (typeof EXECUTION_EVENT_NAMES)[keyof typeof EXECUTION_EVENT_NAMES];
-type TToolEventName = (typeof TOOL_EVENT_NAMES)[keyof typeof TOOL_EVENT_NAMES];
-type TAgentEventName = (typeof AGENT_EVENT_NAMES)[keyof typeof AGENT_EVENT_NAMES];
-/**
- * Event types that can be emitted.
- *
- * IMPORTANT:
- * - Do not use string literals for event names outside this module.
- * - Import and use EVENT_EMITTER_EVENTS instead.
- */
-declare const EVENT_EMITTER_EVENTS: {
-  readonly EXECUTION_START: "execution.start";
-  readonly EXECUTION_COMPLETE: "execution.complete";
-  readonly EXECUTION_ERROR: "execution.error";
-  readonly TOOL_BEFORE_EXECUTE: "tool.beforeExecute";
-  readonly TOOL_AFTER_EXECUTE: "tool.afterExecute";
-  readonly TOOL_SUCCESS: "tool.success";
-  readonly TOOL_ERROR: "tool.call_error";
-  readonly CONVERSATION_START: "conversation.start";
-  readonly CONVERSATION_COMPLETE: "conversation.complete";
-  readonly CONVERSATION_ERROR: "conversation.error";
-  readonly AGENT_EXECUTION_START: "agent.execution_start";
-  readonly AGENT_EXECUTION_COMPLETE: "agent.execution_complete";
-  readonly AGENT_EXECUTION_ERROR: "agent.execution_error";
-  readonly AGENT_CREATED: "agent.created";
-  readonly AGENT_DESTROYED: "agent.destroyed";
-  readonly PLUGIN_LOADED: "plugin.loaded";
-  readonly PLUGIN_UNLOADED: "plugin.unloaded";
-  readonly PLUGIN_ERROR: "plugin.error";
-  readonly ERROR_OCCURRED: "error.occurred";
-  readonly WARNING_OCCURRED: "warning.occurred";
-  readonly MODULE_INITIALIZE_START: "module.initialize.start";
-  readonly MODULE_INITIALIZE_COMPLETE: "module.initialize.complete";
-  readonly MODULE_INITIALIZE_ERROR: "module.initialize.error";
-  readonly MODULE_EXECUTION_START: "module.execution.start";
-  readonly MODULE_EXECUTION_COMPLETE: "module.execution.complete";
-  readonly MODULE_EXECUTION_ERROR: "module.execution.error";
-  readonly MODULE_DISPOSE_START: "module.dispose.start";
-  readonly MODULE_DISPOSE_COMPLETE: "module.dispose.complete";
-  readonly MODULE_DISPOSE_ERROR: "module.dispose.error";
-  readonly MODULE_REGISTERED: "module.registered";
-  readonly MODULE_UNREGISTERED: "module.unregistered";
-  readonly EXECUTION_HIERARCHY: "execution.hierarchy";
-  readonly EXECUTION_REALTIME: "execution.realtime";
-  readonly TOOL_REALTIME: "tool.realtime";
-  readonly CUSTOM: "custom";
-};
-type TEventName = TExecutionEventName | TToolEventName | TAgentEventName | 'tool.beforeExecute' | 'tool.afterExecute' | 'tool.success' | 'conversation.start' | 'conversation.complete' | 'conversation.error' | 'agent.destroyed' | 'plugin.loaded' | 'plugin.unloaded' | 'plugin.error' | 'error.occurred' | 'warning.occurred' | 'module.initialize.start' | 'module.initialize.complete' | 'module.initialize.error' | 'module.execution.start' | 'module.execution.complete' | 'module.execution.error' | 'module.dispose.start' | 'module.dispose.complete' | 'module.dispose.error' | 'module.registered' | 'module.unregistered' | 'execution.hierarchy' | 'execution.realtime' | 'tool.realtime' | 'custom';
-/**
- * Valid event data value types
- */
-type TEventDataValue = string | number | boolean | Date | null | undefined | TEventDataValue[] | {
-  [key: string]: TEventDataValue;
-};
-/**
- * Event data structure
- */
-interface IEventEmitterEventData {
-  type: TEventName;
-  timestamp: Date;
-  executionId?: string;
-  sessionId?: string;
-  userId?: string;
-  data?: Record<string, TEventDataValue>;
-  error?: Error;
-  metadata?: Record<string, TEventDataValue>;
-}
-/**
- * Event listener function
- */
-type TEventEmitterListener = (event: IEventEmitterEventData) => void | Promise<void>;
-/**
- * Console-like interface for the EventEmitterPlugin.
- *
- * Use this interface for typing instead of the concrete EventEmitterPlugin class.
- */
-interface IEventEmitterPlugin {
-  on(eventType: TEventName, listener: TEventEmitterListener, options?: {
-    once?: boolean;
-    filter?: (event: IEventEmitterEventData) => boolean;
-  }): string;
-  once(eventType: TEventName, listener: TEventEmitterListener, filter?: (event: IEventEmitterEventData) => boolean): string;
-  off(eventType: TEventName, handlerIdOrListener: string | TEventEmitterListener): boolean;
-  emit(eventType: TEventName, eventData?: Partial<IEventEmitterEventData>): Promise<void>;
-}
-//#endregion
-//#region src/utils/logger.d.ts
-/**
- * Reusable type definitions for logger utility
- */
-/**
- * Log levels for the logger
- */
-type TUtilLogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
-/**
- * Log entry structure
- */
-interface IUtilLogEntry {
-  timestamp: string;
-  level: TUtilLogLevel;
-  message: string;
-  context?: TLoggerData;
-  packageName?: string;
-}
-/**
- * Logger interface
- */
-interface ILogger {
-  debug(...args: Array<TUniversalValue | TLoggerData | Error>): void;
-  info(...args: Array<TUniversalValue | TLoggerData | Error>): void;
-  warn(...args: Array<TUniversalValue | TLoggerData | Error>): void;
-  error(...args: Array<TUniversalValue | TLoggerData | Error>): void;
-  log(...args: Array<TUniversalValue | TLoggerData | Error>): void;
-  group?(label?: string): void;
-  groupEnd?(): void;
-}
-/**
- * Silent logger that does nothing (Null Object Pattern)
- *
- * IMPORTANT:
- * - This library must not write to stdio by default.
- * - Inject a real logger explicitly if you want output.
- */
-declare const SilentLogger: ILogger;
-/**
- * Console logger implementation
- * @internal
- */
-declare class ConsoleLogger implements ILogger {
-  private level?;
-  private packageName;
-  private sinkLogger;
-  constructor(packageName: string, logger?: ILogger);
-  debug(...args: Array<TUniversalValue | TLoggerData | Error>): void;
-  info(...args: Array<TUniversalValue | TLoggerData | Error>): void;
-  warn(...args: Array<TUniversalValue | TLoggerData | Error>): void;
-  error(...args: Array<TUniversalValue | TLoggerData | Error>): void;
-  log(...args: Array<TUniversalValue | TLoggerData | Error>): void;
-  private getLevel;
-  private shouldLog;
-  private forward;
-}
-/**
- * Create a named logger instance for a package or module.
- * Use this to create loggers with a specific name prefix for easy log filtering.
- */
-declare function createLogger(packageName: string, logger?: ILogger): ILogger;
-/**
- * Set global log level for all loggers
- */
-declare function setGlobalLogLevel(level: TUtilLogLevel): void;
-/**
- * Get global log level
- */
-declare function getGlobalLogLevel(): TUtilLogLevel;
-/**
- * Default logger for the agents package
- */
-declare const logger: ILogger;
-//#endregion
 //#region src/abstracts/abstract-plugin-types.d.ts
 /** Plugin categories for classification */
 declare enum PluginCategory {
@@ -1225,100 +1384,6 @@ declare abstract class AbstractPlugin<TOptions extends IPluginOptions = IPluginO
   onModuleEvent?(eventName: TEventName, eventData: IEventEmitterEventData): Promise<void>;
 }
 //#endregion
-//#region src/abstracts/abstract-module-types.d.ts
-/** Module execution context */
-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 */
-interface IModuleExecutionResult {
-  success: boolean;
-  data?: IModuleResultData;
-  error?: Error;
-  duration?: number;
-  metadata?: Record<string, string | number | boolean | Date>;
-}
-/** Module result data */
-interface IModuleResultData {
-  [key: string]: string | number | boolean | Record<string, string | number | boolean> | undefined;
-}
-/** Base module options */
-interface IBaseModuleOptions {
-  enabled?: boolean;
-  config?: Record<string, string | number | boolean>;
-}
-/** Module capabilities */
-interface IModuleCapabilities {
-  capabilities: string[];
-  dependencies?: string[];
-  optionalDependencies?: string[];
-}
-/** Module type descriptor */
-interface IModuleDescriptor {
-  type: string;
-  category: ModuleCategory;
-  layer: ModuleLayer;
-  dependencies?: string[];
-  capabilities?: string[];
-}
-/** Module categories */
-declare enum ModuleCategory {
-  CORE = "core",
-  STORAGE = "storage",
-  PROCESSING = "processing",
-  INTEGRATION = "integration",
-  INTERFACE = "interface",
-  CAPABILITY = "capability"
-}
-/** Module layers */
-declare enum ModuleLayer {
-  INFRASTRUCTURE = "infrastructure",
-  CORE = "core",
-  APPLICATION = "application",
-  DOMAIN = "domain",
-  PRESENTATION = "presentation"
-}
-/** Module data for introspection */
-interface IModuleData {
-  name: string;
-  version: string;
-  type: string;
-  enabled: boolean;
-  initialized: boolean;
-  capabilities: IModuleCapabilities;
-  metadata?: Record<string, string | number | boolean>;
-}
-/** Module statistics */
-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 */
-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;
-}
-//#endregion
 //#region src/abstracts/abstract-tool.d.ts
 /**
  * Options for AbstractTool construction
@@ -1460,80 +1525,15 @@ declare abstract class AbstractTool<TParameters = TToolParameters, TResult = ITo
   getName(): string;
 }
 //#endregion
-//#region src/interfaces/cache.d.ts
+//#region src/interfaces/agent.d.ts
 /**
- * Cache key identifying a unique LLM execution request
- */
-interface ICacheKey {
-  /** SHA-256 hash of the serialized request */
-  hash: string;
-  /** Model identifier */
-  model: string;
-  /** Provider name */
-  provider: string;
-}
-/**
- * Cached LLM response entry
- */
-interface ICacheEntry {
-  /** Cache key that produced this entry */
-  key: ICacheKey;
-  /** Cached response content */
-  response: string;
-  /** When the entry was cached */
-  timestamp: number;
-  /** SHA-256 integrity hash of the response */
-  integrityHash: string;
-}
-/**
- * Cache storage interface for pluggable backends
- */
-interface ICacheStorage {
-  /** Retrieve a cached entry by key hash */
-  get(hash: string): ICacheEntry | undefined;
-  /** Store a cache entry */
-  set(entry: ICacheEntry): void;
-  /** Delete a cached entry by key hash */
-  delete(hash: string): boolean;
-  /** Clear all cached entries */
-  clear(): void;
-  /** Get cache statistics */
-  getStats(): ICacheStats;
-}
-/**
- * Cache performance statistics
- */
-interface ICacheStats {
-  /** Number of cache hits */
-  hits: number;
-  /** Number of cache misses */
-  misses: number;
-  /** Current number of cached entries */
-  entries: number;
-  /** Hit rate (hits / (hits + misses)), 0 if no lookups */
-  hitRate: number;
-}
-/**
- * Configuration options for execution caching
- */
-interface ICacheOptions {
-  /** Whether caching is enabled */
-  enabled: boolean;
-  /** Maximum number of cached entries */
-  maxEntries: number;
-  /** Time-to-live in milliseconds */
-  ttlMs: number;
-}
-//#endregion
-//#region src/interfaces/agent.d.ts
-/**
- * IExecutionContextInjection
- *
- * Minimal context payload used to inject an existing ownerPath into a new agent instance
- * (e.g., when a tool creates an agent and must preserve absolute ownerPath semantics).
- *
- * NOTE: This is intentionally NOT ToolExecutionContext. ToolExecutionContext is for tool calls
- * and requires toolName/parameters; agent creation only needs ownerPath and execution linkage.
+ * IExecutionContextInjection
+ *
+ * Minimal context payload used to inject an existing ownerPath into a new agent instance
+ * (e.g., when a tool creates an agent and must preserve absolute ownerPath semantics).
+ *
+ * NOTE: This is intentionally NOT ToolExecutionContext. ToolExecutionContext is for tool calls
+ * and requires toolName/parameters; agent creation only needs ownerPath and execution linkage.
  */
 interface IExecutionContextInjection {
   ownerPath?: IOwnerPathSegment[];
@@ -3181,34 +3181,6 @@ declare function stopPeriodicTask(timer: TTimerId | undefined): void;
  */
 type TTimerId = ReturnType<typeof setTimeout>;
 //#endregion
-//#region src/managers/conversation-message-factory.d.ts
-/** Create a user message. */
-declare function createUserMessage(content: string, options?: {
-  name?: string;
-  metadata?: TUniversalMessageMetadata;
-  parts?: TUniversalMessagePart[];
-}): IUserMessage;
-/** Create an assistant message. */
-declare function createAssistantMessage(content: string | null, options?: {
-  toolCalls?: IToolCall[];
-  metadata?: TUniversalMessageMetadata;
-  parts?: TUniversalMessagePart[];
-  state?: TMessageState;
-}): IAssistantMessage;
-/** Create a system message. */
-declare function createSystemMessage(content: string, options?: {
-  name?: string;
-  metadata?: TUniversalMessageMetadata;
-  parts?: TUniversalMessagePart[];
-}): ISystemMessage;
-/** Create a tool message. */
-declare function createToolMessage(content: string, options: {
-  toolCallId: string;
-  name?: string;
-  metadata?: TUniversalMessageMetadata;
-  parts?: TUniversalMessagePart[];
-}): IToolMessage;
-//#endregion
 //#region src/managers/conversation-store.d.ts
 /** API message format for provider consumption */
 interface IProviderApiMessage {
@@ -3269,6 +3241,34 @@ declare class ConversationStore implements IConversationHistory {
   clear(): void;
 }
 //#endregion
+//#region src/managers/conversation-message-factory.d.ts
+/** Create a user message. */
+declare function createUserMessage(content: string, options?: {
+  name?: string;
+  metadata?: TUniversalMessageMetadata;
+  parts?: TUniversalMessagePart[];
+}): IUserMessage;
+/** Create an assistant message. */
+declare function createAssistantMessage(content: string | null, options?: {
+  toolCalls?: IToolCall[];
+  metadata?: TUniversalMessageMetadata;
+  parts?: TUniversalMessagePart[];
+  state?: TMessageState;
+}): IAssistantMessage;
+/** Create a system message. */
+declare function createSystemMessage(content: string, options?: {
+  name?: string;
+  metadata?: TUniversalMessageMetadata;
+  parts?: TUniversalMessagePart[];
+}): ISystemMessage;
+/** Create a tool message. */
+declare function createToolMessage(content: string, options: {
+  toolCallId: string;
+  name?: string;
+  metadata?: TUniversalMessageMetadata;
+  parts?: TUniversalMessagePart[];
+}): IToolMessage;
+//#endregion
 //#region src/managers/conversation-history-manager.d.ts
 /** Interface for managing conversation history. @public */
 interface IConversationHistory {
@@ -3500,10 +3500,6 @@ declare class EventEmitterPlugin extends AbstractPlugin<IEventEmitterPluginOptio
   destroy(): Promise<void>;
 }
 //#endregion
-//#region src/core/robota-config-manager.d.ts
-/** Agent statistics metadata type */
-type TAgentStatsMetadata = Record<string, string | number | boolean | Date | string[]>;
-//#endregion
 //#region src/core/robota-types.d.ts
 /** Shared model configuration shape used in setModel / getModel. */
 interface IModelConfig {
@@ -3587,6 +3583,252 @@ declare abstract class RobotaBase extends AbstractAgent<IAgentConfig, IRunOption
   getModuleStats(moduleName: string): TModuleStats;
 }
 //#endregion
+//#region src/managers/ai-provider-manager.d.ts
+/**
+ * AI Provider Manager - manages AI provider instances
+ * Manages registration, selection, and state of AI providers
+ * Instance-based for isolated provider management
+ * @internal
+ */
+declare class AIProviders extends AbstractManager implements IAIProviderManager {
+  private providers;
+  private currentProvider;
+  private currentModel;
+  constructor();
+  /**
+   * Initialize the manager
+   */
+  protected doInitialize(): Promise<void>;
+  /**
+   * Cleanup manager resources
+   */
+  protected doDispose(): Promise<void>;
+  /**
+   * Register an AI provider
+   */
+  addProvider(name: string, provider: IAIProvider): void;
+  /**
+   * Remove an AI provider
+   */
+  removeProvider(name: string): void;
+  /**
+   * Get registered provider by name
+   */
+  getProvider(name: string): IAIProvider | undefined;
+  /**
+   * Get all registered providers
+   */
+  getProviders(): Record<string, IAIProvider>;
+  /**
+   * Set current provider and model
+   */
+  setCurrentProvider(name: string, model: string): void;
+  /**
+   * Get current provider and model
+   */
+  getCurrentProvider(): {
+    provider: string;
+    model: string;
+  } | undefined;
+  /**
+   * Check if provider is configured
+   */
+  isConfigured(): boolean;
+  /**
+   * Get available models for a provider
+   * Note: In the new architecture, models are handled by each provider internally
+   */
+  getAvailableModels(providerName: string): string[];
+  /**
+   * Get current provider instance
+   */
+  getCurrentProviderInstance(): IAIProvider | undefined;
+  /**
+   * Get provider names
+   */
+  getProviderNames(): string[];
+  /**
+   * Get providers by pattern
+   */
+  getProvidersByPattern(pattern: string | RegExp): Record<string, IAIProvider>;
+  /**
+   * Check if provider supports streaming
+   */
+  supportsStreaming(providerName?: string): boolean;
+  /**
+   * Get provider count
+   */
+  getProviderCount(): number;
+}
+//#endregion
+//#region src/tool-registry/tool-registry.d.ts
+/**
+ * Tool registry implementation
+ * Manages tool registration, validation, and retrieval
+ */
+declare class ToolRegistry implements IToolRegistry {
+  private tools;
+  /**
+   * Register a tool
+   */
+  register(tool: ITool): void;
+  /**
+   * Unregister a tool
+   */
+  unregister(name: string): void;
+  /**
+   * Get tool by name
+   */
+  get(name: string): ITool | undefined;
+  /**
+   * Get all registered tools
+   */
+  getAll(): ITool[];
+  /**
+   * Get tool schemas
+   */
+  getSchemas(): IToolSchema[];
+  /**
+   * Check if tool exists
+   */
+  has(name: string): boolean;
+  /**
+   * Clear all tools
+   */
+  clear(): void;
+  /**
+   * Get tool names
+   */
+  getToolNames(): string[];
+  /**
+   * Get tools by pattern
+   */
+  getToolsByPattern(pattern: string | RegExp): ITool[];
+  /**
+   * Get tool count
+   */
+  size(): number;
+  /**
+   * Validate tool schema
+   */
+  private validateToolSchema;
+}
+//#endregion
+//#region src/managers/tool-manager.d.ts
+/**
+ * Tool Manager - manages tool registration and execution
+ * Manages tool registration and execution using Tool Registry
+ * Instance-based for isolated tool management
+ * @internal
+ */
+declare class Tools extends AbstractManager implements IToolManager {
+  private registry;
+  private allowedTools?;
+  constructor();
+  /**
+   * Initialize the manager
+   */
+  protected doInitialize(): Promise<void>;
+  /**
+   * Cleanup manager resources
+   */
+  protected doDispose(): Promise<void>;
+  /**
+   * Register a tool with schema and executor function
+   */
+  addTool(schema: IToolSchema, executor: TToolExecutor): void;
+  /**
+   * Remove a tool by name
+   */
+  removeTool(name: string): void;
+  /**
+   * Get tool interface by name
+   */
+  getTool(name: string): ITool | undefined;
+  /**
+   * Get tool schema by name
+   */
+  getToolSchema(name: string): IToolSchema | undefined;
+  /**
+   * Get all registered tool schemas
+   */
+  getTools(): IToolSchema[];
+  /**
+   * Execute a tool with parameters
+   */
+  executeTool(name: string, parameters: TToolParameters, context?: IToolExecutionContext): Promise<TUniversalValue>;
+  /**
+   * Check if tool exists
+   */
+  hasTool(name: string): boolean;
+  /**
+   * Set allowed tools for filtering
+   */
+  setAllowedTools(tools: string[]): void;
+  /**
+   * Get allowed tools
+   */
+  getAllowedTools(): string[] | undefined;
+  /**
+   * Get tool registry instance (for advanced operations)
+   */
+  getRegistry(): ToolRegistry;
+  /**
+   * Get tool count
+   */
+  getToolCount(): number;
+}
+//#endregion
+//#region src/core/robota-config-manager.d.ts
+/** Agent statistics metadata type */
+type TAgentStatsMetadata = Record<string, string | number | boolean | Date | string[]>;
+//#endregion
+//#region src/services/execution-constants.d.ts
+/**
+ * ExecutionService owned events.
+ * Local event names only (no dots). Full names are composed at emit time.
+ */
+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";
+};
+declare const EXECUTION_EVENT_PREFIX: "execution";
+//#endregion
+//#region src/core/robota-lifecycle.d.ts
+/** Dependencies required by getStats. @internal */
+interface IRobotaStatsDeps {
+  readonly name: string;
+  readonly version: string;
+  readonly conversationId: string;
+  readonly startTime: number;
+  readonly isFullyInitialized: boolean;
+  aiProviders: AIProviders;
+  tools: Tools;
+  getPluginNames(): string[];
+  getModuleNames(): string[];
+  getHistory(): TUniversalMessage[];
+}
+/** Build comprehensive agent statistics. @internal */
+declare function buildAgentStats(deps: IRobotaStatsDeps): {
+  name: string;
+  version: string;
+  conversationId: string;
+  providers: string[];
+  currentProvider: string | null;
+  tools: string[];
+  plugins: string[];
+  modules: string[];
+  historyLength: number;
+  historyStats: TAgentStatsMetadata;
+  uptime: number;
+};
+//#endregion
 //#region src/core/robota.d.ts
 /** @public */
 declare class Robota extends RobotaBase implements IAgent<IAgentConfig, IRunOptions, TUniversalMessage> {
@@ -3634,19 +3876,7 @@ declare class Robota extends RobotaBase implements IAgent<IAgentConfig, IRunOpti
   registerTool(tool: AbstractTool): void;
   unregisterTool(toolName: string): void;
   getConfig(): IAgentConfig;
-  getStats(): {
-    name: string;
-    version: string;
-    conversationId: string;
-    providers: string[];
-    currentProvider: string | null;
-    tools: string[];
-    plugins: string[];
-    modules: string[];
-    historyLength: number;
-    historyStats: TAgentStatsMetadata;
-    uptime: number;
-  };
+  getStats(): ReturnType<typeof buildAgentStats>;
   destroy(): Promise<void>;
   protected initialize(): Promise<void>;
   private ensureFullyInitialized;
@@ -3654,6 +3884,51 @@ declare class Robota extends RobotaBase implements IAgent<IAgentConfig, IRunOpti
   private emitAgentEvent;
 }
 //#endregion
+//#region src/managers/agent-factory-helpers.d.ts
+/**
+ * Configuration options for AgentFactory
+ */
+interface IAgentFactoryOptions {
+  /** Default model to use if not specified in config */
+  defaultModel?: string;
+  /** Default provider to use if not specified in config */
+  defaultProvider?: string;
+  /** Maximum number of concurrent agents */
+  maxConcurrentAgents?: number;
+  /** Default system message for agents */
+  defaultSystemMessage?: string;
+  /** Enable strict configuration validation */
+  strictValidation?: boolean;
+}
+/**
+ * Agent creation statistics
+ */
+interface IAgentCreationStats {
+  /** Total number of agents created */
+  totalCreated: number;
+  /** Number of currently active agents */
+  activeCount: number;
+  /** Number of agents created from templates */
+  fromTemplates: number;
+  /** Number of custom configured agents */
+  customConfigured: number;
+  /** Template vs custom creation ratio (fromTemplates / totalCreated) */
+  templateUsageRatio: number;
+}
+/**
+ * Agent lifecycle events
+ */
+interface IAgentLifecycleEvents {
+  /** Called before agent creation */
+  beforeCreate?: (config: IAgentConfig) => Promise<void> | void;
+  /** Called after successful agent creation */
+  afterCreate?: (agent: IAgent<IAgentConfig>, config: IAgentConfig) => Promise<void> | void;
+  /** Called when agent creation fails */
+  onCreateError?: (error: Error, config: IAgentConfig) => Promise<void> | void;
+  /** Called when agent is destroyed */
+  onDestroy?: (agentId: string) => Promise<void> | void;
+}
+//#endregion
 //#region src/managers/agent-templates.d.ts
 /**
  * Template application result
@@ -3730,51 +4005,6 @@ declare class AgentTemplates {
   };
 }
 //#endregion
-//#region src/managers/agent-factory-helpers.d.ts
-/**
- * Configuration options for AgentFactory
- */
-interface IAgentFactoryOptions {
-  /** Default model to use if not specified in config */
-  defaultModel?: string;
-  /** Default provider to use if not specified in config */
-  defaultProvider?: string;
-  /** Maximum number of concurrent agents */
-  maxConcurrentAgents?: number;
-  /** Default system message for agents */
-  defaultSystemMessage?: string;
-  /** Enable strict configuration validation */
-  strictValidation?: boolean;
-}
-/**
- * Agent creation statistics
- */
-interface IAgentCreationStats {
-  /** Total number of agents created */
-  totalCreated: number;
-  /** Number of currently active agents */
-  activeCount: number;
-  /** Number of agents created from templates */
-  fromTemplates: number;
-  /** Number of custom configured agents */
-  customConfigured: number;
-  /** Template vs custom creation ratio (fromTemplates / totalCreated) */
-  templateUsageRatio: number;
-}
-/**
- * Agent lifecycle events
- */
-interface IAgentLifecycleEvents {
-  /** Called before agent creation */
-  beforeCreate?: (config: IAgentConfig) => Promise<void> | void;
-  /** Called after successful agent creation */
-  afterCreate?: (agent: IAgent<IAgentConfig>, config: IAgentConfig) => Promise<void> | void;
-  /** Called when agent creation fails */
-  onCreateError?: (error: Error, config: IAgentConfig) => Promise<void> | void;
-  /** Called when agent is destroyed */
-  onDestroy?: (agentId: string) => Promise<void> | void;
-}
-//#endregion
 //#region src/managers/agent-factory.d.ts
 /**
  * Agent Factory for creating and managing agents
@@ -3877,23 +4107,6 @@ declare class EventHistoryModule implements IEventHistoryModule {
   private nextSequenceId;
 }
 //#endregion
-//#region src/services/execution-constants.d.ts
-/**
- * ExecutionService owned events.
- * Local event names only (no dots). Full names are composed at emit time.
- */
-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";
-};
-declare const EXECUTION_EVENT_PREFIX: "execution";
-//#endregion
 //#region src/services/tool-execution-service.d.ts
 /**
  * ToolExecutionService owned events