@robota-sdk/agent-core 3.0.0-beta.4 → 3.0.0-beta.43

package/dist/abstracts/abstract-executor.d.ts

@@ -1,110 +0,0 @@
-import type { IExecutor, IChatExecutionRequest, IStreamExecutionRequest } from '../interfaces/executor';
-import type { TUniversalMessage, IAssistantMessage } from '../interfaces/messages';
-import type { TLoggerData } from '../interfaces/types';
-import type { ILogger } from '../utils/logger';
-/**
- * @fileoverview Abstract Executor Base Class
- *
- * 🎯 ABSTRACT CLASS - DO NOT DEPEND ON CONCRETE IMPLEMENTATIONS
- *
- * Provides shared execution helpers (retry, timeout, validation, logging) for all
- * executor implementations. Concrete executors should extend this class and inject
- * their own logger implementation if they need custom logging behavior.
- *
- * @example
- * ```typescript
- * export class MyCustomExecutor extends AbstractExecutor {
- *   async executeChat(request: IChatExecutionRequest): Promise<AssistantMessage> {
- *     return this.withRetry(() => this.performChat(request));
- *   }
- * }
- * ```
- */
-export declare abstract class AbstractExecutor implements IExecutor {
-    /**
-     * Logger injected via constructor (defaults to abstract logger)
-     */
-    protected readonly logger: ILogger;
-    constructor(logger?: ILogger);
-    abstract readonly name: string;
-    abstract readonly version: string;
-    /**
-     * Execute a chat completion request
-     * Must be implemented by concrete executor classes
-     */
-    abstract executeChat(request: IChatExecutionRequest): Promise<IAssistantMessage>;
-    /**
-     * Execute a streaming chat completion request
-     * Optional - can be implemented by concrete executor classes
-     */
-    abstract executeChatStream?(request: IStreamExecutionRequest): AsyncIterable<TUniversalMessage>;
-    /**
-     * Check if the executor supports tool calling
-     * Default implementation returns false, can be overridden
-     */
-    supportsTools(): boolean;
-    /**
-     * Validate executor configuration
-     * Default implementation returns true, can be overridden
-     */
-    validateConfig(): boolean;
-    /**
-     * Clean up resources when executor is no longer needed
-     * Default implementation does nothing, can be overridden
-     */
-    dispose?(): Promise<void>;
-    /**
-     * Execute function with retry logic
-     *
-     * @param fn - Function to execute with retries
-     * @param maxRetries - Maximum number of retry attempts (default: 3)
-     * @param retryDelay - Delay between retries in milliseconds (default: 1000)
-     * @returns Promise resolving to function result
-     */
-    protected withRetry<T>(fn: () => Promise<T>, maxRetries?: number, retryDelay?: number): Promise<T>;
-    /**
-     * Execute function with timeout
-     *
-     * @param promise - Promise to execute with timeout
-     * @param timeoutMs - Timeout in milliseconds
-     * @returns Promise resolving to function result
-     */
-    protected withTimeout<T>(promise: Promise<T>, timeoutMs: number): Promise<T>;
-    /**
-     * Delay execution for specified milliseconds
-     *
-     * @param ms - Milliseconds to delay
-     * @returns Promise that resolves after the delay
-     */
-    protected delay(ms: number): Promise<void>;
-    /**
-     * Log debug information (only if logging is enabled)
-     *
-     * @param message - Log message
-     * @param data - Optional data to log
-     */
-    protected logDebug(message: string, data?: TLoggerData): void;
-    /**
-     * Log error information
-     *
-     * @param message - Log message
-     * @param error - Error object
-     * @param data - Optional additional data
-     */
-    protected logError(message: string, error: Error, data?: TLoggerData): void;
-    /**
-     * Validate that request has required fields
-     *
-     * @param request - Chat execution request to validate
-     * @throws Error if validation fails
-     */
-    protected validateRequest(request: IChatExecutionRequest): void;
-    /**
-     * Validate that response is properly formatted
-     *
-     * @param response - Response to validate
-     * @throws Error if validation fails
-     */
-    protected validateResponse(response: TUniversalMessage): void;
-}
-//# sourceMappingURL=abstract-executor.d.ts.map

