@animalabs/context-manager 0.3.0 → 0.4.0

package/dist/test/non-blocking-compile.test.js

@@ -0,0 +1,114 @@
+/**
+ * Tests for `compile()`'s non-blocking contract + the uncompressed-chunk
+ * fallback that prevents silent message loss.
+ *
+ * Background: commit `3e42e98` dropped the `await readiness.pendingWork`
+ * inside `compile()` to keep turn latency low (compression can take
+ * 30+s; awaiting it per-turn was the wrong tradeoff). The side effect
+ * was that messages caught in a queued-but-not-yet-compressed chunk
+ * would vanish from rendered context in hierarchical mode — no summary
+ * existed yet for the chunk, and `selectHierarchical` only emitted raw
+ * messages from `recentStart` onward.
+ *
+ * The fix (these tests pin in place): `selectHierarchical` now emits
+ * raw messages for any uncompressed chunk that overlaps the middle
+ * region between the head and recent windows, mirroring
+ * `selectLegacy`'s "Uncompressed: emit raw" behavior. Once compression
+ * finishes and the chunk transitions to `compressed: true`, the raw
+ * emission stops (the chunk is now covered by an L1 summary), so
+ * there's no double-counting across the transition.
+ */
+import { describe, it, before, after, beforeEach } from 'node:test';
+import assert from 'node:assert';
+import { rmSync, existsSync } from 'node:fs';
+import { ContextManager, AutobiographicalStrategy } from '../src/index.js';
+const TEST_STORE_PATH = './test-non-blocking-compile';
+function cleanup() {
+    if (existsSync(TEST_STORE_PATH)) {
+        rmSync(TEST_STORE_PATH, { recursive: true, force: true });
+    }
+}
+function textBlock(text) {
+    return [{ type: 'text', text }];
+}
+function compiledHas(compiled, fragment) {
+    for (const m of compiled.messages) {
+        for (const block of m.content) {
+            if (block.type === 'text' && block.text.includes(fragment))
+                return true;
+        }
+    }
+    return false;
+}
+describe('AutobiographicalStrategy — non-blocking compile + uncompressed-chunk fallback', () => {
+    before(cleanup);
+    after(cleanup);
+    beforeEach(cleanup);
+    it('emits raw messages for uncompressed chunks in the middle region (no silent drop)', async () => {
+        // Configure for a small middle region:
+        //  - No head window (so all messages compete for visibility via the
+        //    summary path and the recent window).
+        //  - Small recentWindowTokens so older messages fall out of recent.
+        //  - Small targetChunkTokens so a single old message ends up in
+        //    its own chunk.
+        //  - Hierarchical mode so `selectHierarchical` is the codepath
+        //    under test (selectLegacy already had this fallback).
+        const strategy = new AutobiographicalStrategy({
+            headWindowTokens: 0,
+            recentWindowTokens: 12,
+            targetChunkTokens: 4,
+            hierarchical: true,
+        });
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+        });
+        // Three "old" messages whose chunks will be queued but un-ticked,
+        // plus a "latest" big enough to dominate the small recent window.
+        manager.addMessage('user', textBlock('ANCIENT_MARKER_1'));
+        manager.addMessage('user', textBlock('ANCIENT_MARKER_2'));
+        manager.addMessage('user', textBlock('ANCIENT_MARKER_3'));
+        manager.addMessage('user', textBlock('LATEST ' + 'X'.repeat(80)));
+        // Critically: we do NOT call manager.tick(). The chunks for the
+        // ancient messages exist in the strategy's compression queue but
+        // never run through executeMerge/compressChunk, so they stay
+        // `chunk.compressed === false`. This is the exact state where the
+        // bug used to silently drop messages.
+        const compiled = await manager.compile({
+            maxTokens: 100_000,
+            reserveForResponse: 0,
+        });
+        assert.ok(compiledHas(compiled, 'ANCIENT_MARKER_1'), 'ANCIENT_MARKER_1 must appear in compiled output (uncompressed-chunk fallback)');
+        assert.ok(compiledHas(compiled, 'ANCIENT_MARKER_2'), 'ANCIENT_MARKER_2 must appear in compiled output');
+        assert.ok(compiledHas(compiled, 'ANCIENT_MARKER_3'), 'ANCIENT_MARKER_3 must appear in compiled output');
+        // The recent message must of course still be there.
+        assert.ok(compiledHas(compiled, 'LATEST'), 'LATEST message must appear in compiled output');
+        manager.close();
+    });
+    it('compile() returns promptly without awaiting pending compression', async () => {
+        // Sanity check on the freshness contract change: compile() must
+        // not block on `pendingCompression`. We can't easily inject a slow
+        // mock LLM here, but we *can* assert that compile() completes
+        // before any tick would have time to finish.
+        const strategy = new AutobiographicalStrategy({
+            headWindowTokens: 0,
+            recentWindowTokens: 12,
+            targetChunkTokens: 4,
+            hierarchical: true,
+        });
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+        });
+        manager.addMessage('user', textBlock('older'));
+        manager.addMessage('user', textBlock('latest ' + 'Y'.repeat(80)));
+        const t0 = Date.now();
+        await manager.compile({ maxTokens: 100_000, reserveForResponse: 0 });
+        const elapsed = Date.now() - t0;
+        // No LLM, no real awaiting — compile should be effectively instant.
+        // 500ms is wildly generous; the actual time is sub-10ms in practice.
+        assert.ok(elapsed < 500, `compile() should return promptly; took ${elapsed}ms`);
+        manager.close();
+    });
+});
+//# sourceMappingURL=non-blocking-compile.test.js.map

