@astrive-ai/plugins 1.0.1

package/dist/analytics-plugin.d.ts

@@ -0,0 +1,21 @@
+import { BasePlugin } from './base-plugin.js';
+import type { PluginContext } from '@astrive-ai/types';
+export interface AnalyticsMetrics {
+    requestCount: number;
+    errorCount: number;
+    totalLatencyMs: number;
+    toolUsage: Record<string, number>;
+}
+export interface ComputedAnalyticsMetrics extends AnalyticsMetrics {
+    averageLatency: number;
+    errorRate: number;
+}
+export declare class AnalyticsPlugin extends BasePlugin {
+    private metrics;
+    constructor();
+    install(context: PluginContext): Promise<void>;
+    getMetrics(): ComputedAnalyticsMetrics;
+    reset(): void;
+    private getInitialMetrics;
+}
+//# sourceMappingURL=analytics-plugin.d.ts.map

package/dist/analytics-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-plugin.d.ts","sourceRoot":"","sources":["../src/analytics-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,wBAAyB,SAAQ,gBAAgB;IAChE,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,OAAO,CAAC,OAAO,CAAmB;;IAWrB,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BpD,UAAU,IAAI,wBAAwB;IAStC,KAAK,IAAI,IAAI;IAIpB,OAAO,CAAC,iBAAiB;CAQ1B"}

package/dist/analytics-plugin.js

@@ -0,0 +1,55 @@
+import { BasePlugin } from './base-plugin.js';
+export class AnalyticsPlugin extends BasePlugin {
+    metrics;
+    constructor() {
+        super({
+            name: 'analytics',
+            version: '1.0.0',
+            description: 'Tracks analytics metrics for agent usage',
+        });
+        this.metrics = this.getInitialMetrics();
+    }
+    async install(context) {
+        if (!context.events)
+            return;
+        let requestStartTime = 0;
+        context.events.on('request:start', (data) => {
+            requestStartTime = Date.now();
+            this.metrics.requestCount++;
+        });
+        context.events.on('request:end', (data) => {
+            if (requestStartTime) {
+                this.metrics.totalLatencyMs += Date.now() - requestStartTime;
+            }
+        });
+        context.events.on('error', (error) => {
+            this.metrics.errorCount++;
+        });
+        context.events.on('tool:start', (data) => {
+            if (data && data.name) {
+                const name = data.name;
+                this.metrics.toolUsage[name] = (this.metrics.toolUsage[name] || 0) + 1;
+            }
+        });
+    }
+    getMetrics() {
+        const baseMetrics = { ...this.metrics, toolUsage: { ...this.metrics.toolUsage } };
+        return {
+            ...baseMetrics,
+            averageLatency: baseMetrics.requestCount > 0 ? baseMetrics.totalLatencyMs / baseMetrics.requestCount : 0,
+            errorRate: baseMetrics.requestCount > 0 ? baseMetrics.errorCount / baseMetrics.requestCount : 0
+        };
+    }
+    reset() {
+        this.metrics = this.getInitialMetrics();
+    }
+    getInitialMetrics() {
+        return {
+            requestCount: 0,
+            errorCount: 0,
+            totalLatencyMs: 0,
+            toolUsage: {},
+        };
+    }
+}
+//# sourceMappingURL=analytics-plugin.js.map

