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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/execution/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,YAAY,EACR,0BAA0B,EAC1B,eAAe,EACf,yBAAyB,EACzB,8BAA8B,EAC9B,8BAA8B,EACjC,MAAM,SAAS,CAAC"}

package/dist/plugins/execution/index.js

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

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

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

package/dist/plugins/execution/types.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Analytics context data for execution tracking
+ */
+export interface IExecutionAnalyticsContextData {
+    executionId?: string;
+    sessionId?: string;
+    userId?: string;
+    operation?: string;
+    toolName?: string;
+    parameterCount?: number;
+    inputLength?: number;
+    responseLength?: number;
+    hasOptions?: boolean;
+    hasError?: boolean;
+    resultType?: string;
+    errorSource?: string;
+    contextType?: string;
+    hasContext?: boolean;
+    modelName?: string;
+}
+/**
+ * Execution statistics entry
+ */
+export interface IExecutionStats {
+    executionId: string;
+    operation: string;
+    startTime: Date;
+    endTime: Date;
+    duration: number;
+    success: boolean;
+    error?: {
+        message: string;
+        stack?: string;
+        type: string;
+    };
+    metadata?: Record<string, string | number | boolean | Date | string[]>;
+}
+/**
+ * Aggregated execution statistics
+ */
+export interface IAggregatedExecutionStats {
+    totalExecutions: number;
+    successfulExecutions: number;
+    failedExecutions: number;
+    successRate: number;
+    averageDuration: number;
+    totalDuration: number;
+    operationStats: Record<string, {
+        count: number;
+        successCount: number;
+        failureCount: number;
+        averageDuration: number;
+        totalDuration: number;
+    }>;
+    errorStats: Record<string, number>;
+    timeRange: {
+        start: Date;
+        end: Date;
+    };
+}
+import type { IPluginOptions, IPluginStats } from '../../abstracts/abstract-plugin';
+/**
+ * Plugin options
+ */
+export interface IExecutionAnalyticsOptions extends IPluginOptions {
+    /** Maximum number of entries to keep in memory */
+    maxEntries?: number;
+    /** Whether to track error details */
+    trackErrors?: boolean;
+    /** Performance threshold in milliseconds for warnings */
+    performanceThreshold?: number;
+    /** Enable performance warnings */
+    enableWarnings?: boolean;
+}
+/**
+ * Execution analytics plugin statistics
+ */
+export interface IExecutionAnalyticsPluginStats extends IPluginStats {
+    /** Total number of executions recorded */
+    totalRecorded: number;
+    /** Number of active executions */
+    activeExecutions: number;
+    /** Memory usage in KB */
+    memoryUsage: number;
+    /** Oldest record timestamp */
+    oldestRecord?: Date;
+    /** Newest record timestamp */
+    newestRecord?: Date;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/execution/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/plugins/execution/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,EAAE,CAAC,CAAC;CAC1E;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;QAC3B,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;KACzB,CAAC,CAAC;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,SAAS,EAAE;QACP,KAAK,EAAE,IAAI,CAAC;QACZ,GAAG,EAAE,IAAI,CAAC;KACb,CAAC;CACL;AAED,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpF;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,cAAc;IAC9D,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yDAAyD;IACzD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kCAAkC;IAClC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,8BAA+B,SAAQ,YAAY;IAChE,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,8BAA8B;IAC9B,YAAY,CAAC,EAAE,IAAI,CAAC;CACvB"}

package/dist/plugins/execution/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugins/execution/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/plugins/execution/types.ts"],"names":[],"mappings":""}

package/dist/plugins/index.d.ts

@@ -0,0 +1,10 @@
+export * from './conversation-history';
+export * from './error-handling';
+export * from './execution';
+export { LimitsPlugin } from './limits-plugin';
+export * from './logging';
+export * from './performance';
+export * from './usage';
+export { EventEmitterPlugin } from './event-emitter-plugin';
+export * from './webhook';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AACA,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,cAAc,WAAW,CAAC"}

package/dist/plugins/index.js

@@ -0,0 +1,11 @@
+// Plugin exports
+export * from './conversation-history';
+export * from './error-handling';
+export * from './execution';
+export { LimitsPlugin } from './limits-plugin';
+export * from './logging';
+export * from './performance';
+export * from './usage';
+export { EventEmitterPlugin } from './event-emitter-plugin';
+export * from './webhook';
+//# sourceMappingURL=index.js.map

package/dist/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,cAAc,WAAW,CAAC"}

package/dist/plugins/limits/types.d.ts

@@ -0,0 +1,61 @@
+import type { IPluginOptions } from '../../abstracts/abstract-plugin';
+/**
+ * Rate limiting strategies
+ */
+export type TLimitsStrategy = 'token-bucket' | 'sliding-window' | 'fixed-window' | 'none';
+/**
+ * Limits plugin configuration
+ */
+export interface ILimitsPluginOptions extends IPluginOptions {
+    /** Rate limiting strategy */
+    strategy: TLimitsStrategy;
+    /** Maximum tokens per time window */
+    maxTokens?: number;
+    /** Maximum requests per time window */
+    maxRequests?: number;
+    /** Time window in milliseconds */
+    timeWindow?: number;
+    /** Maximum cost per time window (in USD) */
+    maxCost?: number;
+    /** Token cost per 1000 tokens (in USD) */
+    tokenCostPer1000?: number;
+    /** Bucket refill rate for token bucket strategy */
+    refillRate?: number;
+    /** Initial bucket size for token bucket strategy */
+    bucketSize?: number;
+    /** Custom cost calculator */
+    costCalculator?: (tokens: number, model: string) => number;
+}
+/**
+ * Plugin limits status data type - supports nested objects and null values for comprehensive status reporting
+ *
+ * REASON: Status data needs to include nested objects for bucket/window details and null values for missing data
+ * ALTERNATIVES_CONSIDERED:
+ * 1. Strict primitive types (loses nested status information)
+ * 2. Union types without null (breaks null handling)
+ * 3. Interface definitions (too rigid for dynamic status)
+ * 4. Generic constraints (too complex for status data)
+ * 5. Type assertions (decreases type safety)
+ * TODO: Consider specific status interfaces if patterns emerge
+ */
+export type TPluginLimitsStatusData = Record<string, string | number | boolean | Array<string | number | boolean> | Record<string, string | number | boolean> | null>;
+/**
+ * Rate limiting window data
+ */
+export interface ILimitWindow {
+    count: number;
+    tokens: number;
+    cost: number;
+    windowStart: number;
+}
+/**
+ * Token bucket state
+ */
+export interface ITokenBucket {
+    tokens: number;
+    lastRefill: number;
+    requests: number;
+    cost: number;
+    windowStart: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/limits/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/plugins/limits/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,gBAAgB,GAAG,cAAc,GAAG,MAAM,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IACxD,6BAA6B;IAC7B,QAAQ,EAAE,eAAe,CAAC;IAC1B,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CAC9D;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AAEtK;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACvB"}

package/dist/plugins/limits/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugins/limits/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/plugins/limits/types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,113 @@
+import { AbstractPlugin, type IPluginExecutionContext, type IPluginExecutionResult } from '../abstracts/abstract-plugin';
+import type { TLimitsStrategy, ILimitsPluginOptions, TPluginLimitsStatusData } from './limits/types';
+export type { TLimitsStrategy, ILimitsPluginOptions, TPluginLimitsStatusData };
+/**
+ * Reusable type definitions for limits plugin
+ */
+/**
+ * Plugin execution context type
+ * Used for processing execution context in limits plugin
+ * Extends IPluginExecutionContext for compatibility
+ */
+export interface ILimitsPluginExecutionContext extends IPluginExecutionContext {
+    config?: {
+        model?: string;
+        maxTokens?: number;
+        temperature?: number;
+    };
+    conversationId?: string;
+}
+/**
+ * Plugin execution result type
+ * Used for processing execution results in limits plugin
+ */
+export type TLimitsPluginExecutionResult = {
+    tokensUsed?: number;
+    cost?: number;
+    success?: boolean;
+    [key: string]: string | number | boolean | undefined;
+};
+/**
+ * Plugin for rate limiting and resource control
+ * Enforces limits on token usage, request frequency, and costs
+ */
+export declare class LimitsPlugin extends AbstractPlugin<ILimitsPluginOptions> {
+    name: string;
+    version: string;
+    private pluginOptions;
+    private logger;
+    private windows;
+    private buckets;
+    private requestCounts;
+    constructor(options: ILimitsPluginOptions);
+    /**
+     * Check limits before execution
+     */
+    beforeExecution(context: IPluginExecutionContext): Promise<void>;
+    /**
+     * Update limits after execution
+     */
+    afterExecution(context: IPluginExecutionContext, result: IPluginExecutionResult): Promise<void>;
+    /**
+     * Token bucket rate limiting
+     */
+    private checkTokenBucket;
+    /**
+     * Sliding window rate limiting
+     */
+    private checkSlidingWindow;
+    /**
+     * Fixed window rate limiting
+     */
+    private checkFixedWindow;
+    /**
+     * Update token bucket after execution
+     */
+    private updateTokenBucket;
+    /**
+     * Update window after execution
+     */
+    private updateWindow;
+    /**
+     * Get or create token bucket for key
+     */
+    private getBucket;
+    /**
+     * Get or create window for key
+     */
+    private getWindow;
+    /**
+     * Generate key for rate limiting (user/session based)
+     */
+    private getKey;
+    /**
+     * Estimate tokens needed for request
+     */
+    private estimateTokens;
+    /**
+     * Default cost calculator
+     */
+    private defaultCostCalculator;
+    /**
+ * Validate plugin options
+ */
+    private validateOptions;
+    /**
+     * 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?: string): TPluginLimitsStatusData;
+    /**
+     * Reset limits for a key or all keys
+     */
+    resetLimits(key?: string): void;
+}
+//# sourceMappingURL=limits-plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"limits-plugin.d.ts","sourceRoot":"","sources":["../../src/plugins/limits-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,EACd,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAG9B,MAAM,8BAA8B,CAAC;AAGtC,OAAO,KAAK,EACR,eAAe,EACf,oBAAoB,EACpB,uBAAuB,EAG1B,MAAM,gBAAgB,CAAC;AAIxB,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,CAAC;AAE/E;;GAEG;AAEH;;;;GAIG;AACH,MAAM,WAAW,6BAA8B,SAAQ,uBAAuB;IAC1E,MAAM,CAAC,EAAE;QACL,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,MAAM,4BAA4B,GAAG;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CACxD,CAAC;AAEF;;;GAGG;AACH,qBAAa,YAAa,SAAQ,cAAc,CAAC,oBAAoB,CAAC;IAClE,IAAI,SAAkB;IACtB,OAAO,SAAW;IAElB,OAAO,CAAC,aAAa,CAAiC;IACtD,OAAO,CAAC,MAAM,CAAU;IACxB,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,aAAa,CAA6B;gBAEtC,OAAO,EAAE,oBAAoB;IAkCzC;;OAEG;IACY,eAAe,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmC/E;;OAEG;IACY,cAAc,CAAC,OAAO,EAAE,uBAAuB,EAAE,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoC9G;;OAEG;YACW,gBAAgB;IAiD9B;;OAEG;YACW,kBAAkB;IA4ChC;;OAEG;YACW,gBAAgB;IA0C9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,OAAO,CAAC,SAAS;IAajB;;OAEG;IACH,OAAO,CAAC,SAAS;IAYjB;;OAEG;IACH,OAAO,CAAC,MAAM;IAId;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;GAED;IACC,OAAO,CAAC,eAAe;IAsFvB;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,uBAAuB;IA8BtD;;OAEG;IACH,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;CAalC"}