@loom-node/memory 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Loom Node Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/estimator-tokenizer.d.ts

@@ -0,0 +1,8 @@
+import type { Tokenizer } from '@loom-node/core';
+export declare class EstimatorTokenizer implements Tokenizer {
+    private readonly ratio;
+    constructor(charsPerToken?: number);
+    count(text: string): number;
+    truncate(text: string, maxTokens: number): string;
+}
+//# sourceMappingURL=estimator-tokenizer.d.ts.map

package/dist/estimator-tokenizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimator-tokenizer.d.ts","sourceRoot":"","sources":["../src/estimator-tokenizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD,qBAAa,kBAAmB,YAAW,SAAS;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,aAAa,SAAkB;IAI3C,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI3B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;CAIlD"}

package/dist/estimator-tokenizer.js

@@ -0,0 +1,15 @@
+const CHARS_PER_TOKEN = 4;
+export class EstimatorTokenizer {
+    ratio;
+    constructor(charsPerToken = CHARS_PER_TOKEN) {
+        this.ratio = charsPerToken;
+    }
+    count(text) {
+        return Math.ceil(text.length / this.ratio);
+    }
+    truncate(text, maxTokens) {
+        const maxChars = maxTokens * this.ratio;
+        return text.length <= maxChars ? text : text.slice(0, maxChars);
+    }
+}
+//# sourceMappingURL=estimator-tokenizer.js.map

package/dist/estimator-tokenizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimator-tokenizer.js","sourceRoot":"","sources":["../src/estimator-tokenizer.ts"],"names":[],"mappings":"AAEA,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B,MAAM,OAAO,kBAAkB;IACZ,KAAK,CAAS;IAE/B,YAAY,aAAa,GAAG,eAAe;QACzC,IAAI,CAAC,KAAK,GAAG,aAAa,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,IAAY;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,QAAQ,CAAC,IAAY,EAAE,SAAiB;QACtC,MAAM,QAAQ,GAAG,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC;QACxC,OAAO,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAClE,CAAC;CACF"}

package/dist/in-memory-store.d.ts

@@ -0,0 +1,8 @@
+import type { PersistentStore, MemoryEntry, SearchOptions } from '@loom-node/core';
+export declare class InMemoryPersistentStore implements PersistentStore {
+    private entries;
+    save(entry: MemoryEntry): Promise<void>;
+    search(query: string, opts: SearchOptions): Promise<MemoryEntry[]>;
+    delete(id: string): Promise<void>;
+}
+//# sourceMappingURL=in-memory-store.d.ts.map

package/dist/in-memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-store.d.ts","sourceRoot":"","sources":["../src/in-memory-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEnF,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CAAC,OAAO,CAAkC;IAE3C,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAgBlE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGxC"}

package/dist/in-memory-store.js

@@ -0,0 +1,24 @@
+export class InMemoryPersistentStore {
+    entries = new Map();
+    async save(entry) {
+        this.entries.set(entry.id, entry);
+    }
+    async search(query, opts) {
+        const terms = query.toLowerCase().split(/\s+/);
+        const scored = [];
+        for (const entry of this.entries.values()) {
+            const text = entry.content.toLowerCase();
+            const hits = terms.filter((t) => text.includes(t)).length;
+            if (hits > 0)
+                scored.push({ entry, score: hits / terms.length });
+        }
+        return scored
+            .sort((a, b) => b.score - a.score)
+            .slice(0, opts.limit)
+            .map((s) => s.entry);
+    }
+    async delete(id) {
+        this.entries.delete(id);
+    }
+}
+//# sourceMappingURL=in-memory-store.js.map