package/dist/analytics-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-plugin.js","sourceRoot":"","sources":["../src/analytics-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAe9C,MAAM,OAAO,eAAgB,SAAQ,UAAU;IACrC,OAAO,CAAmB;IAElC;QACE,KAAK,CAAC;YACJ,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,OAAO;YAChB,WAAW,EAAE,0CAA0C;SACxD,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC1C,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,OAAsB;QACzC,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,OAAO;QAE5B,IAAI,gBAAgB,GAAW,CAAC,CAAC;QAEjC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,IAAS,EAAE,EAAE;YAC/C,gBAAgB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC9B,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QAC9B,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,IAAS,EAAE,EAAE;YAC7C,IAAI,gBAAgB,EAAE,CAAC;gBACrB,IAAI,CAAC,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,gBAAgB,CAAC;YAC/D,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAc,EAAE,EAAE;YAC5C,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,IAAS,EAAE,EAAE;YAC5C,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACtB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAc,CAAC;gBACjC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACzE,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,UAAU;QACf,MAAM,WAAW,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;QAClF,OAAO;YACL,GAAG,WAAW;YACd,cAAc,EAAE,WAAW,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,cAAc,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACxG,SAAS,EAAE,WAAW,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,UAAU,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;SAChG,CAAC;IACJ,CAAC;IAEM,KAAK;QACV,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC1C,CAAC;IAEO,iBAAiB;QACvB,OAAO;YACL,YAAY,EAAE,CAAC;YACf,UAAU,EAAE,CAAC;YACb,cAAc,EAAE,CAAC;YACjB,SAAS,EAAE,EAAE;SACd,CAAC;IACJ,CAAC;CACF"}

package/dist/base-plugin.d.ts

@@ -0,0 +1,12 @@
+import type { IPlugin, PluginManifest, PluginContext } from '@astrive-ai/types';
+export declare abstract class BasePlugin implements IPlugin {
+    readonly name: string;
+    readonly version: string;
+    readonly description: string;
+    constructor(manifest: PluginManifest);
+    abstract install(context: PluginContext): Promise<void>;
+    uninstall(context: PluginContext): Promise<void>;
+    onInit(): Promise<void>;
+    onDestroy(): Promise<void>;
+}
+//# sourceMappingURL=base-plugin.d.ts.map

package/dist/base-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-plugin.d.ts","sourceRoot":"","sources":["../src/base-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEhF,8BAAsB,UAAW,YAAW,OAAO;IACjD,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,OAAO,EAAE,MAAM,CAAC;IAChC,SAAgB,WAAW,EAAE,MAAM,CAAC;gBAExB,QAAQ,EAAE,cAAc;aAMpB,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAEjD,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAGxC"}

package/dist/base-plugin.js

@@ -0,0 +1,20 @@
+export class BasePlugin {
+    name;
+    version;
+    description;
+    constructor(manifest) {
+        this.name = manifest.name;
+        this.version = manifest.version;
+        this.description = manifest.description;
+    }
+    async uninstall(context) {
+        // Default implementation does nothing
+    }
+    async onInit() {
+        // Default implementation does nothing
+    }
+    async onDestroy() {
+        // Default implementation does nothing
+    }
+}
+//# sourceMappingURL=base-plugin.js.map

package/dist/base-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-plugin.js","sourceRoot":"","sources":["../src/base-plugin.ts"],"names":[],"mappings":"AAEA,MAAM,OAAgB,UAAU;IACd,IAAI,CAAS;IACb,OAAO,CAAS;IAChB,WAAW,CAAS;IAEpC,YAAY,QAAwB;QAClC,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;QAChC,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC;IAC1C,CAAC;IAIM,KAAK,CAAC,SAAS,CAAC,OAAsB;QAC3C,sCAAsC;IACxC,CAAC;IAEM,KAAK,CAAC,MAAM;QACjB,sCAAsC;IACxC,CAAC;IAEM,KAAK,CAAC,SAAS;QACpB,sCAAsC;IACxC,CAAC;CACF"}

package/dist/cache-plugin.d.ts

@@ -0,0 +1,14 @@
+import { BasePlugin } from './base-plugin.js';
+import type { PluginContext } from '@astrive-ai/types';
+export interface CachePluginConfig {
+    ttlMs?: number;
+}
+export declare class CachePlugin extends BasePlugin {
+    private ttlMs;
+    private cache;
+    private pendingRequests;
+    constructor(config?: CachePluginConfig);
+    install(context: PluginContext): Promise<void>;
+    private generateKey;
+}
+//# sourceMappingURL=cache-plugin.d.ts.map

