import { MastraServerCache } from '@mastra/core/cache';
export interface RedisClient {
    get(key: string): Promise<unknown>;
    set(key: string, value: unknown, ...args: unknown[]): Promise<unknown>;
    llen(key: string): Promise<number>;
    rpush(key: string, ...values: unknown[]): Promise<number>;
    lrange(key: string, start: number, stop: number): Promise<unknown[]>;
    del(...keys: string[]): Promise<number>;
    expire(key: string, seconds: number): Promise<number | boolean>;
    scan(cursor: string | number, ...args: unknown[]): Promise<[string | number, string[]]>;
    incr(key: string): Promise<number>;
    /**
     * Server-side Lua scripting. Optional: clients without it fall back to the
     * two-round-trip `increment` + `listPush` path for `listPushIndexed`.
     */
    eval?(...args: unknown[]): Promise<unknown>;
}
export interface RedisServerCacheOptions {
    keyPrefix?: string;
    ttlSeconds?: number;
    /**
     * Run a Lua script with the given KEYS and ARGV. Defaults to the ioredis
     * calling convention (`eval(script, numKeys, ...keys, ...args)`); use
     * `nodeRedisPreset` / `upstashPreset` for those clients.
     */
    evalScript?: (client: RedisClient, script: string, keys: string[], args: string[]) => Promise<unknown>;
    setWithExpiry?: (client: RedisClient, key: string, value: unknown, seconds: number) => Promise<unknown>;
    scanKeys?: (client: RedisClient, cursor: string | number, pattern: string, count: number) => Promise<[string | number, string[]]>;
    getListLength?: (client: RedisClient, key: string) => Promise<number>;
    pushToList?: (client: RedisClient, key: string, value: unknown) => Promise<number>;
    getListRange?: (client: RedisClient, key: string, start: number, stop: number) => Promise<unknown[]>;
}
/**
 * Atomic "allocate index + append + refresh TTLs" used by `listPushIndexed`.
 *
 * KEYS[1] = list key, KEYS[2] = counter key
 * ARGV[1] = JSON-serialized object WITHOUT an `index` property
 * ARGV[2] = TTL in seconds (0 = no expiry)
 *
 * The index is spliced into the JSON text as the first property rather than
 * decoded/re-encoded with cjson, which would silently alter large integers
 * and sparse arrays. `JSON.stringify` of an object always starts with `{`,
 * so `{...}` → `{"index":N,...}` and `{}` → `{"index":N}`.
 */
export declare const LIST_PUSH_INDEXED_SCRIPT: string;
export declare class RedisServerCache extends MastraServerCache {
    private client;
    private keyPrefix;
    private ttlSeconds;
    private setWithExpiry;
    private scanKeys;
    private getListLength;
    private pushToList;
    private getListRange;
    private evalScript;
    /** Set once scripting is known to be unusable (no `eval`, or Cluster CROSSSLOT). */
    private scriptingDisabled;
    constructor(config: {
        client: RedisClient;
    }, options?: RedisServerCacheOptions);
    private getKey;
    private serialize;
    private deserialize;
    get(key: string): Promise<unknown>;
    set(key: string, value: unknown, ttlMs?: number): Promise<void>;
    listLength(key: string): Promise<number>;
    listPush(key: string, value: unknown): Promise<void>;
    listFromTo(key: string, from: number, to?: number): Promise<unknown[]>;
    delete(key: string): Promise<void>;
    clear(): Promise<void>;
    increment(key: string): Promise<number>;
    /**
     * Single round-trip index allocation + list append + TTL refresh via Lua.
     * This is the durable stream per-chunk hot path (issue #22477): the composed
     * default costs four awaited commands (INCR, EXPIRE, RPUSH, EXPIRE).
     */
    listPushIndexed(listKey: string, counterKey: string, value: Record<string, unknown>): Promise<number>;
}
export declare const upstashPreset: Pick<RedisServerCacheOptions, 'setWithExpiry' | 'scanKeys' | 'evalScript'>;
export declare const nodeRedisPreset: Pick<RedisServerCacheOptions, 'setWithExpiry' | 'scanKeys' | 'getListLength' | 'pushToList' | 'getListRange' | 'evalScript'>;
//# sourceMappingURL=cache.d.ts.map