tracker.stop();

});

it("keeps non-positive capacities usable", () => {

const tracker = createTracker({ maxEntries: 0 });

tracker.add("id1");

tracker.add("id2");

expect(tracker.size()).toBe(1);

expect(tracker.peek("id1")).toBe(false);

expect(tracker.peek("id2")).toBe(true);

tracker.stop();

});

});

describe("TTL expiration", () => {

* Prevents unbounded memory growth under high load or abuse.

*/

import { resolveIntegerOption } from "openclaw/plugin-sdk/number-runtime";

interface SeenTrackerOptions {

/** Maximum number of entries to track (default: 100,000) */

maxEntries?: number;

* Create a new seen tracker with LRU eviction and TTL expiration.

*/

export function createSeenTracker(options?: SeenTrackerOptions): SeenTracker {

const maxEntries = options?.maxEntries ?? 100_000;

const maxEntries = resolveIntegerOption(options?.maxEntries, 100_000, { min: 1 });

const ttlMs = options?.ttlMs ?? 60 * 60 * 1000; // 1 hour

const pruneIntervalMs = options?.pruneIntervalMs ?? 10 * 60 * 1000; // 10 minutes