@adcp/client 0.2.0

package/dist/lib/storage/MemoryStorage.js

@@ -0,0 +1,219 @@
+"use strict";
+// Default in-memory storage implementation
+// Works out of the box without any external dependencies
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryStorage = void 0;
+exports.createMemoryStorage = createMemoryStorage;
+exports.createMemoryStorageConfig = createMemoryStorageConfig;
+/**
+ * In-memory storage implementation with TTL support
+ *
+ * This is the default storage used when no external storage is configured.
+ * Features:
+ * - TTL support with automatic cleanup
+ * - Pattern matching
+ * - Batch operations
+ * - Memory-efficient (garbage collection of expired items)
+ *
+ * @example
+ * ```typescript
+ * const storage = new MemoryStorage<string>();
+ * await storage.set('key', 'value', 60); // TTL of 60 seconds
+ * const value = await storage.get('key');
+ * ```
+ */
+class MemoryStorage {
+    options;
+    store = new Map();
+    cleanupInterval;
+    lastCleanup = 0;
+    constructor(options = {}) {
+        this.options = options;
+        const { cleanupIntervalMs = 5 * 60 * 1000, // 5 minutes
+        autoCleanup = true } = options;
+        if (autoCleanup) {
+            this.cleanupInterval = setInterval(() => {
+                this.cleanupExpired();
+            }, cleanupIntervalMs);
+        }
+    }
+    async get(key) {
+        const item = this.store.get(key);
+        if (!item) {
+            return undefined;
+        }
+        // Check if expired
+        if (item.expiresAt && Date.now() > item.expiresAt) {
+            this.store.delete(key);
+            return undefined;
+        }
+        return item.value;
+    }
+    async set(key, value, ttl) {
+        const now = Date.now();
+        const expiresAt = ttl ? now + ttl * 1000 : undefined;
+        this.store.set(key, {
+            value,
+            expiresAt,
+            createdAt: now
+        });
+        // Force cleanup if we're approaching max items
+        const maxItems = this.options.maxItems || 10000;
+        if (this.store.size > maxItems) {
+            this.cleanupExpired();
+        }
+    }
+    async delete(key) {
+        this.store.delete(key);
+    }
+    async has(key) {
+        const value = await this.get(key);
+        return value !== undefined;
+    }
+    async clear() {
+        this.store.clear();
+    }
+    async keys() {
+        // Return only non-expired keys
+        const keys = [];
+        const now = Date.now();
+        for (const [key, item] of this.store) {
+            if (!item.expiresAt || now <= item.expiresAt) {
+                keys.push(key);
+            }
+        }
+        return keys;
+    }
+    async size() {
+        // Count only non-expired items
+        const keys = await this.keys();
+        return keys.length;
+    }
+    // ====== BATCH OPERATIONS ======
+    async mget(keys) {
+        const promises = keys.map(key => this.get(key));
+        return Promise.all(promises);
+    }
+    async mset(entries) {
+        const promises = entries.map(({ key, value, ttl }) => this.set(key, value, ttl));
+        await Promise.all(promises);
+    }
+    async mdel(keys) {
+        let deleted = 0;
+        for (const key of keys) {
+            if (this.store.has(key)) {
+                this.store.delete(key);
+                deleted++;
+            }
+        }
+        return deleted;
+    }
+    // ====== PATTERN OPERATIONS ======
+    async scan(pattern) {
+        const regex = this.patternToRegex(pattern);
+        const allKeys = await this.keys();
+        return allKeys.filter(key => regex.test(key));
+    }
+    async deletePattern(pattern) {
+        const keys = await this.scan(pattern);
+        return this.mdel(keys);
+    }
+    // ====== UTILITY METHODS ======
+    /**
+     * Manually trigger cleanup of expired items
+     */
+    cleanupExpired() {
+        const now = Date.now();
+        let cleaned = 0;
+        for (const [key, item] of this.store) {
+            if (item.expiresAt && now > item.expiresAt) {
+                this.store.delete(key);
+                cleaned++;
+            }
+        }
+        this.lastCleanup = now;
+        return cleaned;
+    }
+    /**
+     * Get storage statistics
+     */
+    getStats() {
+        const now = Date.now();
+        let expiredItems = 0;
+        let oldestItem;
+        let newestItem;
+        for (const [, item] of this.store) {
+            if (item.expiresAt && now > item.expiresAt) {
+                expiredItems++;
+            }
+            if (!oldestItem || item.createdAt < oldestItem) {
+                oldestItem = item.createdAt;
+            }
+            if (!newestItem || item.createdAt > newestItem) {
+                newestItem = item.createdAt;
+            }
+        }
+        return {
+            totalItems: this.store.size,
+            expiredItems,
+            memoryUsage: this.estimateMemoryUsage(),
+            lastCleanup: this.lastCleanup,
+            oldestItem,
+            newestItem
+        };
+    }
+    /**
+     * Estimate memory usage (rough approximation)
+     */
+    estimateMemoryUsage() {
+        let bytes = 0;
+        for (const [key, item] of this.store) {
+            // Rough estimate: string length * 2 (UTF-16) + object overhead
+            bytes += key.length * 2;
+            bytes += JSON.stringify(item.value).length * 2;
+            bytes += 64; // Overhead for object and metadata
+        }
+        return bytes;
+    }
+    /**
+     * Convert glob-style pattern to regex
+     */
+    patternToRegex(pattern) {
+        // Escape special regex characters except * and ?
+        const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, '\\$&');
+        // Convert glob wildcards to regex
+        const regexPattern = escaped
+            .replace(/\*/g, '.*') // * matches any sequence
+            .replace(/\?/g, '.'); // ? matches any single character
+        return new RegExp(`^${regexPattern}$`);
+    }
+    /**
+     * Destroy the storage and cleanup resources
+     */
+    destroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = undefined;
+        }
+        this.store.clear();
+    }
+}
+exports.MemoryStorage = MemoryStorage;
+/**
+ * Factory function to create a memory storage instance
+ */
+function createMemoryStorage(options) {
+    return new MemoryStorage(options);
+}
+/**
+ * Create a complete storage configuration using memory storage
+ */
+function createMemoryStorageConfig() {
+    return {
+        capabilities: createMemoryStorage({ maxItems: 1000 }),
+        conversations: createMemoryStorage({ maxItems: 5000 }),
+        tokens: createMemoryStorage({ maxItems: 10000 }),
+        debugLogs: createMemoryStorage({ maxItems: 50000 })
+    };
+}
+//# sourceMappingURL=MemoryStorage.js.map

