/**
 * Cache System - In-memory and persistent caching for agents
 * Inspired by mastra's cache module
 */
export interface CacheConfig {
    name?: string;
    ttl?: number;
    maxSize?: number;
}
export interface CacheEntry<T = any> {
    value: T;
    createdAt: number;
    expiresAt?: number;
}
/**
 * Abstract base class for cache implementations
 */
export declare abstract class BaseCache {
    readonly name: string;
    constructor(config?: CacheConfig);
    abstract get<T = any>(key: string): Promise<T | undefined>;
    abstract set<T = any>(key: string, value: T, ttl?: number): Promise<void>;
    abstract delete(key: string): Promise<boolean>;
    abstract clear(): Promise<void>;
    abstract has(key: string): Promise<boolean>;
    abstract keys(): Promise<string[]>;
    abstract size(): Promise<number>;
    abstract listPush<T = any>(key: string, value: T): Promise<void>;
    abstract listLength(key: string): Promise<number>;
    abstract listRange<T = any>(key: string, start: number, end?: number): Promise<T[]>;
}
/**
 * In-memory cache implementation
 */
export declare class MemoryCache extends BaseCache {
    private cache;
    private lists;
    private ttl?;
    private maxSize?;
    constructor(config?: CacheConfig);
    get<T = any>(key: string): Promise<T | undefined>;
    set<T = any>(key: string, value: T, ttl?: number): Promise<void>;
    delete(key: string): Promise<boolean>;
    clear(): Promise<void>;
    has(key: string): Promise<boolean>;
    keys(): Promise<string[]>;
    size(): Promise<number>;
    listPush<T = any>(key: string, value: T): Promise<void>;
    listLength(key: string): Promise<number>;
    listRange<T = any>(key: string, start: number, end?: number): Promise<T[]>;
}
/**
 * File-based cache implementation
 */
export declare class FileCache extends BaseCache {
    private cacheDir;
    private fs;
    private path;
    constructor(config?: CacheConfig & {
        cacheDir?: string;
    });
    private ensureDir;
    private getFilePath;
    get<T = any>(key: string): Promise<T | undefined>;
    set<T = any>(key: string, value: T, ttl?: number): Promise<void>;
    delete(key: string): Promise<boolean>;
    clear(): Promise<void>;
    has(key: string): Promise<boolean>;
    keys(): Promise<string[]>;
    size(): Promise<number>;
    listPush<T = any>(key: string, value: T): Promise<void>;
    listLength(key: string): Promise<number>;
    listRange<T = any>(key: string, start: number, end?: number): Promise<T[]>;
}
export declare function createMemoryCache(config?: CacheConfig): MemoryCache;
export declare function createFileCache(config?: CacheConfig & {
    cacheDir?: string;
}): FileCache;