agent-scratchpad 0.1.0

package/dist/context.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toContext = toContext;
+function toContext(entries, options) {
+    const format = options?.format ?? 'kv';
+    const filterTags = options?.filterTags;
+    const filterNamespace = options?.filterNamespace;
+    const maxTokens = options?.maxTokens;
+    const tokenCounter = options?.tokenCounter ?? ((text) => text.length);
+    const header = options?.header;
+    // Filter by tags
+    let filtered = entries;
+    if (filterTags && filterTags.length > 0) {
+        filtered = filtered.filter((e) => e.tags.some((t) => filterTags.includes(t)));
+    }
+    // Filter by namespace
+    if (filterNamespace) {
+        const prefix = filterNamespace.endsWith(':') ? filterNamespace : `${filterNamespace}:`;
+        filtered = filtered.filter((e) => e.key.startsWith(prefix));
+    }
+    let body;
+    if (format === 'json') {
+        const obj = {};
+        for (const e of filtered) {
+            obj[e.key] = e.value;
+        }
+        body = JSON.stringify(obj);
+    }
+    else if (format === 'markdown') {
+        body = filtered
+            .map((e) => `## ${e.key}\n${String(e.value)}`)
+            .join('\n\n');
+    }
+    else if (format === 'xml') {
+        body = filtered
+            .map((e) => `<entry key="${e.key}">${String(e.value)}</entry>`)
+            .join('\n');
+    }
+    else {
+        // kv (default)
+        body = filtered.map((e) => `${e.key}: ${String(e.value)}`).join('\n');
+    }
+    let result = header ? `${header}\n${body}` : body;
+    // Truncate to maxTokens
+    if (maxTokens !== undefined) {
+        while (tokenCounter(result) > maxTokens && result.length > 0) {
+            result = result.slice(0, result.length - 1);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,12 @@
+export declare class ScratchpadError extends Error {
+    readonly code: string;
+    constructor(msg: string, code: string);
+}
+export declare class ScratchpadConfigError extends ScratchpadError {
+    constructor(msg: string);
+}
+export declare class ScratchpadVersionError extends ScratchpadError {
+    readonly version: number;
+    constructor(version: number);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;IACf,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAlC,GAAG,EAAE,MAAM,EAAW,IAAI,EAAE,MAAM;CAI/C;AAED,qBAAa,qBAAsB,SAAQ,eAAe;gBAC5C,GAAG,EAAE,MAAM;CAGxB;AAED,qBAAa,sBAAuB,SAAQ,eAAe;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM;gBAAf,OAAO,EAAE,MAAM;CAGrC"}

package/dist/errors.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScratchpadVersionError = exports.ScratchpadConfigError = exports.ScratchpadError = void 0;
+class ScratchpadError extends Error {
+    code;
+    constructor(msg, code) {
+        super(msg);
+        this.code = code;
+        this.name = 'ScratchpadError';
+    }
+}
+exports.ScratchpadError = ScratchpadError;
+class ScratchpadConfigError extends ScratchpadError {
+    constructor(msg) {
+        super(msg, 'SCRATCHPAD_CONFIG_ERROR');
+    }
+}
+exports.ScratchpadConfigError = ScratchpadConfigError;
+class ScratchpadVersionError extends ScratchpadError {
+    version;
+    constructor(version) {
+        super(`Unsupported snapshot version: ${version}`, 'SCRATCHPAD_VERSION_ERROR');
+        this.version = version;
+    }
+}
+exports.ScratchpadVersionError = ScratchpadVersionError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAAA,MAAa,eAAgB,SAAQ,KAAK;IACN;IAAlC,YAAY,GAAW,EAAW,IAAY;QAC5C,KAAK,CAAC,GAAG,CAAC,CAAC;QADqB,SAAI,GAAJ,IAAI,CAAQ;QAE5C,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AALD,0CAKC;AAED,MAAa,qBAAsB,SAAQ,eAAe;IACxD,YAAY,GAAW;QACrB,KAAK,CAAC,GAAG,EAAE,yBAAyB,CAAC,CAAC;IACxC,CAAC;CACF;AAJD,sDAIC;AAED,MAAa,sBAAuB,SAAQ,eAAe;IACpC;IAArB,YAAqB,OAAe;QAClC,KAAK,CAAC,iCAAiC,OAAO,EAAE,EAAE,0BAA0B,CAAC,CAAC;QAD3D,YAAO,GAAP,OAAO,CAAQ;IAEpC,CAAC;CACF;AAJD,wDAIC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { createScratchpad, fromSnapshot } from './scratchpad.js';
+export { toContext } from './context.js';
+export { isExpired, expiresAt } from './ttl.js';
+export { ScratchpadError, ScratchpadConfigError, ScratchpadVersionError } from './errors.js';
+export type { Scratchpad, ScratchpadEntry, ScratchpadOptions, ScratchpadSnapshot, ScratchpadStats, ToContextOptions, EntryOptions, ScratchpadEventName, ScratchpadEventHandler, ScratchpadEvents, PersistenceAdapter, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC7F,YAAY,EACV,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScratchpadVersionError = exports.ScratchpadConfigError = exports.ScratchpadError = exports.expiresAt = exports.isExpired = exports.toContext = exports.fromSnapshot = exports.createScratchpad = void 0;
+// agent-scratchpad - Lightweight key-value scratchpad for agent reasoning
+var scratchpad_js_1 = require("./scratchpad.js");
+Object.defineProperty(exports, "createScratchpad", { enumerable: true, get: function () { return scratchpad_js_1.createScratchpad; } });
+Object.defineProperty(exports, "fromSnapshot", { enumerable: true, get: function () { return scratchpad_js_1.fromSnapshot; } });
+var context_js_1 = require("./context.js");
+Object.defineProperty(exports, "toContext", { enumerable: true, get: function () { return context_js_1.toContext; } });
+var ttl_js_1 = require("./ttl.js");
+Object.defineProperty(exports, "isExpired", { enumerable: true, get: function () { return ttl_js_1.isExpired; } });
+Object.defineProperty(exports, "expiresAt", { enumerable: true, get: function () { return ttl_js_1.expiresAt; } });
+var errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "ScratchpadError", { enumerable: true, get: function () { return errors_js_1.ScratchpadError; } });
+Object.defineProperty(exports, "ScratchpadConfigError", { enumerable: true, get: function () { return errors_js_1.ScratchpadConfigError; } });
+Object.defineProperty(exports, "ScratchpadVersionError", { enumerable: true, get: function () { return errors_js_1.ScratchpadVersionError; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,0EAA0E;AAC1E,iDAAiE;AAAxD,iHAAA,gBAAgB,OAAA;AAAE,6GAAA,YAAY,OAAA;AACvC,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAClB,mCAAgD;AAAvC,mGAAA,SAAS,OAAA;AAAE,mGAAA,SAAS,OAAA;AAC7B,yCAA6F;AAApF,4GAAA,eAAe,OAAA;AAAE,kHAAA,qBAAqB,OAAA;AAAE,mHAAA,sBAAsB,OAAA"}

package/dist/scratchpad.d.ts

@@ -0,0 +1,5 @@
+import { Scratchpad, ScratchpadOptions, ScratchpadSnapshot } from './types.js';
+export declare function createScratchpad(options?: ScratchpadOptions): Scratchpad;
+export declare function fromSnapshot(snap: ScratchpadSnapshot, opts?: ScratchpadOptions): ReturnType<typeof createScratchpad>;
+export type { Scratchpad, ScratchpadEntry, ScratchpadOptions, ScratchpadSnapshot, ScratchpadStats, ToContextOptions, EntryOptions, ScratchpadEventName, ScratchpadEventHandler, ScratchpadEvents, PersistenceAdapter, } from './types.js';
+//# sourceMappingURL=scratchpad.d.ts.map

package/dist/scratchpad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scratchpad.d.ts","sourceRoot":"","sources":["../src/scratchpad.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EAEV,iBAAiB,EACjB,kBAAkB,EAOnB,MAAM,YAAY,CAAC;AAKpB,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,UAAU,CA2VxE;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,kBAAkB,EACxB,IAAI,CAAC,EAAE,iBAAiB,GACvB,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAIrC;AAGD,YAAY,EACV,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/scratchpad.js

@@ -0,0 +1,337 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createScratchpad = createScratchpad;
+exports.fromSnapshot = fromSnapshot;
+const ttl_js_1 = require("./ttl.js");
+const context_js_1 = require("./context.js");
+const errors_js_1 = require("./errors.js");
+function createScratchpad(options) {
+    const store = new Map();
+    const listeners = new Map();
+    const nowFn = options?.now ?? (() => Date.now());
+    const persistence = options?.persistence;
+    let sweepTimer = null;
+    if (options?.sweepIntervalMs && options.sweepIntervalMs > 0) {
+        sweepTimer = setInterval(() => {
+            const n = nowFn();
+            for (const [key, entry] of store) {
+                if ((0, ttl_js_1.isExpired)(entry, n)) {
+                    store.delete(key);
+                    emit('expire', { key, entry });
+                }
+            }
+        }, options.sweepIntervalMs);
+        if (sweepTimer.unref)
+            sweepTimer.unref();
+    }
+    function emit(event, data) {
+        const handlers = listeners.get(event);
+        if (handlers) {
+            for (const h of handlers) {
+                try {
+                    h(data);
+                }
+                catch { /* swallow handler errors */ }
+            }
+        }
+    }
+    function set(key, value, entryOptions) {
+        const now = nowFn();
+        // Lazy-expire any existing entry
+        const existing = store.get(key);
+        if (existing && (0, ttl_js_1.isExpired)(existing, now)) {
+            store.delete(key);
+            emit('expire', { key, entry: existing });
+        }
+        const isUpdate = store.has(key);
+        const ttl = entryOptions?.ttl !== undefined ? entryOptions.ttl : (options?.defaultTtl ?? null);
+        const slidingTtl = entryOptions?.slidingTtl !== undefined
+            ? entryOptions.slidingTtl
+            : (options?.defaultSlidingTtl ?? false);
+        const tags = entryOptions?.tags ?? [];
+        const entry = {
+            key,
+            value,
+            createdAt: isUpdate ? (store.get(key).createdAt) : now,
+            updatedAt: now,
+            accessedAt: now,
+            ttl,
+            slidingTtl,
+            tags,
+        };
+        store.set(key, entry);
+        emit('set', { key, entry, isUpdate });
+    }
+    function get(key) {
+        const entry = store.get(key);
+        if (!entry)
+            return undefined;
+        const now = nowFn();
+        if ((0, ttl_js_1.isExpired)(entry, now)) {
+            store.delete(key);
+            emit('expire', { key, entry });
+            return undefined;
+        }
+        // Update accessedAt (and sliding TTL base)
+        const updated = { ...entry, accessedAt: now };
+        store.set(key, updated);
+        return updated.value;
+    }
+    function has(key) {
+        const entry = store.get(key);
+        if (!entry)
+            return false;
+        const now = nowFn();
+        if ((0, ttl_js_1.isExpired)(entry, now)) {
+            store.delete(key);
+            emit('expire', { key, entry });
+            return false;
+        }
+        return true;
+    }
+    function del(key) {
+        const entry = store.get(key);
+        if (!entry)
+            return false;
+        store.delete(key);
+        emit('delete', { key, entry });
+        return true;
+    }
+    function clear() {
+        const count = store.size;
+        store.clear();
+        emit('clear', { count });
+    }
+    function keys() {
+        const now = nowFn();
+        const result = [];
+        for (const [key, entry] of store) {
+            if (!(0, ttl_js_1.isExpired)(entry, now))
+                result.push(key);
+        }
+        return result;
+    }
+    function entries() {
+        const now = nowFn();
+        const result = [];
+        for (const [key, entry] of store) {
+            if (!(0, ttl_js_1.isExpired)(entry, now))
+                result.push([key, entry]);
+        }
+        return result;
+    }
+    function findByTag(tag) {
+        const now = nowFn();
+        const result = [];
+        for (const [, entry] of store) {
+            if (!(0, ttl_js_1.isExpired)(entry, now) && entry.tags.includes(tag))
+                result.push(entry);
+        }
+        return result;
+    }
+    function namespace(name) {
+        const prefix = `${name}:`;
+        const ns = {
+            set(key, value, entryOpts) {
+                set(`${prefix}${key}`, value, entryOpts);
+            },
+            get(key) {
+                return get(`${prefix}${key}`);
+            },
+            has(key) {
+                return has(`${prefix}${key}`);
+            },
+            delete(key) {
+                return del(`${prefix}${key}`);
+            },
+            clear() {
+                const now = nowFn();
+                for (const [k, entry] of store) {
+                    if (k.startsWith(prefix) && !(0, ttl_js_1.isExpired)(entry, now)) {
+                        store.delete(k);
+                        emit('delete', { key: k, entry });
+                    }
+                }
+            },
+            keys() {
+                const now = nowFn();
+                const result = [];
+                for (const [k, entry] of store) {
+                    if (k.startsWith(prefix) && !(0, ttl_js_1.isExpired)(entry, now)) {
+                        result.push(k.slice(prefix.length));
+                    }
+                }
+                return result;
+            },
+            entries() {
+                const now = nowFn();
+                const result = [];
+                for (const [k, entry] of store) {
+                    if (k.startsWith(prefix) && !(0, ttl_js_1.isExpired)(entry, now)) {
+                        result.push([k.slice(prefix.length), entry]);
+                    }
+                }
+                return result;
+            },
+            findByTag(tag) {
+                const now = nowFn();
+                const result = [];
+                for (const [k, entry] of store) {
+                    if (k.startsWith(prefix) && !(0, ttl_js_1.isExpired)(entry, now) && entry.tags.includes(tag)) {
+                        result.push(entry);
+                    }
+                }
+                return result;
+            },
+            namespace(subName) {
+                return namespace(`${name}:${subName}`);
+            },
+            snapshot() {
+                return snapshot();
+            },
+            restore(snap) {
+                return restore(snap);
+            },
+            toContext(opts) {
+                return toContext(opts);
+            },
+            serialize() {
+                return snapshot();
+            },
+            stats() {
+                return stats();
+            },
+            on(event, handler) {
+                return on(event, handler);
+            },
+            save() {
+                return save();
+            },
+            load() {
+                return load();
+            },
+            destroy() {
+                return destroy();
+            },
+        };
+        return ns;
+    }
+    function snapshot() {
+        const entriesObj = {};
+        for (const [k, v] of store) {
+            entriesObj[k] = v;
+        }
+        return { entries: entriesObj, timestamp: nowFn(), version: 1 };
+    }
+    function restore(snap) {
+        if (snap.version !== 1) {
+            throw new errors_js_1.ScratchpadVersionError(snap.version);
+        }
+        store.clear();
+        for (const [k, v] of Object.entries(snap.entries)) {
+            store.set(k, v);
+        }
+    }
+    function toContext(opts) {
+        const all = entries().map(([, e]) => e);
+        return (0, context_js_1.toContext)(all, opts);
+    }
+    function stats() {
+        const now = nowFn();
+        const liveEntries = [];
+        for (const [, entry] of store) {
+            if (!(0, ttl_js_1.isExpired)(entry, now))
+                liveEntries.push(entry);
+        }
+        const namespaceSet = new Set();
+        for (const e of liveEntries) {
+            const colonIdx = e.key.indexOf(':');
+            if (colonIdx !== -1) {
+                namespaceSet.add(e.key.slice(0, colonIdx));
+            }
+        }
+        const namespaces = Array.from(namespaceSet);
+        let entriesWithTtl = 0;
+        const tagCounts = {};
+        let oldestEntryAt = null;
+        let newestEntryAt = null;
+        for (const e of liveEntries) {
+            if (e.ttl !== null && e.ttl !== undefined)
+                entriesWithTtl++;
+            for (const tag of e.tags) {
+                tagCounts[tag] = (tagCounts[tag] ?? 0) + 1;
+            }
+            if (oldestEntryAt === null || e.createdAt < oldestEntryAt)
+                oldestEntryAt = e.createdAt;
+            if (newestEntryAt === null || e.createdAt > newestEntryAt)
+                newestEntryAt = e.createdAt;
+        }
+        return {
+            size: liveEntries.length,
+            rawSize: store.size,
+            namespaceCount: namespaces.length,
+            namespaces,
+            entriesWithTtl,
+            tagCounts,
+            oldestEntryAt,
+            newestEntryAt,
+        };
+    }
+    function on(event, handler) {
+        if (!listeners.has(event)) {
+            listeners.set(event, new Set());
+        }
+        const set = listeners.get(event);
+        set.add(handler);
+        return () => {
+            set.delete(handler);
+        };
+    }
+    function save() {
+        if (!persistence)
+            return Promise.resolve();
+        return persistence.save(snapshot());
+    }
+    function load() {
+        if (!persistence)
+            return Promise.resolve();
+        return persistence.load().then((snap) => {
+            if (snap)
+                restore(snap);
+        });
+    }
+    function destroy() {
+        if (sweepTimer !== null) {
+            clearInterval(sweepTimer);
+            sweepTimer = null;
+        }
+        return Promise.resolve();
+    }
+    const scratchpad = {
+        set,
+        get,
+        has,
+        delete: del,
+        clear,
+        keys,
+        entries,
+        findByTag,
+        namespace,
+        snapshot,
+        restore,
+        toContext,
+        serialize: snapshot,
+        stats,
+        on,
+        save,
+        load,
+        destroy,
+    };
+    return scratchpad;
+}
+function fromSnapshot(snap, opts) {
+    const pad = createScratchpad(opts);
+    pad.restore(snap);
+    return pad;
+}
+//# sourceMappingURL=scratchpad.js.map

package/dist/scratchpad.js.map

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

package/dist/ttl.d.ts

@@ -0,0 +1,4 @@
+import { ScratchpadEntry } from './types.js';
+export declare function isExpired(entry: ScratchpadEntry, now: number): boolean;
+export declare function expiresAt(entry: ScratchpadEntry): number | null;
+//# sourceMappingURL=ttl.d.ts.map

package/dist/ttl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ttl.d.ts","sourceRoot":"","sources":["../src/ttl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,wBAAgB,SAAS,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAItE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAI/D"}

package/dist/ttl.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isExpired = isExpired;
+exports.expiresAt = expiresAt;
+function isExpired(entry, now) {
+    if (entry.ttl === null || entry.ttl === undefined)
+        return false;
+    const base = entry.slidingTtl ? entry.accessedAt : entry.createdAt;
+    return now >= base + entry.ttl;
+}
+function expiresAt(entry) {
+    if (entry.ttl === null || entry.ttl === undefined)
+        return null;
+    const base = entry.slidingTtl ? entry.accessedAt : entry.createdAt;
+    return base + entry.ttl;
+}
+//# sourceMappingURL=ttl.js.map

package/dist/ttl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ttl.js","sourceRoot":"","sources":["../src/ttl.ts"],"names":[],"mappings":";;AAEA,8BAIC;AAED,8BAIC;AAVD,SAAgB,SAAS,CAAC,KAAsB,EAAE,GAAW;IAC3D,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAChE,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC;IACnE,OAAO,GAAG,IAAI,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC;AACjC,CAAC;AAED,SAAgB,SAAS,CAAC,KAAsB;IAC9C,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC/D,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC;IACnE,OAAO,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC;AAC1B,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,91 @@
+export interface ScratchpadEntry<T = unknown> {
+    key: string;
+    value: T;
+    createdAt: number;
+    updatedAt: number;
+    accessedAt: number;
+    ttl: number | null;
+    slidingTtl: boolean;
+    tags: string[];
+}
+export interface EntryOptions {
+    ttl?: number | null;
+    slidingTtl?: boolean;
+    tags?: string[];
+}
+export interface ScratchpadOptions {
+    defaultTtl?: number | null;
+    defaultSlidingTtl?: boolean;
+    sweepIntervalMs?: number | null;
+    now?: () => number;
+    persistence?: PersistenceAdapter;
+}
+export interface ScratchpadSnapshot {
+    entries: Record<string, ScratchpadEntry>;
+    timestamp: number;
+    version: 1;
+}
+export interface ScratchpadStats {
+    size: number;
+    rawSize: number;
+    namespaceCount: number;
+    namespaces: string[];
+    entriesWithTtl: number;
+    tagCounts: Record<string, number>;
+    oldestEntryAt: number | null;
+    newestEntryAt: number | null;
+}
+export interface ToContextOptions {
+    format?: 'markdown' | 'xml' | 'json' | 'kv';
+    filterTags?: string[];
+    filterNamespace?: string;
+    maxTokens?: number;
+    tokenCounter?: (text: string) => number;
+    includeMetadata?: boolean;
+    header?: string;
+}
+export interface PersistenceAdapter {
+    load(): Promise<ScratchpadSnapshot | null>;
+    save(snap: ScratchpadSnapshot): Promise<void>;
+}
+export interface ScratchpadEvents {
+    set: {
+        key: string;
+        entry: ScratchpadEntry;
+        isUpdate: boolean;
+    };
+    delete: {
+        key: string;
+        entry: ScratchpadEntry;
+    };
+    expire: {
+        key: string;
+        entry: ScratchpadEntry;
+    };
+    clear: {
+        count: number;
+    };
+}
+export type ScratchpadEventName = keyof ScratchpadEvents;
+export type ScratchpadEventHandler<K extends ScratchpadEventName> = (data: ScratchpadEvents[K]) => void;
+export interface Scratchpad {
+    set<T = unknown>(key: string, value: T, options?: EntryOptions): void;
+    get<T = unknown>(key: string): T | undefined;
+    has(key: string): boolean;
+    delete(key: string): boolean;
+    clear(): void;
+    keys(): string[];
+    entries(): [string, ScratchpadEntry][];
+    findByTag(tag: string): ScratchpadEntry[];
+    namespace(name: string): Scratchpad;
+    snapshot(): ScratchpadSnapshot;
+    restore(snapshot: ScratchpadSnapshot): void;
+    toContext(options?: ToContextOptions): string;
+    serialize(): ScratchpadSnapshot;
+    stats(): ScratchpadStats;
+    on<K extends ScratchpadEventName>(event: K, handler: ScratchpadEventHandler<K>): () => void;
+    save(): Promise<void>;
+    load(): Promise<void>;
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}