package/dist/in-memory-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-store.js","sourceRoot":"","sources":["../src/in-memory-store.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,uBAAuB;IAC1B,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IAEjD,KAAK,CAAC,IAAI,CAAC,KAAkB;QAC3B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,IAAmB;QAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,MAAM,GAA4C,EAAE,CAAC;QAE3D,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACzC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAC1D,IAAI,IAAI,GAAG,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,MAAM;aACV,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;aACjC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC;aACpB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { SlidingWindowLayer } from './layers/sliding-window.js';
+export type { SlidingWindowOpts } from './layers/sliding-window.js';
+export { WorkingMemoryLayer } from './layers/working-memory.js';
+export type { WorkingMemoryOpts } from './layers/working-memory.js';
+export { PersistentLayer } from './layers/persistent.js';
+export { LayeredMemoryManager } from './memory-manager.js';
+export type { LayeredMemoryConfig } from './memory-manager.js';
+export { EstimatorTokenizer } from './estimator-tokenizer.js';
+export { InMemoryPersistentStore } from './in-memory-store.js';
+export { MemoryProvider } from './memory-provider.js';
+export { LLMSummarizer } from './llm-summarizer.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":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,YAAY,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,YAAY,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { SlidingWindowLayer } from './layers/sliding-window.js';
+export { WorkingMemoryLayer } from './layers/working-memory.js';
+export { PersistentLayer } from './layers/persistent.js';
+export { LayeredMemoryManager } from './memory-manager.js';
+export { EstimatorTokenizer } from './estimator-tokenizer.js';
+export { InMemoryPersistentStore } from './in-memory-store.js';
+export { MemoryProvider } from './memory-provider.js';
+export { LLMSummarizer } from './llm-summarizer.js';
+//# 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,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/layers/persistent.d.ts

@@ -0,0 +1,13 @@
+import type { MemoryLayer, MemoryEntry, PersistentStore } from '@loom-node/core';
+export declare class PersistentLayer implements MemoryLayer {
+    readonly name = "L3-persistent";
+    readonly tokenBudget: number;
+    private _currentTokens;
+    private readonly _store;
+    constructor(tokenBudget: number, store: PersistentStore);
+    get currentTokens(): number;
+    store(entry: MemoryEntry): Promise<void>;
+    retrieve(query: string, limit: number): Promise<MemoryEntry[]>;
+    evict(): Promise<MemoryEntry[]>;
+}
+//# sourceMappingURL=persistent.d.ts.map

package/dist/layers/persistent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistent.d.ts","sourceRoot":"","sources":["../../src/layers/persistent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEjF,qBAAa,eAAgB,YAAW,WAAW;IACjD,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAE7B,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe;IAKvD,IAAI,aAAa,IAAI,MAAM,CAE1B;IAEK,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAI9D,KAAK,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;CAGtC"}

package/dist/layers/persistent.js

@@ -0,0 +1,24 @@
+export class PersistentLayer {
+    name = 'L3-persistent';
+    tokenBudget;
+    _currentTokens = 0;
+    _store;
+    constructor(tokenBudget, store) {
+        this.tokenBudget = tokenBudget;
+        this._store = store;
+    }
+    get currentTokens() {
+        return this._currentTokens;
+    }
+    async store(entry) {
+        await this._store.save(entry);
+        this._currentTokens += entry.tokens;
+    }
+    async retrieve(query, limit) {
+        return this._store.search(query, { limit, mode: 'hybrid' });
+    }
+    async evict() {
+        return [];
+    }
+}
+//# sourceMappingURL=persistent.js.map

package/dist/layers/persistent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistent.js","sourceRoot":"","sources":["../../src/layers/persistent.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,eAAe;IACjB,IAAI,GAAG,eAAe,CAAC;IACvB,WAAW,CAAS;IACrB,cAAc,GAAG,CAAC,CAAC;IACV,MAAM,CAAkB;IAEzC,YAAY,WAAmB,EAAE,KAAsB;QACrD,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAkB;QAC5B,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,CAAC,cAAc,IAAI,KAAK,CAAC,MAAM,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,KAAa,EAAE,KAAa;QACzC,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,KAAK;QACT,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/layers/sliding-window.d.ts