package/dist/abstracts/abstract-executor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"abstract-executor.d.ts","sourceRoot":"","sources":["../../src/abstracts/abstract-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,SAAS,EACT,qBAAqB,EACrB,uBAAuB,EAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG/C;;;;;;;;;;;;;;;;;GAiBG;AACH,8BAAsB,gBAAiB,YAAW,SAAS;IACvD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;gBAEvB,MAAM,GAAE,OAAsB;IAI1C,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAElC;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAEhF;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,CAAC,OAAO,EAAE,uBAAuB,GAAG,aAAa,CAAC,iBAAiB,CAAC;IAE/F;;;OAGG;IACH,aAAa,IAAI,OAAO;IAIxB;;;OAGG;IACH,cAAc,IAAI,OAAO;IAIzB;;;OAGG;IACG,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B;;;;;;;OAOG;cACa,SAAS,CAAC,CAAC,EACvB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,UAAU,GAAE,MAAU,EACtB,UAAU,GAAE,MAAa,GAC1B,OAAO,CAAC,CAAC,CAAC;IAuBb;;;;;;OAMG;cACa,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAUlF;;;;;OAKG;IACH,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI;IAI7D;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI;IAQ3E;;;;;OAKG;IACH,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAc/D;;;;;OAKG;IACH,SAAS,CAAC,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;CAShE"}

package/dist/abstracts/abstract-executor.js

@@ -1,156 +0,0 @@
-import { SilentLogger } from '../utils/logger';
-/**
- * @fileoverview Abstract Executor Base Class
- *
- * 🎯 ABSTRACT CLASS - DO NOT DEPEND ON CONCRETE IMPLEMENTATIONS
- *
- * Provides shared execution helpers (retry, timeout, validation, logging) for all
- * executor implementations. Concrete executors should extend this class and inject
- * their own logger implementation if they need custom logging behavior.
- *
- * @example
- * ```typescript
- * export class MyCustomExecutor extends AbstractExecutor {
- *   async executeChat(request: IChatExecutionRequest): Promise<AssistantMessage> {
- *     return this.withRetry(() => this.performChat(request));
- *   }
- * }
- * ```
- */
-export class AbstractExecutor {
-    /**
-     * Logger injected via constructor (defaults to abstract logger)
-     */
-    logger;
-    constructor(logger = SilentLogger) {
-        this.logger = logger;
-    }
-    /**
-     * Check if the executor supports tool calling
-     * Default implementation returns false, can be overridden
-     */
-    supportsTools() {
-        return false;
-    }
-    /**
-     * Validate executor configuration
-     * Default implementation returns true, can be overridden
-     */
-    validateConfig() {
-        return true;
-    }
-    /**
-     * Clean up resources when executor is no longer needed
-     * Default implementation does nothing, can be overridden
-     */
-    async dispose() {
-        // Default: no cleanup needed
-    }
-    /**
-     * Execute function with retry logic
-     *
-     * @param fn - Function to execute with retries
-     * @param maxRetries - Maximum number of retry attempts (default: 3)
-     * @param retryDelay - Delay between retries in milliseconds (default: 1000)
-     * @returns Promise resolving to function result
-     */
-    async withRetry(fn, maxRetries = 3, retryDelay = 1000) {
-        let lastError;
-        for (let attempt = 0; attempt <= maxRetries; attempt++) {
-            try {
-                return await fn();
-            }
-            catch (error) {
-                lastError = error instanceof Error ? error : new Error(String(error));
-                if (attempt < maxRetries) {
-                    this.logger.warn?.(`[${this.name}] Attempt ${attempt + 1} failed, retrying in ${retryDelay}ms`, {
-                        error: lastError.message,
-                        attempt: attempt + 1,
-                        maxRetries
-                    });
-                    await this.delay(retryDelay);
-                }
-            }
-        }
-        throw lastError;
-    }
-    /**
-     * Execute function with timeout
-     *
-     * @param promise - Promise to execute with timeout
-     * @param timeoutMs - Timeout in milliseconds
-     * @returns Promise resolving to function result
-     */
-    async withTimeout(promise, timeoutMs) {
-        const timeoutPromise = new Promise((_, reject) => {
-            setTimeout(() => {
-                reject(new Error(`Operation timed out after ${timeoutMs}ms`));
-            }, timeoutMs);
-        });
-        return Promise.race([promise, timeoutPromise]);
-    }
-    /**
-     * Delay execution for specified milliseconds
-     *
-     * @param ms - Milliseconds to delay
-     * @returns Promise that resolves after the delay
-     */
-    delay(ms) {
-        return new Promise(resolve => setTimeout(resolve, ms));
-    }
-    /**
-     * Log debug information (only if logging is enabled)
-     *
-     * @param message - Log message
-     * @param data - Optional data to log
-     */
-    logDebug(message, data) {
-        this.logger.debug?.(`[${this.name}] ${message}`, data);
-    }
-    /**
-     * Log error information
-     *
-     * @param message - Log message
-     * @param error - Error object
-     * @param data - Optional additional data
-     */
-    logError(message, error, data) {
-        this.logger.error?.(`[${this.name}] ${message}`, {
-            error: error.message,
-            stack: error.stack,
-            ...data
-        });
-    }
-    /**
-     * Validate that request has required fields
-     *
-     * @param request - Chat execution request to validate
-     * @throws Error if validation fails
-     */
-    validateRequest(request) {
-        if (!request.messages || request.messages.length === 0) {
-            throw new Error('Request must include at least one message');
-        }
-        if (!request.provider) {
-            throw new Error('Request must specify a provider');
-        }
-        if (!request.model) {
-            throw new Error('Request must specify a model');
-        }
-    }
-    /**
-     * Validate that response is properly formatted
-     *
-     * @param response - Response to validate
-     * @throws Error if validation fails
-     */
-    validateResponse(response) {
-        if (!response.role) {
-            throw new Error('Response must have a role');
-        }
-        if (!response.content) {
-            throw new Error('Response must have content');
-        }
-    }
-}
-//# sourceMappingURL=abstract-executor.js.map