package/dist/cache-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-plugin.d.ts","sourceRoot":"","sources":["../src/cache-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,WAAY,SAAQ,UAAU;IACzC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAgE;IAC7E,OAAO,CAAC,eAAe,CAAkC;gBAE7C,MAAM,GAAE,iBAAsB;IAS7B,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B3D,OAAO,CAAC,WAAW;CAKpB"}

package/dist/cache-plugin.js

@@ -0,0 +1,45 @@
+import { BasePlugin } from './base-plugin.js';
+export class CachePlugin extends BasePlugin {
+    ttlMs;
+    cache = new Map();
+    pendingRequests = new Map();
+    constructor(config = {}) {
+        super({
+            name: 'cache',
+            version: '1.0.0',
+            description: 'In-memory caching for agent responses',
+        });
+        this.ttlMs = config.ttlMs || 300000; // default 5 minutes
+    }
+    async install(context) {
+        if (!context.events)
+            return;
+        context.events.on('request:start', async (data) => {
+            const request = data.request;
+            const cacheKey = this.generateKey(request);
+            const cached = this.cache.get(cacheKey);
+            if (cached && Date.now() < cached.expiresAt) {
+                data.cachedResponse = cached.data;
+            }
+            else if (data.requestId) {
+                this.pendingRequests.set(data.requestId, cacheKey);
+            }
+        });
+        context.events.on('request:end', async (data) => {
+            if (data.requestId && this.pendingRequests.has(data.requestId)) {
+                const cacheKey = this.pendingRequests.get(data.requestId);
+                this.cache.set(cacheKey, {
+                    data: data.response,
+                    expiresAt: Date.now() + this.ttlMs
+                });
+                this.pendingRequests.delete(data.requestId);
+            }
+        });
+    }
+    generateKey(req) {
+        const inputStr = Array.isArray(req?.messages) ? JSON.stringify(req.messages) : (req?.prompt || '');
+        // using base64 for simplest environment agnostic hashing
+        return Buffer.from(inputStr).toString('base64');
+    }
+}
+//# sourceMappingURL=cache-plugin.js.map

package/dist/cache-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-plugin.js","sourceRoot":"","sources":["../src/cache-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAO9C,MAAM,OAAO,WAAY,SAAQ,UAAU;IACjC,KAAK,CAAS;IACd,KAAK,GAAsD,IAAI,GAAG,EAAE,CAAC;IACrE,eAAe,GAAwB,IAAI,GAAG,EAAE,CAAC;IAEzD,YAAY,SAA4B,EAAE;QACxC,KAAK,CAAC;YACJ,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,OAAO;YAChB,WAAW,EAAE,uCAAuC;SACrD,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,CAAC,oBAAoB;IAC3D,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,OAAsB;QACzC,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,OAAO;QAE5B,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,eAAe,EAAE,KAAK,EAAE,IAAS,EAAE,EAAE;YACrD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAkC,CAAC;YACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAExC,IAAI,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;gBAC5C,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC;YACpC,CAAC;iBAAM,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC1B,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,SAAmB,EAAE,QAAQ,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,aAAa,EAAE,KAAK,EAAE,IAAS,EAAE,EAAE;YACnD,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,SAAmB,CAAC,EAAE,CAAC;gBACzE,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,SAAmB,CAAE,CAAC;gBACrE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE;oBACvB,IAAI,EAAE,IAAI,CAAC,QAAQ;oBACnB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK;iBACnC,CAAC,CAAC;gBACH,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,SAAmB,CAAC,CAAC;YACxD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,WAAW,CAAC,GAA4B;QAC9C,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,MAAgB,IAAI,EAAE,CAAC,CAAC;QAC7G,yDAAyD;QACzD,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './base-plugin.js';
+export * from './logging-plugin.js';
+export * from './rate-limit-plugin.js';
+export * from './cache-plugin.js';
+export * from './analytics-plugin.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from './base-plugin.js';
+export * from './logging-plugin.js';
+export * from './rate-limit-plugin.js';
+export * from './cache-plugin.js';
+export * from './analytics-plugin.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC"}