@@ -0,0 +1,24 @@
+import type { MemoryLayer, MemoryEntry, MemoryCompressor, Tokenizer } from '@loom-node/core';
+export interface SlidingWindowOpts {
+    compressor?: MemoryCompressor;
+    sink?: MemoryLayer;
+    compressBatch?: number;
+}
+export declare class SlidingWindowLayer implements MemoryLayer {
+    readonly name = "L1-sliding-window";
+    readonly tokenBudget: number;
+    private entries;
+    private _currentTokens;
+    private readonly tokenizer;
+    private readonly compressor?;
+    private readonly sink?;
+    private readonly compressBatch;
+    private evictBuffer;
+    constructor(tokenBudget: number, tokenizer: Tokenizer, opts?: SlidingWindowOpts);
+    get currentTokens(): number;
+    store(entry: MemoryEntry): Promise<void>;
+    retrieve(_query: string, limit: number): Promise<MemoryEntry[]>;
+    evict(): Promise<MemoryEntry[]>;
+    flushBuffer(): Promise<void>;
+}
+//# sourceMappingURL=sliding-window.d.ts.map

package/dist/layers/sliding-window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sliding-window.d.ts","sourceRoot":"","sources":["../../src/layers/sliding-window.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE7F,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,kBAAmB,YAAW,WAAW;IACpD,QAAQ,CAAC,IAAI,uBAAuB;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAmB;IAC/C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,WAAW,CAAqB;gBAE5B,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,iBAAiB;IAQ/E,IAAI,aAAa,IAAI,MAAM,CAE1B;IAEK,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IASxC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAI/D,KAAK,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAc/B,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;CAMnC"}

package/dist/layers/sliding-window.js

@@ -0,0 +1,53 @@
+export class SlidingWindowLayer {
+    name = 'L1-sliding-window';
+    tokenBudget;
+    entries = [];
+    _currentTokens = 0;
+    tokenizer;
+    compressor;
+    sink;
+    compressBatch;
+    evictBuffer = [];
+    constructor(tokenBudget, tokenizer, opts) {
+        this.tokenBudget = tokenBudget;
+        this.tokenizer = tokenizer;
+        this.compressor = opts?.compressor;
+        this.sink = opts?.sink;
+        this.compressBatch = opts?.compressBatch ?? 4;
+    }
+    get currentTokens() {
+        return this._currentTokens;
+    }
+    async store(entry) {
+        entry.tokens = this.tokenizer.count(entry.content);
+        this.entries.push(entry);
+        this._currentTokens += entry.tokens;
+        while (this._currentTokens > this.tokenBudget && this.entries.length > 1) {
+            await this.evict();
+        }
+    }
+    async retrieve(_query, limit) {
+        return this.entries.slice(-limit);
+    }
+    async evict() {
+        const removed = this.entries.shift();
+        if (!removed)
+            return [];
+        this._currentTokens -= removed.tokens;
+        if (this.compressor && this.sink) {
+            this.evictBuffer.push(removed);
+            if (this.evictBuffer.length >= this.compressBatch) {
+                await this.flushBuffer();
+            }
+        }
+        return [removed];
+    }
+    async flushBuffer() {
+        if (!this.compressor || !this.sink || this.evictBuffer.length === 0)
+            return;
+        const batch = this.evictBuffer.splice(0);
+        const compressed = await this.compressor.compress(batch);
+        await this.sink.store(compressed);
+    }
+}
+//# sourceMappingURL=sliding-window.js.map

