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

package/dist/plugins/limits-plugin.js

@@ -0,0 +1,380 @@
+import { AbstractPlugin, PluginCategory, PluginPriority } from '../abstracts/abstract-plugin';
+import { createLogger } from '../utils/logger';
+import { PluginError } from '../utils/errors';
+/**
+ * Plugin for rate limiting and resource control
+ * Enforces limits on token usage, request frequency, and costs
+ */
+export class LimitsPlugin extends AbstractPlugin {
+    name = 'LimitsPlugin';
+    version = '1.0.0';
+    pluginOptions;
+    logger;
+    windows = new Map();
+    buckets = new Map();
+    requestCounts = new Map();
+    constructor(options) {
+        super();
+        this.logger = createLogger('LimitsPlugin');
+        // Validate options
+        this.validateOptions(options);
+        // Set defaults
+        this.pluginOptions = {
+            enabled: options.enabled ?? true,
+            strategy: options.strategy,
+            maxTokens: options.maxTokens ?? 100000,
+            maxRequests: options.maxRequests ?? 1000,
+            timeWindow: options.timeWindow ?? 3600000, // 1 hour
+            maxCost: options.maxCost ?? 10.0, // $10
+            tokenCostPer1000: options.tokenCostPer1000 ?? 0.002, // $0.002 per 1K tokens
+            refillRate: options.refillRate ?? 100, // tokens per second
+            bucketSize: options.bucketSize ?? 10000,
+            costCalculator: options.costCalculator ?? this.defaultCostCalculator.bind(this),
+            // Add plugin options defaults
+            category: options.category ?? PluginCategory.LIMITS,
+            priority: options.priority ?? PluginPriority.NORMAL,
+            moduleEvents: options.moduleEvents ?? [],
+            subscribeToAllModuleEvents: options.subscribeToAllModuleEvents ?? false
+        };
+        this.logger.info('LimitsPlugin initialized', {
+            strategy: this.pluginOptions.strategy,
+            maxTokens: this.pluginOptions.maxTokens,
+            maxRequests: this.pluginOptions.maxRequests,
+            timeWindow: this.pluginOptions.timeWindow
+        });
+    }
+    /**
+     * Check limits before execution
+     */
+    async beforeExecution(context) {
+        if (this.pluginOptions.strategy === 'none') {
+            return;
+        }
+        const key = this.getKey(context);
+        try {
+            switch (this.pluginOptions.strategy) {
+                case 'token-bucket':
+                    await this.checkTokenBucket(key, context);
+                    break;
+                case 'sliding-window':
+                    await this.checkSlidingWindow(key, context);
+                    break;
+                case 'fixed-window':
+                    await this.checkFixedWindow(key, context);
+                    break;
+            }
+            this.logger.debug('Limits check passed', {
+                strategy: this.pluginOptions.strategy,
+                key
+            });
+        }
+        catch (error) {
+            this.logger.warn('Limits check failed', {
+                strategy: this.pluginOptions.strategy,
+                key,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            throw error;
+        }
+    }
+    /**
+     * Update limits after execution
+     */
+    async afterExecution(context, result) {
+        if (this.pluginOptions.strategy === 'none') {
+            return;
+        }
+        const key = this.getKey(context);
+        const tokensUsed = result?.tokensUsed || 0;
+        const cost = this.pluginOptions.costCalculator(tokensUsed, context.config?.['model'] || 'unknown');
+        try {
+            switch (this.pluginOptions.strategy) {
+                case 'token-bucket':
+                    this.updateTokenBucket(key, tokensUsed, cost);
+                    break;
+                case 'sliding-window':
+                case 'fixed-window':
+                    this.updateWindow(key, tokensUsed, cost);
+                    break;
+            }
+            this.logger.debug('Limits updated after execution', {
+                strategy: this.pluginOptions.strategy,
+                key,
+                tokensUsed,
+                cost
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to update limits', {
+                strategy: this.pluginOptions.strategy,
+                key,
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+    /**
+     * Token bucket rate limiting
+     */
+    async checkTokenBucket(key, context) {
+        const bucket = this.getBucket(key);
+        const now = Date.now();
+        // Refill bucket
+        const timePassed = (now - bucket.lastRefill) / 1000;
+        const tokensToAdd = timePassed * this.pluginOptions.refillRate;
+        bucket.tokens = Math.min(this.pluginOptions.bucketSize, bucket.tokens + tokensToAdd);
+        bucket.lastRefill = now;
+        // Check if we can process this request
+        const estimatedTokens = this.estimateTokens(context);
+        if (bucket.tokens < estimatedTokens) {
+            throw new PluginError(`Token bucket depleted. Available: ${Math.floor(bucket.tokens)}, Required: ${estimatedTokens}`, this.name, { availableTokens: bucket.tokens, requiredTokens: estimatedTokens });
+        }
+        // Check time window limits for requests and cost
+        if (now - bucket.windowStart >= this.pluginOptions.timeWindow) {
+            bucket.requests = 0;
+            bucket.cost = 0;
+            bucket.windowStart = now;
+        }
+        if (bucket.requests >= this.pluginOptions.maxRequests) {
+            throw new PluginError(`Request limit exceeded. Max: ${this.pluginOptions.maxRequests}`, this.name, { currentRequests: bucket.requests, maxRequests: this.pluginOptions.maxRequests });
+        }
+        const estimatedCost = this.pluginOptions.costCalculator(estimatedTokens, context.config?.model || 'unknown');
+        if (bucket.cost + estimatedCost > this.pluginOptions.maxCost) {
+            throw new PluginError(`Cost limit exceeded. Current: $${bucket.cost.toFixed(4)}, Estimated: $${estimatedCost.toFixed(4)}, Max: $${this.pluginOptions.maxCost}`, this.name, { currentCost: bucket.cost, estimatedCost, maxCost: this.pluginOptions.maxCost });
+        }
+        // Reserve tokens
+        bucket.tokens -= estimatedTokens;
+        bucket.requests++;
+    }
+    /**
+     * Sliding window rate limiting
+     */
+    async checkSlidingWindow(key, context) {
+        const now = Date.now();
+        const window = this.getWindow(key);
+        // For sliding window, we track usage more granularly
+        // This is a simplified implementation
+        if (now - window.windowStart < this.pluginOptions.timeWindow) {
+            const estimatedTokens = this.estimateTokens(context);
+            const estimatedCost = this.pluginOptions.costCalculator(estimatedTokens, context.config?.model || 'unknown');
+            if (window.tokens + estimatedTokens > this.pluginOptions.maxTokens) {
+                throw new PluginError(`Token limit exceeded in sliding window. Current: ${window.tokens}, Estimated: ${estimatedTokens}, Max: ${this.pluginOptions.maxTokens}`, this.name, { currentTokens: window.tokens, estimatedTokens, maxTokens: this.pluginOptions.maxTokens });
+            }
+            if (window.count >= this.pluginOptions.maxRequests) {
+                throw new PluginError(`Request limit exceeded in sliding window. Current: ${window.count}, Max: ${this.pluginOptions.maxRequests}`, this.name, { currentRequests: window.count, maxRequests: this.pluginOptions.maxRequests });
+            }
+            if (window.cost + estimatedCost > this.pluginOptions.maxCost) {
+                throw new PluginError(`Cost limit exceeded in sliding window. Current: $${window.cost.toFixed(4)}, Estimated: $${estimatedCost.toFixed(4)}, Max: $${this.pluginOptions.maxCost}`, this.name, { currentCost: window.cost, estimatedCost, maxCost: this.pluginOptions.maxCost });
+            }
+        }
+        else {
+            // Reset window
+            window.count = 0;
+            window.tokens = 0;
+            window.cost = 0;
+            window.windowStart = now;
+        }
+        window.count++;
+    }
+    /**
+     * Fixed window rate limiting
+     */
+    async checkFixedWindow(key, context) {
+        const now = Date.now();
+        const window = this.getWindow(key);
+        // Reset window if expired
+        if (now - window.windowStart >= this.pluginOptions.timeWindow) {
+            window.count = 0;
+            window.tokens = 0;
+            window.cost = 0;
+            window.windowStart = now;
+        }
+        const estimatedTokens = this.estimateTokens(context);
+        const estimatedCost = this.pluginOptions.costCalculator(estimatedTokens, context.config?.model || 'unknown');
+        if (window.tokens + estimatedTokens > this.pluginOptions.maxTokens) {
+            throw new PluginError(`Token limit exceeded in fixed window. Current: ${window.tokens}, Estimated: ${estimatedTokens}, Max: ${this.pluginOptions.maxTokens}`, this.name, { currentTokens: window.tokens, estimatedTokens, maxTokens: this.pluginOptions.maxTokens });
+        }
+        if (window.count >= this.pluginOptions.maxRequests) {
+            throw new PluginError(`Request limit exceeded in fixed window. Current: ${window.count}, Max: ${this.pluginOptions.maxRequests}`, this.name, { currentRequests: window.count, maxRequests: this.pluginOptions.maxRequests });
+        }
+        if (window.cost + estimatedCost > this.pluginOptions.maxCost) {
+            throw new PluginError(`Cost limit exceeded in fixed window. Current: $${window.cost.toFixed(4)}, Estimated: $${estimatedCost.toFixed(4)}, Max: $${this.pluginOptions.maxCost}`, this.name, { currentCost: window.cost, estimatedCost, maxCost: this.pluginOptions.maxCost });
+        }
+        window.count++;
+    }
+    /**
+     * Update token bucket after execution
+     */
+    updateTokenBucket(key, _tokensUsed, cost) {
+        const bucket = this.getBucket(key);
+        bucket.cost += cost;
+    }
+    /**
+     * Update window after execution
+     */
+    updateWindow(key, tokensUsed, cost) {
+        const window = this.getWindow(key);
+        window.tokens += tokensUsed;
+        window.cost += cost;
+    }
+    /**
+     * Get or create token bucket for key
+     */
+    getBucket(key) {
+        if (!this.buckets.has(key)) {
+            this.buckets.set(key, {
+                tokens: this.pluginOptions.bucketSize,
+                lastRefill: Date.now(),
+                requests: 0,
+                cost: 0,
+                windowStart: Date.now()
+            });
+        }
+        return this.buckets.get(key);
+    }
+    /**
+     * Get or create window for key
+     */
+    getWindow(key) {
+        if (!this.windows.has(key)) {
+            this.windows.set(key, {
+                count: 0,
+                tokens: 0,
+                cost: 0,
+                windowStart: Date.now()
+            });
+        }
+        return this.windows.get(key);
+    }
+    /**
+     * Generate key for rate limiting (user/session based)
+     */
+    getKey(context) {
+        return context.userId || context.sessionId || context['executionId'] || 'default';
+    }
+    /**
+     * Estimate tokens needed for request
+     */
+    estimateTokens(context) {
+        // Simple estimation - in real implementation, this would be more sophisticated
+        const messageLength = context.messages?.reduce((total, msg) => total + (msg.content?.length || 0), 0) || 0;
+        // Rough estimation: 1 token per 4 characters
+        return Math.ceil(messageLength / 4) + 100; // Add some buffer
+    }
+    /**
+     * Default cost calculator
+     */
+    defaultCostCalculator(tokens, model) {
+        // Different models have different costs
+        const modelCosts = {
+            'gpt-4': 0.03,
+            'gpt-4-turbo': 0.01,
+            'gpt-3.5-turbo': 0.002,
+            'claude-3-opus': 0.015,
+            'claude-3-sonnet': 0.003,
+            'claude-3-haiku': 0.00025
+        };
+        const costPer1000 = modelCosts[model] || this.pluginOptions.tokenCostPer1000;
+        return (tokens / 1000) * costPer1000;
+    }
+    /**
+ * Validate plugin options
+ */
+    validateOptions(options) {
+        if (options.strategy === 'none') {
+            this.logger.info('LimitsPlugin configured with "none" strategy - no rate limiting will be applied');
+            return;
+        }
+        if (!options.strategy) {
+            throw new PluginError('Strategy must be specified for limits plugin. Use "none" to disable rate limiting, or choose from: token-bucket, sliding-window, fixed-window', this.name, { availableStrategies: ['none', 'token-bucket', 'sliding-window', 'fixed-window'] });
+        }
+        const validStrategies = ['none', 'token-bucket', 'sliding-window', 'fixed-window'];
+        if (!validStrategies.includes(options.strategy)) {
+            throw new PluginError(`Invalid strategy "${options.strategy}". Must be one of: ${validStrategies.join(', ')}`, this.name, { provided: options.strategy, validStrategies });
+        }
+        // Token bucket strategy validation
+        if (options.strategy === 'token-bucket') {
+            if (options.bucketSize !== undefined && options.bucketSize <= 0) {
+                throw new PluginError('Bucket size must be positive for token-bucket strategy', this.name, { strategy: options.strategy, bucketSize: options.bucketSize });
+            }
+            if (options.refillRate !== undefined && options.refillRate < 0) {
+                throw new PluginError('Refill rate must be non-negative for token-bucket strategy', this.name, { strategy: options.strategy, refillRate: options.refillRate });
+            }
+        }
+        // Sliding/Fixed window strategy validation
+        if (['sliding-window', 'fixed-window'].includes(options.strategy)) {
+            if (options.timeWindow !== undefined && options.timeWindow <= 0) {
+                throw new PluginError(`Time window must be positive for ${options.strategy} strategy`, this.name, { strategy: options.strategy, timeWindow: options.timeWindow });
+            }
+        }
+        // Common validations for all strategies
+        if (options.maxRequests !== undefined && options.maxRequests < 0) {
+            throw new PluginError('Max requests must be non-negative', this.name, { strategy: options.strategy, maxRequests: options.maxRequests });
+        }
+        if (options.maxTokens !== undefined && options.maxTokens < 0) {
+            throw new PluginError('Max tokens must be non-negative', this.name, { strategy: options.strategy, maxTokens: options.maxTokens });
+        }
+        if (options.maxCost !== undefined && options.maxCost < 0) {
+            throw new PluginError('Max cost must be non-negative', this.name, { strategy: options.strategy, maxCost: options.maxCost });
+        }
+        if (options.tokenCostPer1000 !== undefined && options.tokenCostPer1000 < 0) {
+            throw new PluginError('Token cost per 1000 must be non-negative', this.name, { strategy: options.strategy, tokenCostPer1000: options.tokenCostPer1000 });
+        }
+    }
+    /**
+     * Get current limits status
+     *
+     * REASON: Limits status contains mixed data types (numbers, strings, arrays, objects) for comprehensive status reporting
+     * ALTERNATIVES_CONSIDERED:
+     * 1. Strict interface definitions (too rigid for dynamic status data)
+     * 2. Union types (becomes unwieldy for status reporting)
+     * 3. Generic constraints (too complex for status methods)
+     * 4. Separate status types (breaks existing functionality)
+     * 5. Type assertions (decreases type safety)
+     * TODO: Consider specific status interface if patterns emerge
+     */
+    getLimitsStatus(key) {
+        if (key) {
+            const bucket = this.buckets.get(key);
+            const window = this.windows.get(key);
+            return {
+                strategy: this.pluginOptions.strategy,
+                key,
+                bucket: bucket ? {
+                    availableTokens: Math.floor(bucket.tokens),
+                    requests: bucket.requests,
+                    cost: bucket.cost
+                } : null,
+                window: window ? {
+                    count: window.count,
+                    tokens: window.tokens,
+                    cost: window.cost,
+                    windowStart: window.windowStart
+                } : null
+            };
+        }
+        return {
+            strategy: this.pluginOptions.strategy,
+            totalKeys: this.buckets.size + this.windows.size,
+            bucketKeys: Array.from(this.buckets.keys()),
+            windowKeys: Array.from(this.windows.keys())
+        };
+    }
+    /**
+     * Reset limits for a key or all keys
+     */
+    resetLimits(key) {
+        if (key) {
+            this.buckets.delete(key);
+            this.windows.delete(key);
+            this.requestCounts.delete(key);
+            this.logger.info('Limits reset for key', { key });
+        }
+        else {
+            this.buckets.clear();
+            this.windows.clear();
+            this.requestCounts.clear();
+            this.logger.info('All limits reset');
+        }
+    }
+}
+//# sourceMappingURL=limits-plugin.js.map

package/dist/plugins/limits-plugin.js.map

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

package/dist/plugins/logging/formatters.d.ts

@@ -0,0 +1,14 @@
+import type { ILogEntry, ILogFormatter } from './types';
+/**
+ * Default console formatter
+ */
+export declare class ConsoleLogFormatter implements ILogFormatter {
+    format(entry: ILogEntry): string;
+}
+/**
+ * JSON formatter for file/remote logging
+ */
+export declare class JsonLogFormatter implements ILogFormatter {
+    format(entry: ILogEntry): string;
+}
+//# sourceMappingURL=formatters.d.ts.map

package/dist/plugins/logging/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../../src/plugins/logging/formatters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExD;;GAEG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IACrD,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM;CAOnC;AAED;;GAEG;AACH,qBAAa,gBAAiB,YAAW,aAAa;IAClD,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM;CAMnC"}

package/dist/plugins/logging/formatters.js

@@ -0,0 +1,24 @@
+/**
+ * Default console formatter
+ */
+export class ConsoleLogFormatter {
+    format(entry) {
+        const timestamp = entry.timestamp.toISOString();
+        const level = entry.level.toUpperCase().padStart(5);
+        const contextStr = entry.context ? ` | ${JSON.stringify(entry.context)}` : '';
+        const metadataStr = entry.metadata ? ` | ${JSON.stringify(entry.metadata)}` : '';
+        return `[${timestamp}] ${level} | ${entry.message}${contextStr}${metadataStr}`;
+    }
+}
+/**
+ * JSON formatter for file/remote logging
+ */
+export class JsonLogFormatter {
+    format(entry) {
+        return JSON.stringify({
+            ...entry,
+            timestamp: entry.timestamp.toISOString()
+        });
+    }
+}
+//# sourceMappingURL=formatters.js.map

package/dist/plugins/logging/formatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../../../src/plugins/logging/formatters.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,mBAAmB;IAC5B,MAAM,CAAC,KAAgB;QACnB,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;QAChD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACpD,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,MAAM,WAAW,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,OAAO,IAAI,SAAS,KAAK,KAAK,MAAM,KAAK,CAAC,OAAO,GAAG,UAAU,GAAG,WAAW,EAAE,CAAC;IACnF,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,gBAAgB;IACzB,MAAM,CAAC,KAAgB;QACnB,OAAO,IAAI,CAAC,SAAS,CAAC;YAClB,GAAG,KAAK;YACR,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE;SAC3C,CAAC,CAAC;IACP,CAAC;CACJ"}

package/dist/plugins/logging/index.d.ts

@@ -0,0 +1,3 @@
+export { LoggingPlugin } from './logging-plugin';
+export type { ILoggingPluginOptions, TLoggingStrategy, TLogLevel, ILogEntry, ILogFormatter, ILogStorage, ILoggingPluginStats } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/logging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/logging/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EACR,qBAAqB,EACrB,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,aAAa,EACb,WAAW,EACX,mBAAmB,EACtB,MAAM,SAAS,CAAC"}

package/dist/plugins/logging/index.js

@@ -0,0 +1,2 @@
+export { LoggingPlugin } from './logging-plugin';
+//# sourceMappingURL=index.js.map

package/dist/plugins/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/logging/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/plugins/logging/logging-plugin.d.ts

@@ -0,0 +1,91 @@
+import { AbstractPlugin } from '../../abstracts/abstract-plugin';
+import type { IEventEmitterEventData, TEventName } from '../event-emitter-plugin';
+import { TLogLevel, ILogEntry, ILoggingPluginOptions, ILoggingPluginStats } from './types';
+/**
+ * Logging context data - structured data for log entries
+ */
+export interface ILoggingContextData extends Record<string, string | number | boolean | Date | undefined> {
+    userInput?: string;
+    duration?: number;
+    toolName?: string;
+    success?: boolean;
+    executionId?: string;
+    operation?: string;
+    errorMessage?: string;
+    errorStack?: string;
+    inputLength?: number;
+    responseLength?: number;
+    hasOptions?: boolean;
+    modelName?: string;
+}
+/**
+ * Plugin for logging agent operations
+ * Supports multiple logging strategies: console, file, remote, silent
+ */
+export declare class LoggingPlugin extends AbstractPlugin<ILoggingPluginOptions, ILoggingPluginStats> {
+    name: string;
+    version: string;
+    private storage;
+    private pluginOptions;
+    private logger;
+    private simpleLogger;
+    private logLevels;
+    constructor(options: ILoggingPluginOptions);
+    /**
+     * Handle module events for logging
+     */
+    onModuleEvent(eventName: TEventName, eventData: IEventEmitterEventData): Promise<void>;
+    /**
+     * Log a message
+     */
+    log(level: TLogLevel, message: string, context?: ILoggingContextData, metadata?: ILogEntry['metadata']): Promise<void>;
+    /**
+     * Log debug message
+     */
+    debug(message: string, context?: ILoggingContextData, metadata?: ILogEntry['metadata']): Promise<void>;
+    /**
+     * Log info message
+     */
+    info(message: string, context?: ILoggingContextData, metadata?: ILogEntry['metadata']): Promise<void>;
+    /**
+     * Log warning message
+     */
+    warn(message: string, context?: ILoggingContextData, metadata?: ILogEntry['metadata']): Promise<void>;
+    /**
+     * Log error message
+     */
+    error(message: string, error?: Error, context?: ILoggingContextData, metadata?: ILogEntry['metadata']): Promise<void>;
+    /**
+     * Log execution start
+     */
+    logExecutionStart(executionId: string, userInput: string, metadata?: ILogEntry['metadata']): Promise<void>;
+    /**
+     * Log execution completion
+     */
+    logExecutionComplete(executionId: string, duration: number, metadata?: ILogEntry['metadata']): Promise<void>;
+    /**
+     * Log tool execution
+     */
+    logToolExecution(toolName: string, executionId: string, duration?: number, success?: boolean, metadata?: ILogEntry['metadata']): Promise<void>;
+    /**
+     * Flush any pending logs
+     */
+    flush(): Promise<void>;
+    /**
+     * Cleanup resources
+     */
+    destroy(): Promise<void>;
+    /**
+     * Check if message should be logged based on level
+     */
+    private shouldLog;
+    /**
+     * Validate plugin options
+     */
+    private validateOptions;
+    /**
+     * Create storage instance based on strategy
+     */
+    private createStorage;
+}
+//# sourceMappingURL=logging-plugin.d.ts.map

package/dist/plugins/logging/logging-plugin.d.ts.map

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