package/dist/logging-plugin.d.ts

@@ -0,0 +1,12 @@
+import { BasePlugin } from './base-plugin.js';
+import type { PluginContext } from '@astrive-ai/types';
+export interface LoggingPluginConfig {
+    level?: 'debug' | 'info' | 'warn' | 'error';
+}
+export declare class LoggingPlugin extends BasePlugin {
+    private level;
+    constructor(config?: LoggingPluginConfig);
+    install(context: PluginContext): Promise<void>;
+    private log;
+}
+//# sourceMappingURL=logging-plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logging-plugin.d.ts","sourceRoot":"","sources":["../src/logging-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAC7C;AAED,qBAAa,aAAc,SAAQ,UAAU;IAC3C,OAAO,CAAC,KAAK,CAAS;gBAEV,MAAM,GAAE,mBAAwB;IAS/B,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B3D,OAAO,CAAC,GAAG;CAKZ"}

package/dist/logging-plugin.js

@@ -0,0 +1,38 @@
+import { BasePlugin } from './base-plugin.js';
+export class LoggingPlugin extends BasePlugin {
+    level;
+    constructor(config = {}) {
+        super({
+            name: 'logging',
+            version: '1.0.0',
+            description: 'Logs agent events and interactions',
+        });
+        this.level = config.level || 'info';
+    }
+    async install(context) {
+        if (!context.events) {
+            return;
+        }
+        context.events.on('request:start', (data) => {
+            this.log('Request started', data);
+        });
+        context.events.on('request:end', (data) => {
+            this.log('Request ended', data);
+        });
+        context.events.on('tool:start', (data) => {
+            this.log('Tool execution started', data);
+        });
+        context.events.on('tool:end', (data) => {
+            this.log('Tool execution ended', data);
+        });
+        context.events.on('error', (error) => {
+            console.error(`[Plugin: logging] ERROR:`, error);
+        });
+    }
+    log(message, data) {
+        if (this.level === 'debug' || this.level === 'info') {
+            console.log(`[Plugin: logging] ${message}`, data ? data : '');
+        }
+    }
+}
+//# sourceMappingURL=logging-plugin.js.map

package/dist/logging-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging-plugin.js","sourceRoot":"","sources":["../src/logging-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAO9C,MAAM,OAAO,aAAc,SAAQ,UAAU;IACnC,KAAK,CAAS;IAEtB,YAAY,SAA8B,EAAE;QAC1C,KAAK,CAAC;YACJ,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,OAAO;YAChB,WAAW,EAAE,oCAAoC;SAClD,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC;IACtC,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,OAAsB;QACzC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,IAAS,EAAE,EAAE;YAC/C,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,IAAS,EAAE,EAAE;YAC7C,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,IAAS,EAAE,EAAE;YAC5C,IAAI,CAAC,GAAG,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,IAAS,EAAE,EAAE;YAC1C,IAAI,CAAC,GAAG,CAAC,sBAAsB,EAAE,IAAI,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAc,EAAE,EAAE;YAC5C,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,GAAG,CAAC,OAAe,EAAE,IAAc;QACzC,IAAI,IAAI,CAAC,KAAK,KAAK,OAAO,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;YACpD,OAAO,CAAC,GAAG,CAAC,qBAAqB,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;CACF"}

package/dist/rate-limit-plugin.d.ts

@@ -0,0 +1,14 @@
+import { BasePlugin } from './base-plugin.js';
+import type { PluginContext } from '@astrive-ai/types';
+export interface RateLimitPluginConfig {
+    maxRequests?: number;
+    windowMs?: number;
+}
+export declare class RateLimitPlugin extends BasePlugin {
+    private maxRequests;
+    private windowMs;
+    private requestCounts;
+    constructor(config?: RateLimitPluginConfig);
+    install(context: PluginContext): Promise<void>;
+}
+//# sourceMappingURL=rate-limit-plugin.d.ts.map