package/dist/layers/sliding-window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sliding-window.js","sourceRoot":"","sources":["../../src/layers/sliding-window.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,kBAAkB;IACpB,IAAI,GAAG,mBAAmB,CAAC;IAC3B,WAAW,CAAS;IACrB,OAAO,GAAkB,EAAE,CAAC;IAC5B,cAAc,GAAG,CAAC,CAAC;IACV,SAAS,CAAY;IACrB,UAAU,CAAoB;IAC9B,IAAI,CAAe;IACnB,aAAa,CAAS;IAC/B,WAAW,GAAkB,EAAE,CAAC;IAExC,YAAY,WAAmB,EAAE,SAAoB,EAAE,IAAwB;QAC7E,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,IAAI,EAAE,UAAU,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC;QACvB,IAAI,CAAC,aAAa,GAAG,IAAI,EAAE,aAAa,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAkB;QAC5B,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,cAAc,IAAI,KAAK,CAAC,MAAM,CAAC;QACpC,OAAO,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzE,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,KAAa;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrC,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;QAEtC,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACjC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC/B,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBAClD,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;YAC3B,CAAC;QACH,CAAC;QACD,OAAO,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,WAAW;QACf,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC5E,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACzD,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/layers/working-memory.d.ts

@@ -0,0 +1,27 @@
+import type { MemoryLayer, MemoryEntry, MemoryCompressor, ImportanceScorer, Tokenizer } from '@loom-node/core';
+import type { Message } from '@loom-node/core';
+export interface WorkingMemoryOpts {
+    compressor?: MemoryCompressor;
+    sink?: MemoryLayer;
+    compressBatch?: number;
+}
+export declare class WorkingMemoryLayer implements MemoryLayer {
+    readonly name = "L2-working-memory";
+    readonly tokenBudget: number;
+    private entries;
+    private _currentTokens;
+    private readonly tokenizer;
+    private readonly scorer;
+    private readonly compressor?;
+    private readonly sink?;
+    private readonly compressBatch;
+    private evictBuffer;
+    constructor(tokenBudget: number, tokenizer: Tokenizer, scorer: ImportanceScorer, opts?: WorkingMemoryOpts);
+    get currentTokens(): number;
+    store(entry: MemoryEntry): Promise<void>;
+    retrieve(_query: string, limit: number): Promise<MemoryEntry[]>;
+    evict(): Promise<MemoryEntry[]>;
+    flushBuffer(): Promise<void>;
+    rescore(context: Message[]): Promise<void>;
+}
+//# sourceMappingURL=working-memory.d.ts.map

package/dist/layers/working-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"working-memory.d.ts","sourceRoot":"","sources":["../../src/layers/working-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC/G,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,kBAAmB,YAAW,WAAW;IACpD,QAAQ,CAAC,IAAI,uBAAuB;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAmB;IAC/C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,WAAW,CAAqB;gBAE5B,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,iBAAiB;IASzG,IAAI,aAAa,IAAI,MAAM,CAE1B;IAEK,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IASxC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAM/D,KAAK,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAkB/B,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAKjD"}

package/dist/layers/working-memory.js

@@ -0,0 +1,67 @@
+export class WorkingMemoryLayer {
+    name = 'L2-working-memory';
+    tokenBudget;
+    entries = [];
+    _currentTokens = 0;
+    tokenizer;
+    scorer;
+    compressor;
+    sink;
+    compressBatch;
+    evictBuffer = [];
+    constructor(tokenBudget, tokenizer, scorer, opts) {
+        this.tokenBudget = tokenBudget;
+        this.tokenizer = tokenizer;
+        this.scorer = scorer;
+        this.compressor = opts?.compressor;
+        this.sink = opts?.sink;
+        this.compressBatch = opts?.compressBatch ?? 4;
+    }
+    get currentTokens() {
+        return this._currentTokens;
+    }
+    async store(entry) {
+        entry.tokens = this.tokenizer.count(entry.content);
+        this.entries.push(entry);
+        this._currentTokens += entry.tokens;
+        while (this._currentTokens > this.tokenBudget && this.entries.length > 0) {
+            await this.evict();
+        }
+    }
+    async retrieve(_query, limit) {
+        return [...this.entries]
+            .sort((a, b) => b.importance - a.importance)
+            .slice(0, limit);
+    }
+    async evict() {
+        if (this.entries.length === 0)
+            return [];
+        let minIdx = 0;
+        for (let i = 1; i < this.entries.length; i++) {
+            if (this.entries[i].importance < this.entries[minIdx].importance)
+                minIdx = i;
+        }
+        const [removed] = this.entries.splice(minIdx, 1);
+        this._currentTokens -= removed.tokens;
+        if (this.compressor && this.sink) {
+            this.evictBuffer.push(removed);
+            if (this.evictBuffer.length >= this.compressBatch) {
+                await this.flushBuffer();
+            }
+        }
+        return [removed];
+    }
+    async flushBuffer() {
+        if (!this.compressor || !this.sink || this.evictBuffer.length === 0)
+            return;
+        const batch = this.evictBuffer.splice(0);
+        const compressed = await this.compressor.compress(batch);
+        await this.sink.store(compressed);
+    }
+    async rescore(context) {
+        for (const entry of this.entries) {
+            entry.importance = await this.scorer.score(entry, context);
+        }
+    }
+}
+//# sourceMappingURL=working-memory.js.map

