@jamesaphoenix/tx-test-utils 0.4.2

package/dist/llm-cache/cache.js

@@ -0,0 +1,199 @@
+/**
+ * LLM response caching with SHA256 keys.
+ *
+ * Caches expensive LLM API calls by hashing inputs with SHA256.
+ * Supports version-based cache invalidation and various bypass modes.
+ *
+ * @module @tx/test-utils/llm-cache/cache
+ */
+import * as crypto from "crypto";
+import * as fs from "fs/promises";
+import * as path from "path";
+/**
+ * Get the default cache directory.
+ * Checks TX_LLM_CACHE_DIR environment variable first, then falls back to default.
+ */
+const getDefaultCacheDir = () => {
+    return process.env.TX_LLM_CACHE_DIR || "test/fixtures/llm-cache";
+};
+let config = {
+    cacheDir: getDefaultCacheDir(),
+    logging: !process.env.CI
+};
+/**
+ * Configure LLM cache settings.
+ *
+ * @example
+ * ```typescript
+ * configureLLMCache({
+ *   cacheDir: 'custom/cache/path',
+ *   logging: false
+ * })
+ * ```
+ */
+export const configureLLMCache = (options) => {
+    config = { ...config, ...options };
+};
+/**
+ * Get current cache configuration.
+ */
+export const getCacheConfig = () => config;
+/**
+ * Reset cache configuration to defaults.
+ */
+export const resetCacheConfig = () => {
+    config = {
+        cacheDir: getDefaultCacheDir(),
+        logging: !process.env.CI
+    };
+};
+// =============================================================================
+// Core Functions
+// =============================================================================
+/**
+ * Compute SHA256 hash of input string for cache key.
+ *
+ * @example
+ * ```typescript
+ * const hash = hashInput("What is the capital of France?")
+ * // -> "a1b2c3d4e5f6..." (64 hex chars)
+ * ```
+ */
+export const hashInput = (input) => {
+    return crypto.createHash("sha256").update(input).digest("hex");
+};
+/**
+ * Internal logging helper.
+ */
+const log = (message) => {
+    if (config.logging) {
+        console.log(message);
+    }
+};
+/**
+ * Get cache file path for a given hash.
+ */
+const getCacheFilePath = (hash) => {
+    return path.join(config.cacheDir, `${hash}.json`);
+};
+/**
+ * Get cached LLM response or execute and cache.
+ *
+ * Features:
+ * - TX_NO_LLM_CACHE=1 env var bypasses cache entirely
+ * - forceRefresh option forces fresh call even if cached
+ * - version option enables cache invalidation on version mismatch
+ *
+ * @example
+ * ```typescript
+ * const result = await cachedLLMCall(
+ *   "What is the capital of France?",
+ *   "claude-sonnet-4",
+ *   async () => {
+ *     const response = await anthropic.messages.create({...})
+ *     return response.content[0].text
+ *   },
+ *   { version: 2 }
+ * )
+ * ```
+ */
+export const cachedLLMCall = async (input, model, call, options = {}) => {
+    // Bypass cache if env var is set or forceRefresh is true
+    if (process.env.TX_NO_LLM_CACHE === "1" || options.forceRefresh) {
+        log(`[LLM Cache BYPASS] Calling ${model} directly`);
+        return call();
+    }
+    const inputHash = hashInput(input);
+    const cacheFile = getCacheFilePath(inputHash);
+    // Try to read from cache
+    try {
+        const content = await fs.readFile(cacheFile, "utf-8");
+        const cached = JSON.parse(content);
+        // Version mismatch triggers cache miss
+        if (options.version !== undefined && cached.version !== options.version) {
+            log(`[LLM Cache VERSION MISMATCH] ${inputHash.slice(0, 12)}... (cached: v${cached.version}, requested: v${options.version})`);
+            throw new Error("Version mismatch");
+        }
+        log(`[LLM Cache HIT] ${inputHash.slice(0, 12)}...`);
+        return cached.response;
+    }
+    catch {
+        // Cache miss - file doesn't exist, is corrupted, or version mismatch
+    }
+    // Execute the call
+    log(`[LLM Cache MISS] ${inputHash.slice(0, 12)}... calling ${model}`);
+    const response = await call();
+    // Store in cache
+    try {
+        await fs.mkdir(config.cacheDir, { recursive: true });
+        const entry = {
+            inputHash,
+            input: input.slice(0, 1000), // Truncate for readability
+            response,
+            model,
+            cachedAt: new Date().toISOString(),
+            version: options.version ?? 1
+        };
+        await fs.writeFile(cacheFile, JSON.stringify(entry, null, 2), "utf-8");
+        log(`[LLM Cache STORED] ${inputHash.slice(0, 12)}...`);
+    }
+    catch (error) {
+        // Don't fail on cache write errors - just log and continue
+        log(`[LLM Cache WRITE ERROR] ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    return response;
+};
+// =============================================================================
+// Higher-Order Function Wrapper
+// =============================================================================
+/**
+ * Wrap an async function to use LLM caching.
+ *
+ * Creates a cached version of any async function. The input is serialized
+ * and hashed to create a cache key.
+ *
+ * @example
+ * ```typescript
+ * // Wrap an extraction function
+ * const cachedExtract = withLLMCache(
+ *   async (transcript: string) => {
+ *     const response = await anthropic.messages.create({
+ *       model: "claude-sonnet-4-20250514",
+ *       messages: [{ role: "user", content: extractPrompt(transcript) }]
+ *     })
+ *     return JSON.parse(response.content[0].text)
+ *   },
+ *   { model: "claude-sonnet-4", version: 1 }
+ * )
+ *
+ * // Use it - results are cached
+ * const result1 = await cachedExtract("some transcript")
+ * const result2 = await cachedExtract("some transcript") // cache hit!
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With custom serializer for complex input
+ * interface ComplexInput {
+ *   transcript: string
+ *   metadata: { source: string }
+ * }
+ *
+ * const cachedProcess = withLLMCache(
+ *   async (input: ComplexInput) => processInput(input),
+ *   {
+ *     model: "claude-sonnet-4",
+ *     serialize: (input) => `${input.metadata.source}::${input.transcript}`,
+ *     version: 2
+ *   }
+ * )
+ * ```
+ */
+export const withLLMCache = (fn, options) => {
+    const serialize = options.serialize ?? JSON.stringify;
+    return async (input) => {
+        const serialized = serialize(input);
+        return cachedLLMCall(serialized, options.model, () => fn(input), { version: options.version });
+    };
+};
+//# sourceMappingURL=cache.js.map

package/dist/llm-cache/cache.js.map

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

package/dist/llm-cache/cache.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Integration tests for LLM response caching.
+ *
+ * @module @tx/test-utils/llm-cache/cache.test
+ */
+export {};
+//# sourceMappingURL=cache.test.d.ts.map

package/dist/llm-cache/cache.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.test.d.ts","sourceRoot":"","sources":["../../src/llm-cache/cache.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/llm-cache/cache.test.js

@@ -0,0 +1,310 @@
+/**
+ * Integration tests for LLM response caching.
+ *
+ * @module @tx/test-utils/llm-cache/cache.test
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+import * as fs from "fs/promises";
+import * as path from "path";
+import * as os from "os";
+import { hashInput, cachedLLMCall, withLLMCache, configureLLMCache, resetCacheConfig, getCacheStats, clearCache, formatCacheStats, getCacheEntry, listCacheEntries } from "./index.js";
+// =============================================================================
+// Test Setup
+// =============================================================================
+describe("LLM Cache", () => {
+    let tempDir;
+    beforeEach(async () => {
+        // Create isolated temp directory for each test
+        tempDir = await fs.mkdtemp(path.join(os.tmpdir(), "tx-llm-cache-test-"));
+        configureLLMCache({ cacheDir: tempDir, logging: false });
+    });
+    afterEach(async () => {
+        // Clean up temp directory
+        resetCacheConfig();
+        try {
+            await fs.rm(tempDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    });
+    // ===========================================================================
+    // hashInput Tests
+    // ===========================================================================
+    describe("hashInput", () => {
+        it("should return deterministic SHA256 hash", () => {
+            const input = "What is the capital of France?";
+            const hash1 = hashInput(input);
+            const hash2 = hashInput(input);
+            expect(hash1).toBe(hash2);
+            expect(hash1).toHaveLength(64); // SHA256 hex = 64 chars
+            expect(hash1).toMatch(/^[a-f0-9]{64}$/);
+        });
+        it("should produce different hashes for different inputs", () => {
+            const hash1 = hashInput("input one");
+            const hash2 = hashInput("input two");
+            expect(hash1).not.toBe(hash2);
+        });
+        it("should handle empty string", () => {
+            const hash = hashInput("");
+            expect(hash).toHaveLength(64);
+            // SHA256 of empty string is a known value
+            expect(hash).toBe("e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855");
+        });
+        it("should handle unicode input", () => {
+            const hash = hashInput("こんにちは世界 🌍");
+            expect(hash).toHaveLength(64);
+            expect(hashInput("こんにちは世界 🌍")).toBe(hash);
+        });
+        it("should handle very long input", () => {
+            const longInput = "a".repeat(100000);
+            const hash = hashInput(longInput);
+            expect(hash).toHaveLength(64);
+        });
+    });
+    // ===========================================================================
+    // cachedLLMCall Tests
+    // ===========================================================================
+    describe("cachedLLMCall", () => {
+        it("should call function on cache miss and store result", async () => {
+            const mockCall = vi.fn().mockResolvedValue({ answer: "Paris" });
+            const result = await cachedLLMCall("What is the capital of France?", "claude-sonnet-4", mockCall);
+            expect(result).toEqual({ answer: "Paris" });
+            expect(mockCall).toHaveBeenCalledTimes(1);
+            // Verify cache file was created
+            const files = await fs.readdir(tempDir);
+            expect(files.length).toBe(1);
+            expect(files[0]).toMatch(/^[a-f0-9]{64}\.json$/);
+        });
+        it("should return cached value on cache hit without calling function", async () => {
+            const mockCall = vi.fn().mockResolvedValue({ answer: "Paris" });
+            const input = "What is the capital of France?";
+            // First call - cache miss
+            await cachedLLMCall(input, "claude-sonnet-4", mockCall);
+            expect(mockCall).toHaveBeenCalledTimes(1);
+            // Second call - cache hit
+            const result = await cachedLLMCall(input, "claude-sonnet-4", mockCall);
+            expect(result).toEqual({ answer: "Paris" });
+            expect(mockCall).toHaveBeenCalledTimes(1); // Not called again
+        });
+        it("should bypass cache when TX_NO_LLM_CACHE=1", async () => {
+            const originalEnv = process.env.TX_NO_LLM_CACHE;
+            process.env.TX_NO_LLM_CACHE = "1";
+            try {
+                const mockCall = vi.fn().mockResolvedValue({ answer: "Paris" });
+                const input = "What is the capital of France?";
+                // First call
+                await cachedLLMCall(input, "claude-sonnet-4", mockCall);
+                // Second call - should still call function
+                await cachedLLMCall(input, "claude-sonnet-4", mockCall);
+                expect(mockCall).toHaveBeenCalledTimes(2);
+                // Cache should not have been written
+                const files = await fs.readdir(tempDir);
+                expect(files.length).toBe(0);
+            }
+            finally {
+                if (originalEnv === undefined) {
+                    delete process.env.TX_NO_LLM_CACHE;
+                }
+                else {
+                    process.env.TX_NO_LLM_CACHE = originalEnv;
+                }
+            }
+        });
+        it("should bypass cache when forceRefresh=true", async () => {
+            const mockCall = vi.fn()
+                .mockResolvedValueOnce({ answer: "Paris" })
+                .mockResolvedValueOnce({ answer: "Paris (updated)" });
+            const input = "What is the capital of France?";
+            // First call - cache miss
+            await cachedLLMCall(input, "claude-sonnet-4", mockCall);
+            // Second call with forceRefresh - should call function
+            const result = await cachedLLMCall(input, "claude-sonnet-4", mockCall, { forceRefresh: true });
+            expect(result).toEqual({ answer: "Paris (updated)" });
+            expect(mockCall).toHaveBeenCalledTimes(2);
+        });
+        it("should trigger cache miss on version mismatch", async () => {
+            const mockCall = vi.fn()
+                .mockResolvedValueOnce({ answer: "Paris v1" })
+                .mockResolvedValueOnce({ answer: "Paris v2" });
+            const input = "What is the capital of France?";
+            // First call with version 1
+            await cachedLLMCall(input, "claude-sonnet-4", mockCall, { version: 1 });
+            // Second call with version 2 - should be cache miss
+            const result = await cachedLLMCall(input, "claude-sonnet-4", mockCall, { version: 2 });
+            expect(result).toEqual({ answer: "Paris v2" });
+            expect(mockCall).toHaveBeenCalledTimes(2);
+        });
+        it("should store correct cache entry format", async () => {
+            const mockCall = vi.fn().mockResolvedValue({ answer: "Paris" });
+            const input = "What is the capital of France?";
+            await cachedLLMCall(input, "claude-sonnet-4", mockCall, { version: 3 });
+            const hash = hashInput(input);
+            const cacheFile = path.join(tempDir, `${hash}.json`);
+            const content = JSON.parse(await fs.readFile(cacheFile, "utf-8"));
+            expect(content.inputHash).toBe(hash);
+            expect(content.input).toBe(input);
+            expect(content.response).toEqual({ answer: "Paris" });
+            expect(content.model).toBe("claude-sonnet-4");
+            expect(content.version).toBe(3);
+            expect(content.cachedAt).toMatch(/^\d{4}-\d{2}-\d{2}T/);
+        });
+        it("should truncate long input in cache entry", async () => {
+            const mockCall = vi.fn().mockResolvedValue({ answer: "42" });
+            const longInput = "a".repeat(2000);
+            await cachedLLMCall(longInput, "claude-sonnet-4", mockCall);
+            const hash = hashInput(longInput);
+            const cacheFile = path.join(tempDir, `${hash}.json`);
+            const content = JSON.parse(await fs.readFile(cacheFile, "utf-8"));
+            expect(content.input.length).toBe(1000); // Truncated
+            expect(content.inputHash).toBe(hash); // Full hash preserved
+        });
+    });
+    // ===========================================================================
+    // withLLMCache Tests
+    // ===========================================================================
+    describe("withLLMCache", () => {
+        it("should wrap function with caching", async () => {
+            const mockFn = vi.fn().mockResolvedValue("result");
+            const cachedFn = withLLMCache(mockFn, { model: "claude-sonnet-4" });
+            const result1 = await cachedFn("input");
+            const result2 = await cachedFn("input");
+            expect(result1).toBe("result");
+            expect(result2).toBe("result");
+            expect(mockFn).toHaveBeenCalledTimes(1);
+        });
+        it("should use custom serializer", async () => {
+            const mockFn = vi.fn().mockResolvedValue("result");
+            const cachedFn = withLLMCache(mockFn, {
+                model: "claude-sonnet-4",
+                // Only use query for cache key (ignore context)
+                serialize: (input) => input.query
+            });
+            // Same query, different context - should hit cache
+            await cachedFn({ query: "test", context: ["a"] });
+            await cachedFn({ query: "test", context: ["b", "c"] });
+            expect(mockFn).toHaveBeenCalledTimes(1);
+        });
+        it("should pass version to cachedLLMCall", async () => {
+            const mockFn = vi.fn()
+                .mockResolvedValueOnce("v1 result")
+                .mockResolvedValueOnce("v2 result");
+            const cachedFnV1 = withLLMCache(mockFn, { model: "claude-sonnet-4", version: 1 });
+            const cachedFnV2 = withLLMCache(mockFn, { model: "claude-sonnet-4", version: 2 });
+            await cachedFnV1("input");
+            const result = await cachedFnV2("input");
+            expect(result).toBe("v2 result");
+            expect(mockFn).toHaveBeenCalledTimes(2);
+        });
+    });
+    // ===========================================================================
+    // CLI Utilities Tests
+    // ===========================================================================
+    describe("getCacheStats", () => {
+        it("should return empty stats for empty cache", async () => {
+            const stats = await getCacheStats();
+            expect(stats.count).toBe(0);
+            expect(stats.totalBytes).toBe(0);
+            expect(stats.oldestDate).toBeNull();
+            expect(stats.newestDate).toBeNull();
+            expect(stats.byModel).toEqual({});
+            expect(stats.byVersion).toEqual({});
+        });
+        it("should return correct stats for populated cache", async () => {
+            // Create some cache entries
+            await cachedLLMCall("input1", "claude-sonnet-4", () => Promise.resolve("r1"), { version: 1 });
+            await cachedLLMCall("input2", "claude-sonnet-4", () => Promise.resolve("r2"), { version: 1 });
+            await cachedLLMCall("input3", "claude-haiku", () => Promise.resolve("r3"), { version: 2 });
+            const stats = await getCacheStats();
+            expect(stats.count).toBe(3);
+            expect(stats.totalBytes).toBeGreaterThan(0);
+            expect(stats.oldestDate).toBeInstanceOf(Date);
+            expect(stats.newestDate).toBeInstanceOf(Date);
+            expect(stats.byModel).toEqual({
+                "claude-sonnet-4": 2,
+                "claude-haiku": 1
+            });
+            expect(stats.byVersion).toEqual({
+                1: 2,
+                2: 1
+            });
+        });
+    });
+    describe("clearCache", () => {
+        it("should clear all entries with all=true", async () => {
+            await cachedLLMCall("input1", "claude-sonnet-4", () => Promise.resolve("r1"));
+            await cachedLLMCall("input2", "claude-sonnet-4", () => Promise.resolve("r2"));
+            const deleted = await clearCache({ all: true });
+            expect(deleted).toBe(-1); // Unknown count for all
+            const files = await fs.readdir(tempDir);
+            expect(files.length).toBe(0);
+        });
+        it("should clear entries by model", async () => {
+            await cachedLLMCall("input1", "claude-sonnet-4", () => Promise.resolve("r1"));
+            await cachedLLMCall("input2", "claude-haiku", () => Promise.resolve("r2"));
+            const deleted = await clearCache({ model: "claude-sonnet-4" });
+            expect(deleted).toBe(1);
+            const stats = await getCacheStats();
+            expect(stats.count).toBe(1);
+            expect(stats.byModel).toEqual({ "claude-haiku": 1 });
+        });
+        it("should clear entries by version", async () => {
+            await cachedLLMCall("input1", "claude-sonnet-4", () => Promise.resolve("r1"), { version: 1 });
+            await cachedLLMCall("input2", "claude-sonnet-4", () => Promise.resolve("r2"), { version: 2 });
+            const deleted = await clearCache({ version: 1 });
+            expect(deleted).toBe(1);
+            const stats = await getCacheStats();
+            expect(stats.byVersion).toEqual({ 2: 1 });
+        });
+        it("should clear entries older than date", async () => {
+            await cachedLLMCall("input1", "claude-sonnet-4", () => Promise.resolve("r1"));
+            // Clear entries older than 1 second in the future (all entries)
+            const futureDate = new Date(Date.now() + 1000);
+            const deleted = await clearCache({ olderThan: futureDate });
+            expect(deleted).toBe(1);
+        });
+    });
+    describe("formatCacheStats", () => {
+        it("should format stats as readable string", async () => {
+            await cachedLLMCall("input1", "claude-sonnet-4", () => Promise.resolve("r1"), { version: 1 });
+            await cachedLLMCall("input2", "claude-haiku", () => Promise.resolve("r2"), { version: 2 });
+            const stats = await getCacheStats();
+            const formatted = formatCacheStats(stats);
+            expect(formatted).toContain("LLM Cache Statistics:");
+            expect(formatted).toContain("Entries: 2");
+            expect(formatted).toContain("By model:");
+            expect(formatted).toContain("claude-sonnet-4: 1");
+            expect(formatted).toContain("claude-haiku: 1");
+        });
+    });
+    describe("getCacheEntry", () => {
+        it("should return entry by hash", async () => {
+            const input = "test input";
+            await cachedLLMCall(input, "claude-sonnet-4", () => Promise.resolve("result"));
+            const hash = hashInput(input);
+            const entry = await getCacheEntry(hash);
+            expect(entry).not.toBeNull();
+            expect(entry?.response).toBe("result");
+            expect(entry?.model).toBe("claude-sonnet-4");
+        });
+        it("should return null for non-existent hash", async () => {
+            const entry = await getCacheEntry("nonexistent");
+            expect(entry).toBeNull();
+        });
+    });
+    describe("listCacheEntries", () => {
+        it("should list all cache entry hashes", async () => {
+            await cachedLLMCall("input1", "claude-sonnet-4", () => Promise.resolve("r1"));
+            await cachedLLMCall("input2", "claude-sonnet-4", () => Promise.resolve("r2"));
+            const entries = await listCacheEntries();
+            expect(entries.length).toBe(2);
+            expect(entries[0]).toHaveLength(64);
+            expect(entries[1]).toHaveLength(64);
+        });
+        it("should return empty array for empty cache", async () => {
+            const entries = await listCacheEntries();
+            expect(entries).toEqual([]);
+        });
+    });
+});
+//# sourceMappingURL=cache.test.js.map

package/dist/llm-cache/cache.test.js.map

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

package/dist/llm-cache/cli.d.ts

@@ -0,0 +1,113 @@
+/**
+ * CLI utilities for LLM cache management.
+ *
+ * Provides functions to inspect, clear, and manage the LLM response cache.
+ *
+ * @module @tx/test-utils/llm-cache/cli
+ */
+import { CacheEntry } from "./cache.js";
+/**
+ * Statistics about the LLM cache.
+ */
+export interface CacheStats {
+    /** Total number of cache entries */
+    count: number;
+    /** Total size in bytes */
+    totalBytes: number;
+    /** Oldest cache entry date (null if empty) */
+    oldestDate: Date | null;
+    /** Newest cache entry date (null if empty) */
+    newestDate: Date | null;
+    /** Count of entries by model */
+    byModel: Record<string, number>;
+    /** Count of entries by version */
+    byVersion: Record<number, number>;
+}
+/**
+ * Options for clearing cache.
+ */
+export interface ClearCacheOptions {
+    /** Delete entries older than this date */
+    olderThan?: Date;
+    /** Delete entries for specific model */
+    model?: string;
+    /** Delete entries with specific version */
+    version?: number;
+    /** Delete all entries */
+    all?: boolean;
+}
+/**
+ * Get statistics about the LLM cache.
+ *
+ * @example
+ * ```typescript
+ * const stats = await getCacheStats()
+ * console.log(`Cache has ${stats.count} entries using ${stats.totalBytes} bytes`)
+ * console.log(`Models: ${Object.keys(stats.byModel).join(', ')}`)
+ * ```
+ */
+export declare const getCacheStats: () => Promise<CacheStats>;
+/**
+ * Clear cache entries based on options.
+ *
+ * @returns Number of entries deleted (-1 if unknown when using `all`)
+ *
+ * @example
+ * ```typescript
+ * // Clear all cache
+ * await clearCache({ all: true })
+ *
+ * // Clear entries older than 30 days
+ * const thirtyDaysAgo = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000)
+ * const deleted = await clearCache({ olderThan: thirtyDaysAgo })
+ *
+ * // Clear entries for specific model
+ * await clearCache({ model: 'claude-haiku' })
+ *
+ * // Clear entries with specific version (useful after schema changes)
+ * await clearCache({ version: 1 })
+ * ```
+ */
+export declare const clearCache: (options?: ClearCacheOptions) => Promise<number>;
+/**
+ * Format cache statistics for display.
+ *
+ * @example
+ * ```typescript
+ * const stats = await getCacheStats()
+ * console.log(formatCacheStats(stats))
+ * // Output:
+ * // LLM Cache Statistics:
+ * //   Entries: 142
+ * //   Size: 3.2 MB
+ * //   Date range: 2024-01-15 to 2024-02-01
+ * //   By model:
+ * //     claude-sonnet-4: 98
+ * //     claude-haiku: 44
+ * ```
+ */
+export declare const formatCacheStats: (stats: CacheStats) => string;
+/**
+ * Get a specific cache entry by hash.
+ *
+ * @example
+ * ```typescript
+ * const entry = await getCacheEntry('a1b2c3d4...')
+ * if (entry) {
+ *   console.log(`Cached at: ${entry.cachedAt}`)
+ *   console.log(`Model: ${entry.model}`)
+ * }
+ * ```
+ */
+export declare const getCacheEntry: <T = unknown>(hash: string) => Promise<CacheEntry<T> | null>;
+/**
+ * List all cache entry hashes.
+ *
+ * @example
+ * ```typescript
+ * const hashes = await listCacheEntries()
+ * console.log(`Found ${hashes.length} cached responses`)
+ * ```
+ */
+export declare const listCacheEntries: () => Promise<string[]>;
+//# sourceMappingURL=cli.d.ts.map