package/dist/rate-limit-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit-plugin.d.ts","sourceRoot":"","sources":["../src/rate-limit-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,aAAa,CAAgE;gBAEzE,MAAM,GAAE,qBAA0B;IAUjC,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAsB5D"}

package/dist/rate-limit-plugin.js

@@ -0,0 +1,35 @@
+import { BasePlugin } from './base-plugin.js';
+export class RateLimitPlugin extends BasePlugin {
+    maxRequests;
+    windowMs;
+    requestCounts = new Map();
+    constructor(config = {}) {
+        super({
+            name: 'rate-limit',
+            version: '1.0.0',
+            description: 'Provides rate limiting for agent requests',
+        });
+        this.maxRequests = config.maxRequests || 10;
+        this.windowMs = config.windowMs || 60000;
+    }
+    async install(context) {
+        if (!context.events)
+            return;
+        context.events.on('request:start', async (data) => {
+            const request = (data.request || {});
+            const key = request.userId || 'default';
+            const now = Date.now();
+            const record = this.requestCounts.get(key) || { count: 0, resetTime: now + this.windowMs };
+            if (now > record.resetTime) {
+                record.count = 0;
+                record.resetTime = now + this.windowMs;
+            }
+            if (record.count >= this.maxRequests) {
+                throw new Error(`Rate limit exceeded for user ${key}. Max ${this.maxRequests} requests per ${this.windowMs}ms.`);
+            }
+            record.count++;
+            this.requestCounts.set(key, record);
+        });
+    }
+}
+//# sourceMappingURL=rate-limit-plugin.js.map

package/dist/rate-limit-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit-plugin.js","sourceRoot":"","sources":["../src/rate-limit-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAQ9C,MAAM,OAAO,eAAgB,SAAQ,UAAU;IACrC,WAAW,CAAS;IACpB,QAAQ,CAAS;IACjB,aAAa,GAAsD,IAAI,GAAG,EAAE,CAAC;IAErF,YAAY,SAAgC,EAAE;QAC5C,KAAK,CAAC;YACJ,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,OAAO;YAChB,WAAW,EAAE,2CAA2C;SACzD,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,KAAK,CAAC;IAC3C,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,OAAsB;QACzC,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,OAAO;QAE5B,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,eAAe,EAAE,KAAK,EAAE,IAAS,EAAE,EAAE;YACrD,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAA4B,CAAC;YAChE,MAAM,GAAG,GAAI,OAAO,CAAC,MAAiB,IAAI,SAAS,CAAC;YACpD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAE3F,IAAI,GAAG,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;gBAC3B,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;gBACjB,MAAM,CAAC,SAAS,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;YACzC,CAAC;YAED,IAAI,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACrC,MAAM,IAAI,KAAK,CAAC,gCAAgC,GAAG,SAAS,IAAI,CAAC,WAAW,iBAAiB,IAAI,CAAC,QAAQ,KAAK,CAAC,CAAC;YACnH,CAAC;YAED,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@astrive-ai/plugins",
+  "version": "1.0.1",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@astrive-ai/types": "*"
+  },
+  "devDependencies": {
+    "typescript": "5.4.5"
+  }
+}

package/src/analytics-plugin.ts