package/dist/layers/working-memory.js.map

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

package/dist/llm-summarizer.d.ts

@@ -0,0 +1,8 @@
+import type { MemoryCompressor, MemoryEntry, LLMProvider, Tokenizer } from '@loom-node/core';
+export declare class LLMSummarizer implements MemoryCompressor {
+    private readonly llm;
+    private readonly tokenizer;
+    constructor(llm: LLMProvider, tokenizer: Tokenizer);
+    compress(entries: MemoryEntry[]): Promise<MemoryEntry>;
+}
+//# sourceMappingURL=llm-summarizer.d.ts.map

package/dist/llm-summarizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-summarizer.d.ts","sourceRoot":"","sources":["../src/llm-summarizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAO7F,qBAAa,aAAc,YAAW,gBAAgB;IAElD,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,SAAS;IAGjC,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;CAoB7D"}

package/dist/llm-summarizer.js

@@ -0,0 +1,31 @@
+const COMPRESS_PROMPT = `Summarize the following conversation fragments into a concise summary. Preserve key facts, decisions, and context. Be brief.
+
+Fragments:
+`;
+export class LLMSummarizer {
+    llm;
+    tokenizer;
+    constructor(llm, tokenizer) {
+        this.llm = llm;
+        this.tokenizer = tokenizer;
+    }
+    async compress(entries) {
+        const body = entries.map((e, i) => `[${i + 1}] ${e.content}`).join('\n');
+        const result = await this.llm.complete({
+            messages: [{ role: 'user', content: COMPRESS_PROMPT + body }],
+            temperature: 0,
+            maxTokens: 256,
+        });
+        const content = result.content;
+        const maxImportance = Math.max(...entries.map(e => e.importance));
+        return {
+            id: crypto.randomUUID(),
+            content,
+            tokens: this.tokenizer.count(content),
+            importance: Math.min(1, maxImportance + 0.1),
+            metadata: { compressed: true, sourceCount: entries.length },
+            createdAt: Date.now(),
+        };
+    }
+}
+//# sourceMappingURL=llm-summarizer.js.map

package/dist/llm-summarizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-summarizer.js","sourceRoot":"","sources":["../src/llm-summarizer.ts"],"names":[],"mappings":"AAEA,MAAM,eAAe,GAAG;;;CAGvB,CAAC;AAEF,MAAM,OAAO,aAAa;IAEL;IACA;IAFnB,YACmB,GAAgB,EAChB,SAAoB;QADpB,QAAG,GAAH,GAAG,CAAa;QAChB,cAAS,GAAT,SAAS,CAAW;IACpC,CAAC;IAEJ,KAAK,CAAC,QAAQ,CAAC,OAAsB;QACnC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;YACrC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,EAAE,CAAC;YAC7D,WAAW,EAAE,CAAC;YACd,SAAS,EAAE,GAAG;SACf,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC/B,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QAElE,OAAO;YACL,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;YACvB,OAAO;YACP,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC;YACrC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,GAAG,GAAG,CAAC;YAC5C,QAAQ,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE;YAC3D,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;IACJ,CAAC;CACF"}