package/dist/test/non-blocking-compile.test.js.map

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

package/dist/test/pins.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Tests for pins / documents / protected ranges (audit gap #3).
+ *
+ * Pinned messages are excluded from compression and render raw at their
+ * original chronological position. Marks survive process restart and follow
+ * Chronicle branches (state is persisted as a snapshot under
+ * `${ns}/autobio:pins`).
+ */
+export {};
+//# sourceMappingURL=pins.test.d.ts.map

package/dist/test/pins.test.d.ts.map

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

package/dist/test/pins.test.js

@@ -0,0 +1,164 @@
+/**
+ * Tests for pins / documents / protected ranges (audit gap #3).
+ *
+ * Pinned messages are excluded from compression and render raw at their
+ * original chronological position. Marks survive process restart and follow
+ * Chronicle branches (state is persisted as a snapshot under
+ * `${ns}/autobio:pins`).
+ */
+import { describe, it, before, after, beforeEach } from 'node:test';
+import assert from 'node:assert';
+import { rmSync, existsSync } from 'node:fs';
+import { ContextManager, AutobiographicalStrategy } from '../src/index.js';
+const TEST_STORE_PATH = './test-pins';
+function cleanup() {
+    if (existsSync(TEST_STORE_PATH)) {
+        rmSync(TEST_STORE_PATH, { recursive: true, force: true });
+    }
+}
+function textBlock(text) {
+    return [{ type: 'text', text }];
+}
+class TestableStrategy extends AutobiographicalStrategy {
+    seedL1Against(content, firstMsgId, lastMsgId) {
+        const entry = {
+            id: `L1-${this.nextSummaryIdCounter()}`,
+            level: 1,
+            content,
+            tokens: Math.ceil(content.length / 4),
+            sourceLevel: 0,
+            sourceIds: [firstMsgId, lastMsgId],
+            sourceRange: { first: firstMsgId, last: lastMsgId },
+            created: Date.now(),
+        };
+        this.pushSummary(entry);
+        return entry;
+    }
+    // Expose the protected getter for assertions
+    exposeCompressibleIds(store) {
+        return this.getCompressibleMessages(store).map((m) => m.id);
+    }
+}
+describe('AutobiographicalStrategy — pins / documents (gap #3)', () => {
+    before(cleanup);
+    after(cleanup);
+    beforeEach(cleanup);
+    it('pinned messages are excluded from the compressible set', async () => {
+        const strategy = new TestableStrategy({ headWindowTokens: 0, recentWindowTokens: 5 });
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+        });
+        const m1 = manager.addMessage('user', textBlock('one'));
+        const m2 = manager.addMessage('user', textBlock('two'));
+        const m3 = manager.addMessage('user', textBlock('three'));
+        manager.addMessage('user', textBlock('latest ' + 'X'.repeat(50)));
+        // Without any pins, all old messages are compressible.
+        const beforePin = strategy.exposeCompressibleIds(manager.messageStore.createView());
+        assert.ok(beforePin.includes(m2), 'm2 should be compressible before pin');
+        manager.pinRange(m2, m2);
+        const afterPin = strategy.exposeCompressibleIds(manager.messageStore.createView());
+        assert.ok(!afterPin.includes(m2), 'm2 must NOT be compressible after pin');
+        assert.ok(afterPin.includes(m1), 'm1 still compressible');
+        assert.ok(afterPin.includes(m3), 'm3 still compressible');
+        manager.close();
+    });
+    it('renders pinned messages raw at their chronological position', async () => {
+        const strategy = new TestableStrategy({ headWindowTokens: 0, recentWindowTokens: 5 });
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+        });
+        const m1 = manager.addMessage('user', textBlock('alpha'));
+        const m2 = manager.addMessage('user', textBlock('PINNED-DOCUMENT-CONTENT'));
+        const m3 = manager.addMessage('user', textBlock('gamma'));
+        manager.addMessage('user', textBlock('latest ' + 'X'.repeat(50)));
+        // Seed summaries that cover m1 and m3 (NOT m2 — m2 is pinned).
+        strategy.seedL1Against('summary about alpha', m1, m1);
+        strategy.seedL1Against('summary about gamma', m3, m3);
+        manager.markDocument(m2, { name: 'big-doc' });
+        const compiled = await manager.compile({ maxTokens: 100_000, reserveForResponse: 0 });
+        const allTexts = compiled.messages.map(m => m.content.filter(c => c.type === 'text').map(c => c.text).join('|'));
+        // The pinned message's full content should be rendered raw, not via a summary.
+        const pinIdx = allTexts.findIndex(t => t.includes('PINNED-DOCUMENT-CONTENT'));
+        assert.ok(pinIdx >= 0, 'pinned message text should be visible verbatim in output');
+        // The two summaries should also be present.
+        const alphaIdx = allTexts.findIndex(t => t.includes('summary about alpha'));
+        const gammaIdx = allTexts.findIndex(t => t.includes('summary about gamma'));
+        assert.ok(alphaIdx >= 0, 'alpha summary should appear');
+        assert.ok(gammaIdx >= 0, 'gamma summary should appear');
+        // Chronological order: alpha summary < pinned m2 < gamma summary
+        assert.ok(alphaIdx < pinIdx, `alpha summary should come before pinned m2 (alpha=${alphaIdx} pin=${pinIdx})`);
+        assert.ok(pinIdx < gammaIdx, `pinned m2 should come before gamma summary (pin=${pinIdx} gamma=${gammaIdx})`);
+        manager.close();
+    });
+    it('persists pins across close/reopen', async () => {
+        let pinId;
+        {
+            const strategy = new TestableStrategy({ headWindowTokens: 0, recentWindowTokens: 5 });
+            const manager = await ContextManager.open({
+                path: TEST_STORE_PATH,
+                strategy,
+            });
+            const m1 = manager.addMessage('user', textBlock('survive me'));
+            manager.addMessage('user', textBlock('latest'));
+            pinId = manager.pinRange(m1, m1, { name: 'first-test-pin' });
+            assert.equal(manager.listPins().length, 1);
+            manager.sync();
+            manager.close();
+        }
+        {
+            const strategy = new TestableStrategy({ headWindowTokens: 0, recentWindowTokens: 5 });
+            const manager = await ContextManager.open({
+                path: TEST_STORE_PATH,
+                strategy,
+            });
+            const pins = manager.listPins();
+            assert.equal(pins.length, 1, 'pin should reload from chronicle');
+            assert.equal(pins[0].id, pinId);
+            assert.equal(pins[0].name, 'first-test-pin');
+            manager.close();
+        }
+    });
+    it('unpin removes the protection and persists', async () => {
+        const strategy = new TestableStrategy({ headWindowTokens: 0, recentWindowTokens: 5 });
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+        });
+        const m1 = manager.addMessage('user', textBlock('toggle me'));
+        manager.addMessage('user', textBlock('latest'));
+        const pinId = manager.pinRange(m1, m1);
+        assert.equal(manager.listPins().length, 1);
+        const removed = manager.unpin(pinId);
+        assert.equal(removed, true);
+        assert.equal(manager.listPins().length, 0);
+        // Re-unpinning is a no-op (returns false)
+        assert.equal(manager.unpin(pinId), false);
+        manager.close();
+    });
+    it('multiple pins isolate per Chronicle branch (via fork)', async () => {
+        const strategy = new TestableStrategy({ headWindowTokens: 0, recentWindowTokens: 5 });
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+        });
+        const m1 = manager.addMessage('user', textBlock('shared'));
+        manager.addMessage('user', textBlock('latest'));
+        const sharedPin = manager.pinRange(m1, m1, { name: 'shared' });
+        const mainBranch = manager.currentBranch().name;
+        await manager.fork('experimental');
+        // Adding a pin only on the experimental branch
+        const m2 = manager.addMessage('user', textBlock('only on fork'));
+        manager.addMessage('user', textBlock('latest 2'));
+        const forkPin = manager.pinRange(m2, m2, { name: 'fork-only' });
+        assert.equal(manager.listPins().length, 2, 'fork should have shared + fork-only pin');
+        await manager.switchBranch(mainBranch);
+        const mainPins = manager.listPins();
+        assert.equal(mainPins.length, 1, 'main should only have the shared pin');
+        assert.equal(mainPins[0].id, sharedPin);
+        assert.ok(!mainPins.some(p => p.id === forkPin), 'main must NOT see the fork-only pin');
+        manager.close();
+    });
+});
+//# sourceMappingURL=pins.test.js.map