@@ -0,0 +1,77 @@
+import { BasePlugin } from './base-plugin.js';
+import type { PluginContext } from '@astrive-ai/types';
+
+export interface AnalyticsMetrics {
+  requestCount: number;
+  errorCount: number;
+  totalLatencyMs: number;
+  toolUsage: Record<string, number>;
+}
+
+export interface ComputedAnalyticsMetrics extends AnalyticsMetrics {
+  averageLatency: number;
+  errorRate: number;
+}
+
+export class AnalyticsPlugin extends BasePlugin {
+  private metrics: AnalyticsMetrics;
+
+  constructor() {
+    super({
+      name: 'analytics',
+      version: '1.0.0',
+      description: 'Tracks analytics metrics for agent usage',
+    });
+    this.metrics = this.getInitialMetrics();
+  }
+
+  public async install(context: PluginContext): Promise<void> {
+    if (!context.events) return;
+
+    let requestStartTime: number = 0;
+
+    context.events.on('request:start', (data: any) => {
+      requestStartTime = Date.now();
+      this.metrics.requestCount++;
+    });
+
+    context.events.on('request:end', (data: any) => {
+      if (requestStartTime) {
+        this.metrics.totalLatencyMs += Date.now() - requestStartTime;
+      }
+    });
+
+    context.events.on('error', (error: unknown) => {
+      this.metrics.errorCount++;
+    });
+
+    context.events.on('tool:start', (data: any) => {
+      if (data && data.name) {
+        const name = data.name as string;
+        this.metrics.toolUsage[name] = (this.metrics.toolUsage[name] || 0) + 1;
+      }
+    });
+  }
+
+  public getMetrics(): ComputedAnalyticsMetrics {
+    const baseMetrics = { ...this.metrics, toolUsage: { ...this.metrics.toolUsage } };
+    return {
+      ...baseMetrics,
+      averageLatency: baseMetrics.requestCount > 0 ? baseMetrics.totalLatencyMs / baseMetrics.requestCount : 0,
+      errorRate: baseMetrics.requestCount > 0 ? baseMetrics.errorCount / baseMetrics.requestCount : 0
+    };
+  }
+
+  public reset(): void {
+    this.metrics = this.getInitialMetrics();
+  }
+
+  private getInitialMetrics(): AnalyticsMetrics {
+    return {
+      requestCount: 0,
+      errorCount: 0,
+      totalLatencyMs: 0,
+      toolUsage: {},
+    };
+  }
+}

package/src/base-plugin.ts

@@ -0,0 +1,27 @@
+import type { IPlugin, PluginManifest, PluginContext } from '@astrive-ai/types';
+
+export abstract class BasePlugin implements IPlugin {
+  public readonly name: string;
+  public readonly version: string;
+  public readonly description: string;
+
+  constructor(manifest: PluginManifest) {
+    this.name = manifest.name;
+    this.version = manifest.version;
+    this.description = manifest.description;
+  }
+
+  public abstract install(context: PluginContext): Promise<void>;
+
+  public async uninstall(context: PluginContext): Promise<void> {
+    // Default implementation does nothing
+  }
+
+  public async onInit(): Promise<void> {
+    // Default implementation does nothing
+  }
+
+  public async onDestroy(): Promise<void> {
+    // Default implementation does nothing
+  }
+}

package/src/cache-plugin.ts

@@ -0,0 +1,54 @@
+import { BasePlugin } from './base-plugin.js';
+import type { PluginContext } from '@astrive-ai/types';
+
+export interface CachePluginConfig {
+  ttlMs?: number;
+}
+
+export class CachePlugin extends BasePlugin {
+  private ttlMs: number;
+  private cache: Map<string, { data: unknown; expiresAt: number }> = new Map();
+  private pendingRequests: Map<string, string> = new Map();
+
+  constructor(config: CachePluginConfig = {}) {
+    super({
+      name: 'cache',
+      version: '1.0.0',
+      description: 'In-memory caching for agent responses',
+    });
+    this.ttlMs = config.ttlMs || 300000; // default 5 minutes
+  }
+
+  public async install(context: PluginContext): Promise<void> {
+    if (!context.events) return;
+
+    context.events.on('request:start', async (data: any) => {
+      const request = data.request as Record<string, unknown>;
+      const cacheKey = this.generateKey(request);
+      const cached = this.cache.get(cacheKey);
+      
+      if (cached && Date.now() < cached.expiresAt) {
+        data.cachedResponse = cached.data;
+      } else if (data.requestId) {
+        this.pendingRequests.set(data.requestId as string, cacheKey);
+      }
+    });
+
+    context.events.on('request:end', async (data: any) => {
+      if (data.requestId && this.pendingRequests.has(data.requestId as string)) {
+        const cacheKey = this.pendingRequests.get(data.requestId as string)!;
+        this.cache.set(cacheKey, {
+          data: data.response,
+          expiresAt: Date.now() + this.ttlMs
+        });
+        this.pendingRequests.delete(data.requestId as string);
+      }
+    });
+  }
+
+  private generateKey(req: Record<string, unknown>): string {
+    const inputStr = Array.isArray(req?.messages) ? JSON.stringify(req.messages) : (req?.prompt as string || '');
+    // using base64 for simplest environment agnostic hashing
+    return Buffer.from(inputStr).toString('base64');
+  }
+}