package/dist/memory-manager.d.ts

@@ -0,0 +1,19 @@
+import type { MemoryManager, MemoryLayer, MemoryEntry, Message, Tokenizer } from '@loom-node/core';
+export interface LayeredMemoryConfig {
+    layers: MemoryLayer[];
+    tokenizer: Tokenizer;
+    systemPrompt?: string;
+}
+export declare class LayeredMemoryManager implements MemoryManager {
+    private readonly layers;
+    private readonly tokenizer;
+    private readonly systemPrompt?;
+    constructor(config: LayeredMemoryConfig);
+    buildContext(input: string): Promise<Message[]>;
+    persist(messages: Message[]): Promise<void>;
+    /** Extract high-importance memories for a child agent (mitosis) */
+    extractFor(query: string, budget: number): Promise<MemoryEntry[]>;
+    /** Absorb learnings from a child agent back into parent (post-mitosis) */
+    absorb(entries: MemoryEntry[], importanceBoost?: number): Promise<void>;
+}
+//# sourceMappingURL=memory-manager.d.ts.map

package/dist/memory-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-manager.d.ts","sourceRoot":"","sources":["../src/memory-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEnG,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,oBAAqB,YAAW,aAAa;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAS;gBAE3B,MAAM,EAAE,mBAAmB;IAMjC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAgB/C,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBjD,mEAAmE;IAC7D,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAkBvE,0EAA0E;IACpE,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,eAAe,SAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAa3E"}

package/dist/memory-manager.js

@@ -0,0 +1,81 @@
+export class LayeredMemoryManager {
+    layers;
+    tokenizer;
+    systemPrompt;
+    constructor(config) {
+        this.layers = config.layers;
+        this.tokenizer = config.tokenizer;
+        this.systemPrompt = config.systemPrompt;
+    }
+    async buildContext(input) {
+        const msgs = [];
+        if (this.systemPrompt) {
+            msgs.push({ role: 'system', content: this.systemPrompt });
+        }
+        // Retrieve from each layer and merge
+        for (const layer of this.layers) {
+            const entries = await layer.retrieve(input, 10);
+            for (const e of entries) {
+                msgs.push({ role: 'user', content: e.content });
+            }
+        }
+        msgs.push({ role: 'user', content: input });
+        return msgs;
+    }
+    async persist(messages) {
+        for (const msg of messages) {
+            const content = typeof msg.content === 'string' ? msg.content : JSON.stringify(msg.content);
+            const entry = {
+                id: crypto.randomUUID(),
+                content,
+                tokens: this.tokenizer.count(content),
+                importance: 0.5,
+                metadata: { role: msg.role },
+                createdAt: Date.now(),
+            };
+            for (const layer of this.layers) {
+                await layer.store(entry);
+            }
+        }
+        // Rescore layers that support it (e.g. WorkingMemory importance re-evaluation)
+        for (const layer of this.layers) {
+            if (layer.rescore)
+                await layer.rescore(messages);
+        }
+    }
+    /** Extract high-importance memories for a child agent (mitosis) */
+    async extractFor(query, budget) {
+        const all = [];
+        for (const layer of this.layers) {
+            const entries = await layer.retrieve(query, 20);
+            all.push(...entries);
+        }
+        // Sort by importance, pick within budget
+        all.sort((a, b) => b.importance - a.importance);
+        const selected = [];
+        let used = 0;
+        for (const e of all) {
+            if (used + e.tokens > budget)
+                continue;
+            selected.push(e);
+            used += e.tokens;
+        }
+        return selected;
+    }
+    /** Absorb learnings from a child agent back into parent (post-mitosis) */
+    async absorb(entries, importanceBoost = 0.1) {
+        const l2 = this.layers.find(l => l.name.includes('working'));
+        const target = l2 ?? this.layers[0];
+        if (!target)
+            return;
+        for (const e of entries) {
+            await target.store({
+                ...e,
+                id: crypto.randomUUID(),
+                importance: Math.min(1, e.importance + importanceBoost),
+                metadata: { ...e.metadata, absorbed: true },
+            });
+        }
+    }
+}
+//# sourceMappingURL=memory-manager.js.map