package/dist/abstracts/abstract-executor.js.map

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

package/dist/abstracts/abstract-manager.d.ts

@@ -1,42 +0,0 @@
-/**
- * @fileoverview Abstract Manager Base Class
- *
- * 🎯 ABSTRACT CLASS - DO NOT IMPORT CONCRETE IMPLEMENTATIONS
- *
- * This class defines the common lifecycle contract for all manager implementations.
- * It enforces explicit initialization/disposal semantics so that subclasses can
- * provide their own resource management logic while sharing guard rails.
- *
- * Architectural rules:
- * - Depends only on abstractions (no concrete manager implementations)
- * - Provides finalize hooks (`doInitialize`, `doDispose`) for subclasses
- * - Guards public APIs via `ensureInitialized`
- */
-export declare abstract class AbstractManager {
-    protected initialized: boolean;
-    /**
-     * Initialize the manager (idempotent)
-     */
-    initialize(): Promise<void>;
-    /**
-     * Subclass-specific initialization logic
-     */
-    protected abstract doInitialize(): Promise<void>;
-    /**
-     * Dispose manager resources (idempotent)
-     */
-    dispose(): Promise<void>;
-    /**
-     * Subclass-specific disposal logic
-     */
-    protected abstract doDispose(): Promise<void>;
-    /**
-     * Whether the manager completed initialization
-     */
-    isInitialized(): boolean;
-    /**
-     * Ensure manager is initialized before performing operations
-     */
-    protected ensureInitialized(): void;
-}
-//# sourceMappingURL=abstract-manager.d.ts.map

package/dist/abstracts/abstract-manager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"abstract-manager.d.ts","sourceRoot":"","sources":["../../src/abstracts/abstract-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,8BAAsB,eAAe;IACjC,SAAS,CAAC,WAAW,UAAS;IAE9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAE7C;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,SAAS,CAAC,iBAAiB,IAAI,IAAI;CAKtC"}

package/dist/abstracts/abstract-manager.js

@@ -1,49 +0,0 @@
-/**
- * @fileoverview Abstract Manager Base Class
- *
- * 🎯 ABSTRACT CLASS - DO NOT IMPORT CONCRETE IMPLEMENTATIONS
- *
- * This class defines the common lifecycle contract for all manager implementations.
- * It enforces explicit initialization/disposal semantics so that subclasses can
- * provide their own resource management logic while sharing guard rails.
- *
- * Architectural rules:
- * - Depends only on abstractions (no concrete manager implementations)
- * - Provides finalize hooks (`doInitialize`, `doDispose`) for subclasses
- * - Guards public APIs via `ensureInitialized`
- */
-export class AbstractManager {
-    initialized = false;
-    /**
-     * Initialize the manager (idempotent)
-     */
-    async initialize() {
-        if (this.initialized) {
-            return;
-        }
-        await this.doInitialize();
-        this.initialized = true;
-    }
-    /**
-     * Dispose manager resources (idempotent)
-     */
-    async dispose() {
-        await this.doDispose();
-        this.initialized = false;
-    }
-    /**
-     * Whether the manager completed initialization
-     */
-    isInitialized() {
-        return this.initialized;
-    }
-    /**
-     * Ensure manager is initialized before performing operations
-     */
-    ensureInitialized() {
-        if (!this.initialized) {
-            throw new Error(`${this.constructor.name} is not initialized`);
-        }
-    }
-}
-//# sourceMappingURL=abstract-manager.js.map

package/dist/abstracts/abstract-manager.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"abstract-manager.js","sourceRoot":"","sources":["../../src/abstracts/abstract-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAgB,eAAe;IACvB,WAAW,GAAG,KAAK,CAAC;IAE9B;;OAEG;IACH,KAAK,CAAC,UAAU;QACZ,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,OAAO;QACX,CAAC;QACD,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC5B,CAAC;IAOD;;OAEG;IACH,KAAK,CAAC,OAAO;QACT,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC7B,CAAC;IAOD;;OAEG;IACH,aAAa;QACT,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED;;OAEG;IACO,iBAAiB;QACvB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,qBAAqB,CAAC,CAAC;QACnE,CAAC;IACL,CAAC;CACJ"}