package/dist/test/pins.test.js.map

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

package/dist/test/recall-positioning.test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tests for per-region recall pair emission (audit gap #2).
+ *
+ * Pre-fix, AutobiographicalStrategy concatenated ALL selected summaries with
+ * `\n\n---\n\n` separators into ONE Q/A pair placed between the head window
+ * and the recent window. Per the spec audit, this is the structural
+ * equivalent of Lena's dual-recall corruption pattern from Hermes: the agent
+ * sees memories as a wall of summaries from another speaker, with no
+ * positional or temporal coherence per individual summary.
+ *
+ * Post-fix, each selected summary emits as its own Q/A recall pair, sorted
+ * chronologically by source-range position. The legacy combined-pair shape
+ * is still available via `positionedRecallPairs: false`.
+ */
+export {};
+//# sourceMappingURL=recall-positioning.test.d.ts.map

package/dist/test/recall-positioning.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall-positioning.test.d.ts","sourceRoot":"","sources":["../../test/recall-positioning.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/test/recall-positioning.test.js

@@ -0,0 +1,181 @@
+/**
+ * Tests for per-region recall pair emission (audit gap #2).
+ *
+ * Pre-fix, AutobiographicalStrategy concatenated ALL selected summaries with
+ * `\n\n---\n\n` separators into ONE Q/A pair placed between the head window
+ * and the recent window. Per the spec audit, this is the structural
+ * equivalent of Lena's dual-recall corruption pattern from Hermes: the agent
+ * sees memories as a wall of summaries from another speaker, with no
+ * positional or temporal coherence per individual summary.
+ *
+ * Post-fix, each selected summary emits as its own Q/A recall pair, sorted
+ * chronologically by source-range position. The legacy combined-pair shape
+ * is still available via `positionedRecallPairs: false`.
+ */
+import { describe, it, before, after, beforeEach } from 'node:test';
+import assert from 'node:assert';
+import { rmSync, existsSync } from 'node:fs';
+import { ContextManager, AutobiographicalStrategy } from '../src/index.js';
+const TEST_STORE_PATH = './test-recall-positioning';
+function cleanup() {
+    if (existsSync(TEST_STORE_PATH)) {
+        rmSync(TEST_STORE_PATH, { recursive: true, force: true });
+    }
+}
+function textBlock(text) {
+    return [{ type: 'text', text }];
+}
+class TestableStrategy extends AutobiographicalStrategy {
+    /** Seed an L1 against a specific source-message id. */
+    seedL1Against(content, firstMsgId, lastMsgId) {
+        const entry = {
+            id: `L1-${this.nextSummaryIdCounter()}`,
+            level: 1,
+            content,
+            tokens: Math.ceil(content.length / 4),
+            sourceLevel: 0,
+            sourceIds: [firstMsgId, lastMsgId],
+            sourceRange: { first: firstMsgId, last: lastMsgId },
+            created: Date.now(),
+        };
+        this.pushSummary(entry);
+        return entry;
+    }
+}
+function recallEntries(messages) {
+    const pairs = [];
+    for (let i = 0; i < messages.length - 1; i++) {
+        const a = messages[i];
+        const b = messages[i + 1];
+        if (a.participant === 'Context Manager') {
+            const q = a.content.map(c => (c.type === 'text' ? c.text : '')).join('');
+            const ans = b.content.map(c => (c.type === 'text' ? c.text : '')).join('');
+            pairs.push({ q, a: ans });
+        }
+    }
+    return pairs;
+}
+describe('AutobiographicalStrategy — per-region recall pairs (gap #2)', () => {
+    before(cleanup);
+    after(cleanup);
+    beforeEach(cleanup);
+    it('emits one Q/A pair per selected summary, in chronological order', async () => {
+        // recentWindowTokens deliberately small so the three "old" messages we
+        // seed summaries against fall OUTSIDE the recent window — otherwise
+        // anti-redundancy (correctly) hides summaries about messages that are
+        // already shown verbatim in the recent window.
+        const strategy = new TestableStrategy({
+            headWindowTokens: 0,
+            recentWindowTokens: 8,
+        });
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+        });
+        // Three "old" messages whose summaries we'll test, plus one message
+        // big enough to dominate the recent window so the older three fall out.
+        const m1 = manager.addMessage('user', textBlock('first'));
+        const m2 = manager.addMessage('user', textBlock('second'));
+        const m3 = manager.addMessage('user', textBlock('third'));
+        manager.addMessage('user', textBlock('latest message ' + 'X'.repeat(50)));
+        // Seed three summaries. Seed in the *opposite* order from chronological
+        // so we can verify the strategy sorts them by source position rather
+        // than by creation order.
+        strategy.seedL1Against('summary about THIRD', m3, m3);
+        strategy.seedL1Against('summary about FIRST', m1, m1);
+        strategy.seedL1Against('summary about SECOND', m2, m2);
+        const compiled = await manager.compile({ maxTokens: 100_000, reserveForResponse: 0 });
+        const pairs = recallEntries(compiled.messages);
+        assert.equal(pairs.length, 3, 'should emit 3 distinct recall pairs');
+        // Order should follow source position (m1 < m2 < m3), not seed order.
+        assert.match(pairs[0].a, /FIRST/, 'first pair must cover m1');
+        assert.match(pairs[1].a, /SECOND/, 'second pair must cover m2');
+        assert.match(pairs[2].a, /THIRD/, 'third pair must cover m3');
+        // No --- separators (the legacy concat-marker should be gone).
+        for (const p of pairs) {
+            assert.ok(!p.a.includes('---'), `pair ${p.q} unexpectedly contains '---' separator`);
+        }
+        manager.close();
+    });
+    it('renders the recall header template with summary id by default', async () => {
+        const strategy = new TestableStrategy({
+            headWindowTokens: 0,
+            recentWindowTokens: 8,
+        });
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+        });
+        const m1 = manager.addMessage('user', textBlock('foo'));
+        manager.addMessage('user', textBlock('latest ' + 'X'.repeat(50)));
+        const seeded = strategy.seedL1Against('content', m1, m1);
+        const compiled = await manager.compile({ maxTokens: 100_000, reserveForResponse: 0 });
+        const pairs = recallEntries(compiled.messages);
+        assert.equal(pairs.length, 1);
+        assert.equal(pairs[0].q, `[Recall ${seeded.id}]`, 'default template should be [Recall {id}]');
+    });
+    it('honors a custom recall header template with all substitutions', async () => {
+        const strategy = new TestableStrategy({
+            headWindowTokens: 0,
+            recentWindowTokens: 8,
+            recallHeaderTemplate: 'memory {id} (L{level}) covering {first}..{last}',
+        });
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+        });
+        const m1 = manager.addMessage('user', textBlock('foo'));
+        const m2 = manager.addMessage('user', textBlock('bar'));
+        manager.addMessage('user', textBlock('latest ' + 'X'.repeat(50)));
+        const seeded = strategy.seedL1Against('content', m1, m2);
+        const compiled = await manager.compile({ maxTokens: 100_000, reserveForResponse: 0 });
+        const pairs = recallEntries(compiled.messages);
+        assert.equal(pairs[0].q, `memory ${seeded.id} (L1) covering ${m1}..${m2}`);
+    });
+    it('reverts to combined single-pair shape when positionedRecallPairs is false', async () => {
+        const strategy = new TestableStrategy({
+            headWindowTokens: 0,
+            recentWindowTokens: 8,
+            positionedRecallPairs: false,
+        });
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+        });
+        const m1 = manager.addMessage('user', textBlock('a'));
+        const m2 = manager.addMessage('user', textBlock('b'));
+        const m3 = manager.addMessage('user', textBlock('c'));
+        manager.addMessage('user', textBlock('latest ' + 'X'.repeat(50)));
+        strategy.seedL1Against('A', m1, m1);
+        strategy.seedL1Against('B', m2, m2);
+        strategy.seedL1Against('C', m3, m3);
+        const compiled = await manager.compile({ maxTokens: 100_000, reserveForResponse: 0 });
+        const pairs = recallEntries(compiled.messages);
+        assert.equal(pairs.length, 1, 'legacy mode should emit a single combined pair');
+        assert.equal(pairs[0].q, 'What do you remember from earlier?');
+        assert.match(pairs[0].a, /A\n\n---\n\nB\n\n---\n\nC/);
+    });
+    it('stops emitting pairs when overall budget would be exceeded', async () => {
+        const strategy = new TestableStrategy({
+            headWindowTokens: 0,
+            recentWindowTokens: 8,
+        });
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+        });
+        const m1 = manager.addMessage('user', textBlock('a'));
+        const m2 = manager.addMessage('user', textBlock('b'));
+        const m3 = manager.addMessage('user', textBlock('c'));
+        manager.addMessage('user', textBlock('latest ' + 'X'.repeat(50)));
+        // Each summary is ~400 chars (~100 tokens). Three pairs ≈ 300+ tokens of recall.
+        const big = 'X'.repeat(400);
+        strategy.seedL1Against(big + ' first', m1, m1);
+        strategy.seedL1Against(big + ' second', m2, m2);
+        strategy.seedL1Against(big + ' third', m3, m3);
+        const compiled = await manager.compile({ maxTokens: 250, reserveForResponse: 0 });
+        const pairs = recallEntries(compiled.messages);
+        assert.ok(pairs.length > 0 && pairs.length < 3, `expected partial recall emission under tight budget, got ${pairs.length}`);
+    });
+});
+//# sourceMappingURL=recall-positioning.test.js.map

package/dist/test/recall-positioning.test.js.map

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

package/dist/test/search.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Tests for the search API (audit gap #7).
+ *
+ * Substring + regex search over summary content, plus single-summary
+ * lookup by id. Exposed through ContextManager passthrough so callers
+ * (e.g. agent-framework MCPL host) can build `memory_search` /
+ * `memory_read` agent tools on top.
+ */
+export {};
+//# sourceMappingURL=search.test.d.ts.map

package/dist/test/search.test.d.ts.map

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