package/dist/memory-manager.js.map

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

package/dist/memory-provider.d.ts

@@ -0,0 +1,10 @@
+import type { ContextProvider, ContextFragment, Tokenizer } from '@loom-node/core';
+import type { LayeredMemoryManager } from './memory-manager.js';
+export declare class MemoryProvider implements ContextProvider {
+    private manager;
+    private tokenizer;
+    readonly source: "memory";
+    constructor(manager: LayeredMemoryManager, tokenizer: Tokenizer);
+    provide(query: string, budget: number): Promise<ContextFragment[]>;
+}
+//# sourceMappingURL=memory-provider.d.ts.map

package/dist/memory-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-provider.d.ts","sourceRoot":"","sources":["../src/memory-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACnF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,qBAAa,cAAe,YAAW,eAAe;IAIlD,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,SAAS;IAJnB,QAAQ,CAAC,MAAM,EAAG,QAAQ,CAAU;gBAG1B,OAAO,EAAE,oBAAoB,EAC7B,SAAS,EAAE,SAAS;IAGxB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAoBzE"}

package/dist/memory-provider.js

@@ -0,0 +1,30 @@
+export class MemoryProvider {
+    manager;
+    tokenizer;
+    source = 'memory';
+    constructor(manager, tokenizer) {
+        this.manager = manager;
+        this.tokenizer = tokenizer;
+    }
+    async provide(query, budget) {
+        const messages = await this.manager.buildContext(query);
+        const fragments = [];
+        let used = 0;
+        for (const msg of messages) {
+            const content = typeof msg.content === 'string' ? msg.content : JSON.stringify(msg.content);
+            const tokens = this.tokenizer.count(content);
+            if (used + tokens > budget)
+                break;
+            fragments.push({
+                source: 'memory',
+                content,
+                tokens,
+                relevance: 0.8,
+                metadata: { role: msg.role },
+            });
+            used += tokens;
+        }
+        return fragments;
+    }
+}
+//# sourceMappingURL=memory-provider.js.map

package/dist/memory-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-provider.js","sourceRoot":"","sources":["../src/memory-provider.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,cAAc;IAIf;IACA;IAJD,MAAM,GAAG,QAAiB,CAAC;IAEpC,YACU,OAA6B,EAC7B,SAAoB;QADpB,YAAO,GAAP,OAAO,CAAsB;QAC7B,cAAS,GAAT,SAAS,CAAW;IAC3B,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,MAAc;QACzC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QACxD,MAAM,SAAS,GAAsB,EAAE,CAAC;QACxC,IAAI,IAAI,GAAG,CAAC,CAAC;QAEb,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC5F,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC7C,IAAI,IAAI,GAAG,MAAM,GAAG,MAAM;gBAAE,MAAM;YAClC,SAAS,CAAC,IAAI,CAAC;gBACb,MAAM,EAAE,QAAQ;gBAChB,OAAO;gBACP,MAAM;gBACN,SAAS,EAAE,GAAG;gBACd,QAAQ,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE;aAC7B,CAAC,CAAC;YACH,IAAI,IAAI,MAAM,CAAC;QACjB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@loom-node/memory",
+  "version": "0.1.0",
+  "description": "Three-layer memory system for Loom-Node - sliding window, working memory, persistent",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@loom-node/core": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "rm -rf dist .tsbuildinfo"
+  }
+}