package/src/index.ts

@@ -0,0 +1,5 @@
+export * from './base-plugin.js';
+export * from './logging-plugin.js';
+export * from './rate-limit-plugin.js';
+export * from './cache-plugin.js';
+export * from './analytics-plugin.js';

package/src/logging-plugin.ts

@@ -0,0 +1,51 @@
+import { BasePlugin } from './base-plugin.js';
+import type { PluginContext } from '@astrive-ai/types';
+
+export interface LoggingPluginConfig {
+  level?: 'debug' | 'info' | 'warn' | 'error';
+}
+
+export class LoggingPlugin extends BasePlugin {
+  private level: string;
+
+  constructor(config: LoggingPluginConfig = {}) {
+    super({
+      name: 'logging',
+      version: '1.0.0',
+      description: 'Logs agent events and interactions',
+    });
+    this.level = config.level || 'info';
+  }
+
+  public async install(context: PluginContext): Promise<void> {
+    if (!context.events) {
+      return;
+    }
+
+    context.events.on('request:start', (data: any) => {
+      this.log('Request started', data);
+    });
+
+    context.events.on('request:end', (data: any) => {
+      this.log('Request ended', data);
+    });
+
+    context.events.on('tool:start', (data: any) => {
+      this.log('Tool execution started', data);
+    });
+
+    context.events.on('tool:end', (data: any) => {
+      this.log('Tool execution ended', data);
+    });
+    
+    context.events.on('error', (error: unknown) => {
+      console.error(`[Plugin: logging] ERROR:`, error);
+    });
+  }
+
+  private log(message: string, data?: unknown): void {
+    if (this.level === 'debug' || this.level === 'info') {
+      console.log(`[Plugin: logging] ${message}`, data ? data : '');
+    }
+  }
+}

package/src/rate-limit-plugin.ts

@@ -0,0 +1,46 @@
+import { BasePlugin } from './base-plugin.js';
+import type { PluginContext } from '@astrive-ai/types';
+
+export interface RateLimitPluginConfig {
+  maxRequests?: number;
+  windowMs?: number;
+}
+
+export class RateLimitPlugin extends BasePlugin {
+  private maxRequests: number;
+  private windowMs: number;
+  private requestCounts: Map<string, { count: number; resetTime: number }> = new Map();
+
+  constructor(config: RateLimitPluginConfig = {}) {
+    super({
+      name: 'rate-limit',
+      version: '1.0.0',
+      description: 'Provides rate limiting for agent requests',
+    });
+    this.maxRequests = config.maxRequests || 10;
+    this.windowMs = config.windowMs || 60000;
+  }
+
+  public async install(context: PluginContext): Promise<void> {
+    if (!context.events) return;
+
+    context.events.on('request:start', async (data: any) => {
+      const request = (data.request || {}) as Record<string, unknown>;
+      const key = (request.userId as string) || 'default';
+      const now = Date.now();
+      const record = this.requestCounts.get(key) || { count: 0, resetTime: now + this.windowMs };
+      
+      if (now > record.resetTime) {
+        record.count = 0;
+        record.resetTime = now + this.windowMs;
+      }
+
+      if (record.count >= this.maxRequests) {
+        throw new Error(`Rate limit exceeded for user ${key}. Max ${this.maxRequests} requests per ${this.windowMs}ms.`);
+      }
+
+      record.count++;
+      this.requestCounts.set(key, record);
+    });
+  }
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"]
+}