package/dist/lib/storage/MemoryStorage.js.map

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

package/dist/lib/storage/interfaces.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Generic storage interface for caching and persistence
+ *
+ * Users can provide their own implementations (Redis, database, etc.)
+ * The library provides a default in-memory implementation
+ */
+export interface Storage<T> {
+    /**
+     * Get a value by key
+     * @param key - Storage key
+     * @returns Value or undefined if not found
+     */
+    get(key: string): Promise<T | undefined>;
+    /**
+     * Set a value with optional TTL
+     * @param key - Storage key
+     * @param value - Value to store
+     * @param ttl - Time to live in seconds (optional)
+     */
+    set(key: string, value: T, ttl?: number): Promise<void>;
+    /**
+     * Delete a value by key
+     * @param key - Storage key
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Check if a key exists
+     * @param key - Storage key
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Clear all stored values (optional)
+     */
+    clear?(): Promise<void>;
+    /**
+     * Get all keys (optional, for debugging)
+     */
+    keys?(): Promise<string[]>;
+    /**
+     * Get storage size/count (optional, for monitoring)
+     */
+    size?(): Promise<number>;
+}
+/**
+ * Agent capabilities for caching
+ */
+export interface AgentCapabilities {
+    /** Agent ID */
+    agentId: string;
+    /** Supported task names */
+    supportedTasks: string[];
+    /** Task schemas/definitions */
+    taskSchemas?: Record<string, any>;
+    /** Agent metadata */
+    metadata?: {
+        version?: string;
+        description?: string;
+        lastUpdated?: string;
+        [key: string]: any;
+    };
+    /** When capabilities were cached */
+    cachedAt: string;
+    /** Cache expiration time */
+    expiresAt?: string;
+}
+/**
+ * Conversation state for persistence
+ */
+export interface ConversationState {
+    /** Conversation ID */
+    conversationId: string;
+    /** Agent ID */
+    agentId: string;
+    /** Message history */
+    messages: Array<{
+        id: string;
+        role: 'user' | 'agent' | 'system';
+        content: any;
+        timestamp: string;
+        metadata?: Record<string, any>;
+    }>;
+    /** Current task information */
+    currentTask?: {
+        taskId: string;
+        taskName: string;
+        status: string;
+        params: any;
+    };
+    /** When conversation was created */
+    createdAt: string;
+    /** When conversation was last updated */
+    updatedAt: string;
+    /** Additional metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Deferred task state for resumption
+ */
+export interface DeferredTaskState {
+    /** Unique token for this deferred task */
+    token: string;
+    /** Task ID */
+    taskId: string;
+    /** Task name */
+    taskName: string;
+    /** Agent ID */
+    agentId: string;
+    /** Task parameters */
+    params: any;
+    /** Message history up to deferral point */
+    messages: Array<{
+        id: string;
+        role: 'user' | 'agent' | 'system';
+        content: any;
+        timestamp: string;
+        metadata?: Record<string, any>;
+    }>;
+    /** Pending input request that caused deferral */
+    pendingInput?: {
+        question: string;
+        field?: string;
+        expectedType?: string;
+        suggestions?: any[];
+        validation?: Record<string, any>;
+    };
+    /** When task was deferred */
+    deferredAt: string;
+    /** When token expires */
+    expiresAt: string;
+    /** Additional metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Storage configuration for different data types
+ */
+export interface StorageConfig {
+    /** Storage for agent capabilities caching */
+    capabilities?: Storage<AgentCapabilities>;
+    /** Storage for conversation state persistence */
+    conversations?: Storage<ConversationState>;
+    /** Storage for deferred task tokens */
+    tokens?: Storage<DeferredTaskState>;
+    /** Storage for debug logs (optional) */
+    debugLogs?: Storage<any>;
+    /** Custom storage instances */
+    custom?: Record<string, Storage<any>>;
+}
+/**
+ * Storage factory interface for creating storage instances
+ */
+export interface StorageFactory {
+    /**
+     * Create a storage instance for a specific data type
+     */
+    createStorage<T>(type: string, options?: any): Storage<T>;
+}
+/**
+ * Utility type for storage middleware/decorators
+ */
+export type StorageMiddleware<T> = (storage: Storage<T>) => Storage<T>;
+/**
+ * Helper interface for batch operations
+ */
+export interface BatchStorage<T> extends Storage<T> {
+    /**
+     * Get multiple values at once
+     */
+    mget(keys: string[]): Promise<(T | undefined)[]>;
+    /**
+     * Set multiple values at once
+     */
+    mset(entries: Array<{
+        key: string;
+        value: T;
+        ttl?: number;
+    }>): Promise<void>;
+    /**
+     * Delete multiple keys at once
+     */
+    mdel(keys: string[]): Promise<number>;
+}
+/**
+ * Helper interface for pattern-based operations
+ */
+export interface PatternStorage<T> extends Storage<T> {
+    /**
+     * Get keys matching a pattern
+     */
+    scan(pattern: string): Promise<string[]>;
+    /**
+     * Delete keys matching a pattern
+     */
+    deletePattern(pattern: string): Promise<number>;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/lib/storage/interfaces.d.ts.map

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

package/dist/lib/storage/interfaces.js

@@ -0,0 +1,5 @@
+"use strict";
+// Optional storage interfaces for caching and persistence
+// These are completely optional - everything works in-memory by default
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=interfaces.js.map

package/dist/lib/storage/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../src/lib/storage/interfaces.ts"],"names":[],"mappings":";AAAA,0DAA0D;AAC1D,wEAAwE"}