@animalabs/context-manager 0.4.0 → 0.5.0

package/dist/test/adaptive/harness.js

@@ -0,0 +1,263 @@
+/**
+ * Synthetic test harness for the adaptive-resolution picker.
+ *
+ * Builds a minimal in-memory chronicle simulator with:
+ *  - Chunks (PickerChunk shape) with deterministic token counts.
+ *  - A mocked LLM that produces deterministic "summaries" by hashing input.
+ *  - A summary tree that grows as the LLM is called.
+ *  - A function to run the picker against a built state.
+ *
+ * The mock LLM doesn't actually call any API — it constructs fake summary
+ * content so we can validate picker logic, fold semantics, and cache stickiness
+ * without external dependencies.
+ */
+/**
+ * Default tokens per recall pair, regardless of source level.
+ * The design specifies that L_k summaries target a constant size (~2K tokens
+ * by convention) so each level's recall pair has predictable footprint.
+ */
+export const DEFAULT_RECALL_PAIR_TOKENS = 200;
+/** Default group size: how many L_k items combine into one L_{k+1}. */
+export const DEFAULT_MERGE_THRESHOLD = 6;
+/**
+ * Mutable in-memory chronicle. Mirrors what the real strategy would manage
+ * but trimmed to just what the picker needs.
+ */
+export class MockChronicle {
+    chunks = [];
+    summaries = new Map();
+    recallPairTokens = new Map();
+    summaryCounter = new Map(); // level -> next id
+    mergeThreshold;
+    defaultRecallPairTokens;
+    /** Mock LLM call count, for telemetry assertions. */
+    llmCalls = 0;
+    constructor(opts = {}) {
+        this.mergeThreshold = opts.mergeThreshold ?? DEFAULT_MERGE_THRESHOLD;
+        this.defaultRecallPairTokens = opts.recallPairTokens ?? DEFAULT_RECALL_PAIR_TOKENS;
+    }
+    /**
+     * Add a chunk to the chronicle (e.g., a chat message or a doc shard).
+     *
+     * @returns the created PickerChunk
+     */
+    addChunk(opts) {
+        const chunk = {
+            id: opts.id,
+            sequence: this.chunks.length,
+            rawTokens: opts.rawTokens,
+            currentResolution: 0,
+            lockedByAgent: opts.lockedByAgent ?? false,
+            bodyGroupId: opts.bodyGroupId,
+            pinned: opts.pinned ?? false,
+        };
+        this.chunks.push(chunk);
+        return chunk;
+    }
+    /**
+     * Produce an L1 summary for a range of chunks. Mocks the LLM call.
+     * Idempotent: the same chunk range produces the same summary id.
+     *
+     * @returns the produced SummaryEntry (or the existing one if already produced)
+     */
+    produceL1(chunkIds) {
+        const sortedIds = [...chunkIds].sort();
+        const sourceKey = `L1:${sortedIds.join(',')}`;
+        // Idempotency check
+        for (const existing of this.summaries.values()) {
+            if (existing.level === 1 && summaryKey(existing) === sourceKey) {
+                return existing;
+            }
+        }
+        const id = this.allocSummaryId(1);
+        const entry = {
+            id,
+            level: 1,
+            content: `[mock L1 summary covering ${chunkIds.length} chunks: ${chunkIds.join(', ')}]`,
+            tokens: this.defaultRecallPairTokens,
+            sourceLevel: 0,
+            sourceIds: [...chunkIds],
+            sourceRange: { first: chunkIds[0], last: chunkIds[chunkIds.length - 1] },
+            created: Date.now(),
+        };
+        this.summaries.set(id, entry);
+        this.recallPairTokens.set(id, this.defaultRecallPairTokens);
+        this.linkChunksToL1(chunkIds, id);
+        this.llmCalls++;
+        return entry;
+    }
+    /**
+     * Produce an L_{k+1} summary from N L_k summaries.
+     */
+    produceUpper(level, sourceSummaryIds) {
+        if (level < 2) {
+            throw new Error('produceUpper requires level >= 2; use produceL1 for level 1');
+        }
+        const sortedIds = [...sourceSummaryIds].sort();
+        const sourceKey = `L${level}:${sortedIds.join(',')}`;
+        for (const existing of this.summaries.values()) {
+            if (existing.level === level && summaryKey(existing) === sourceKey) {
+                return existing;
+            }
+        }
+        const sources = sourceSummaryIds.map((sid) => {
+            const s = this.summaries.get(sid);
+            if (!s)
+                throw new Error(`produceUpper: unknown source summary ${sid}`);
+            if (s.level !== level - 1) {
+                throw new Error(`produceUpper: source ${sid} is level ${s.level}, expected ${level - 1}`);
+            }
+            return s;
+        });
+        const id = this.allocSummaryId(level);
+        const entry = {
+            id,
+            level,
+            content: `[mock L${level} summary merging ${sourceSummaryIds.length} L${level - 1}s]`,
+            tokens: this.defaultRecallPairTokens,
+            sourceLevel: level - 1,
+            sourceIds: [...sourceSummaryIds],
+            sourceRange: {
+                first: sources[0].sourceRange.first,
+                last: sources[sources.length - 1].sourceRange.last,
+            },
+            created: Date.now(),
+        };
+        this.summaries.set(id, entry);
+        this.recallPairTokens.set(id, this.defaultRecallPairTokens);
+        for (const sid of sourceSummaryIds) {
+            const s = this.summaries.get(sid);
+            s.parentId = id;
+        }
+        this.llmCalls++;
+        return entry;
+    }
+    /**
+     * Speculative pre-producer: when N siblings exist sharing the same potential
+     * parent at level k+1, eagerly produce L_{k+1}. Bottom-up, idempotent.
+     * Mirrors the design's background pre-producer (§7 #2 settled decisions).
+     */
+    preProduceUpperLevels() {
+        let changed = true;
+        while (changed) {
+            changed = false;
+            // Find the deepest existing level
+            let maxLevel = 0;
+            for (const s of this.summaries.values())
+                maxLevel = Math.max(maxLevel, s.level);
+            for (let level = 1; level <= maxLevel; level++) {
+                // Group orphaned (parentId === undefined) summaries at this level
+                // by their position in source order. Take consecutive groups of
+                // mergeThreshold and produce the L_{k+1} parent.
+                const orphans = [];
+                for (const s of this.summaries.values()) {
+                    if (s.level === level && !s.parentId)
+                        orphans.push(s);
+                }
+                // Sort by sequence of the first chunk in their source range.
+                orphans.sort((a, b) => this.firstChunkSeq(a) - this.firstChunkSeq(b));
+                while (orphans.length >= this.mergeThreshold) {
+                    const group = orphans.splice(0, this.mergeThreshold);
+                    this.produceUpper(level + 1, group.map((s) => s.id));
+                    changed = true;
+                }
+            }
+        }
+    }
+    /**
+     * Build a head/tail bookkeeping from chunk indices.
+     */
+    computeHeadTail(opts) {
+        const headIds = new Set();
+        const tailIds = new Set();
+        let used = 0;
+        for (let i = 0; i < this.chunks.length; i++) {
+            const c = this.chunks[i];
+            if (used + c.rawTokens > opts.headTokens)
+                break;
+            headIds.add(c.id);
+            used += c.rawTokens;
+        }
+        used = 0;
+        for (let i = this.chunks.length - 1; i >= 0; i--) {
+            const c = this.chunks[i];
+            if (used + c.rawTokens > opts.tailTokens && tailIds.size > 0)
+                break;
+            tailIds.add(c.id);
+            used += c.rawTokens;
+            if (used >= opts.tailTokens)
+                break;
+        }
+        return {
+            headTokens: this.sumTokens(headIds),
+            tailTokens: this.sumTokens(tailIds),
+            headChunkIds: headIds,
+            tailChunkIds: tailIds,
+        };
+    }
+    /**
+     * Apply a snapshot of resolutions back onto the chunks (used after running
+     * the picker to commit the new state for subsequent turns).
+     */
+    applyResolutions(resolutions) {
+        for (const c of this.chunks) {
+            const r = resolutions.get(c.id);
+            if (r !== undefined && r !== c.currentResolution) {
+                c.currentResolution = r;
+            }
+        }
+    }
+    linkChunksToL1(chunkIds, l1Id) {
+        const idSet = new Set(chunkIds);
+        for (const c of this.chunks) {
+            if (idSet.has(c.id))
+                c.l1Id = l1Id;
+        }
+    }
+    allocSummaryId(level) {
+        const n = (this.summaryCounter.get(level) ?? 0);
+        this.summaryCounter.set(level, n + 1);
+        return `L${level}-${n}`;
+    }
+    firstChunkSeq(s) {
+        const c = this.chunks.find((ch) => ch.id === s.sourceRange.first);
+        return c?.sequence ?? 0;
+    }
+    sumTokens(ids) {
+        let t = 0;
+        for (const c of this.chunks)
+            if (ids.has(c.id))
+                t += c.rawTokens;
+        return t;
+    }
+}
+function summaryKey(s) {
+    return `L${s.level}:${[...s.sourceIds].sort().join(',')}`;
+}
+/**
+ * Convenience: build N chunks with uniform token size, then auto-produce
+ * the full summary chain (L1, L2, …) bottom-up via the mergeThreshold rule.
+ *
+ * Returns the populated MockChronicle.
+ */
+export function buildChronicleWithChain(opts) {
+    const chronicle = new MockChronicle({
+        mergeThreshold: opts.mergeThreshold,
+        recallPairTokens: opts.recallPairTokens,
+    });
+    for (let i = 0; i < opts.chunkCount; i++) {
+        chronicle.addChunk({ id: `c-${i.toString().padStart(4, '0')}`, rawTokens: opts.tokensPerChunk });
+    }
+    if (opts.produceChain ?? true) {
+        // Produce L1s in batches of mergeThreshold (one L1 per batch).
+        const threshold = chronicle.mergeThreshold;
+        for (let i = 0; i < chronicle.chunks.length; i += threshold) {
+            const group = chronicle.chunks.slice(i, i + threshold).map((c) => c.id);
+            chronicle.produceL1(group);
+        }
+        // Bottom-up pre-produce L2, L3, …
+        chronicle.preProduceUpperLevels();
+    }
+    return chronicle;
+}
+//# sourceMappingURL=harness.js.map

package/dist/test/adaptive/harness.js.map

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

package/dist/test/adaptive/ingestion.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * End-to-end test of ingestion-time chunking + adaptive picker.
+ *
+ * Verifies that:
+ *   - A large message is automatically chunked into shards at ingestion
+ *   - Shards are stored with shared bodyGroupId
+ *   - The picker folds shards under budget pressure
+ *   - The render path produces ONE combined entry for the whole doc, with
+ *     inline summary text replacing folded shards
+ *   - Byte-faithful reassembly when no folding has happened
+ */
+export {};
+//# sourceMappingURL=ingestion.test.d.ts.map

package/dist/test/adaptive/ingestion.test.d.ts.map

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

package/dist/test/adaptive/ingestion.test.js

@@ -0,0 +1,306 @@
+/**
+ * End-to-end test of ingestion-time chunking + adaptive picker.
+ *
+ * Verifies that:
+ *   - A large message is automatically chunked into shards at ingestion
+ *   - Shards are stored with shared bodyGroupId
+ *   - The picker folds shards under budget pressure
+ *   - The render path produces ONE combined entry for the whole doc, with
+ *     inline summary text replacing folded shards
+ *   - Byte-faithful reassembly when no folding has happened
+ */
+import { describe, it, before, after, beforeEach } from 'node:test';
+import assert from 'node:assert/strict';
+import { rmSync, existsSync } from 'node:fs';
+import { ContextManager, AutobiographicalStrategy } from '../../src/index.js';
+const TEST_STORE_PATH = './test-adaptive-ingestion-store';
+function cleanup() {
+    if (existsSync(TEST_STORE_PATH)) {
+        rmSync(TEST_STORE_PATH, { recursive: true, force: true });
+    }
+}
+function makeMockMembrane() {
+    let callCount = 0;
+    return {
+        complete: async () => {
+            callCount++;
+            return {
+                content: [{ type: 'text', text: `[mock summary #${callCount}]` }],
+            };
+        },
+        get callCount() {
+            return callCount;
+        },
+    };
+}
+describe('AutobiographicalStrategy — ingestion-time chunking', () => {
+    before(() => cleanup());
+    after(() => cleanup());
+    beforeEach(() => cleanup());
+    it('flag off: large messages stay as one StoredMessage (no chunking)', async () => {
+        const mock = makeMockMembrane();
+        const strategy = new AutobiographicalStrategy({
+            adaptiveResolution: false,
+            targetChunkTokens: 100,
+        });
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+            membrane: mock,
+        });
+        // 50K chars ≈ 12.5K tokens; well over the chunker threshold.
+        const bigBody = 'paragraph. '.repeat(5000);
+        manager.addMessage('User', [{ type: 'text', text: bigBody }]);
+        const all = manager.getAllMessages();
+        assert.equal(all.length, 1, 'flag off: should be exactly one stored message');
+        assert.equal(all[0].bodyGroupId, undefined);
+        manager.close();
+    });
+    it('flag on: large messages are sharded into multiple StoredMessages', async () => {
+        const mock = makeMockMembrane();
+        const strategy = new AutobiographicalStrategy({
+            adaptiveResolution: true,
+            targetChunkTokens: 1000, // chunker threshold ~2x = 2000
+            recentWindowTokens: 200,
+        });
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+            membrane: mock,
+        });
+        // ~32K chars ≈ 8K tokens, well over chunkThreshold 2000.
+        const paras = [];
+        for (let p = 0; p < 32; p++) {
+            paras.push(`Paragraph ${p}: ` + 'word '.repeat(80));
+        }
+        const bigBody = paras.join('\n\n');
+        manager.addMessage('User', [{ type: 'text', text: bigBody }]);
+        const all = manager.getAllMessages();
+        assert.ok(all.length > 1, `expected sharding, got ${all.length} stored messages`);
+        // All shards should share the same bodyGroupId
+        const groupId = all[0].bodyGroupId;
+        assert.ok(groupId, 'first shard should have bodyGroupId');
+        for (const m of all) {
+            assert.equal(m.bodyGroupId, groupId, 'all shards should share bodyGroupId');
+        }
+        // shardIndex should be 0..N-1 in order
+        for (let idx = 0; idx < all.length; idx++) {
+            assert.equal(all[idx].shardIndex, idx);
+        }
+        // Byte-faithful reassembly
+        const reassembled = all
+            .map((m) => m.content.filter((b) => b.type === 'text').map((b) => b.text).join(''))
+            .join('');
+        assert.equal(reassembled, bigBody, 'concatenating shard text must equal original body');
+        manager.close();
+    });
+    it('flag on: compile renders bodyGroup as ONE entry with byte-faithful body (no folding)', async () => {
+        const mock = makeMockMembrane();
+        const strategy = new AutobiographicalStrategy({
+            adaptiveResolution: true,
+            targetChunkTokens: 1000,
+            recentWindowTokens: 50_000, // big enough that everything stays in tail (no folding)
+        });
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+            membrane: mock,
+        });
+        const paras = [];
+        for (let p = 0; p < 20; p++) {
+            paras.push(`Para ${p}: ` + 'word '.repeat(80));
+        }
+        const bigBody = paras.join('\n\n');
+        manager.addMessage('User', [{ type: 'text', text: bigBody }]);
+        const compiled = await manager.compile({ maxTokens: 100_000, reserveForResponse: 1000 });
+        // Note: the doc lands in the tail window (no compression triggered).
+        // Tail uses newest-first eviction; the bodyGroup may render as a single
+        // entry OR as separate shards depending on tail emission. The current
+        // selectAdaptive only does bodyGroup-aware emission for the MIDDLE,
+        // not for the tail. So with everything in tail, we see N shards.
+        // For this test, we just verify compile produced output.
+        assert.ok(compiled.messages.length > 0, 'compile should produce output');
+        manager.close();
+    });
+    it('flag on: compile renders bodyGroup as combined entry under folding pressure', async () => {
+        const mock = makeMockMembrane();
+        const strategy = new AutobiographicalStrategy({
+            adaptiveResolution: true,
+            targetChunkTokens: 1000,
+            recentWindowTokens: 200, // small so most of the doc is in the foldable middle
+        });
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+            membrane: mock,
+        });
+        // Big enough to require shards + at least one chunk worth of compression
+        const paras = [];
+        for (let p = 0; p < 30; p++) {
+            paras.push(`Para ${p}: ` + 'distinctive-token-' + p + ' word '.repeat(80));
+        }
+        const bigBody = paras.join('\n\n');
+        manager.addMessage('User', [{ type: 'text', text: bigBody }]);
+        // Add a follow-up so the doc isn't at the very end (otherwise it's all tail)
+        manager.addMessage('User', [{ type: 'text', text: 'Quick follow-up.' }]);
+        // Drive compression to completion
+        while (!manager.isReady()) {
+            await manager.tick();
+        }
+        const compiled = await manager.compile({ maxTokens: 5000, reserveForResponse: 500 });
+        // Find the entry that came from the bigBody shards. The middle path
+        // should have produced ONE combined entry (sourceRelation: 'copy' from
+        // the first shard) with the concatenated body — possibly with inline
+        // summary markers if folding happened.
+        assert.ok(compiled.messages.length > 0);
+        // The combined entry's text should be substantial (not just one shard)
+        // OR contain inline summary markers indicating compression happened.
+        const allText = compiled.messages
+            .flatMap((m) => m.content)
+            .filter((b) => b.type === 'text')
+            .map((b) => b.text)
+            .join('\n---\n');
+        assert.ok(allText.length > 100, `compiled output should have meaningful content; got length ${allText.length}`);
+        manager.close();
+    });
+    it('flag on: small messages (under threshold) are NOT chunked', async () => {
+        const mock = makeMockMembrane();
+        const strategy = new AutobiographicalStrategy({
+            adaptiveResolution: true,
+            targetChunkTokens: 1000,
+        });
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+            membrane: mock,
+        });
+        manager.addMessage('User', [{ type: 'text', text: 'short message' }]);
+        const all = manager.getAllMessages();
+        assert.equal(all.length, 1, 'short messages should not be sharded');
+        assert.equal(all[0].bodyGroupId, undefined);
+        manager.close();
+    });
+    it('flag on: folded shards within a bodyGroup emit separate Q+A recall pair messages', async () => {
+        const mock = makeMockMembrane();
+        const strategy = new AutobiographicalStrategy({
+            adaptiveResolution: true,
+            targetChunkTokens: 300,
+            recentWindowTokens: 200, // small so the doc is in foldable middle
+            summaryContextLabel: 'What do you remember from earlier?',
+            summaryParticipant: 'Claude',
+        });
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+            membrane: mock,
+        });
+        // Big doc with distinctive content per section
+        const paras = [];
+        for (let p = 0; p < 24; p++) {
+            paras.push(`Section ${p}: ` + `unique-token-${p} `.repeat(30));
+        }
+        const bigBody = paras.join('\n\n');
+        manager.addMessage('User', [{ type: 'text', text: bigBody }]);
+        // Trailing follow-up so the doc isn't entirely in tail
+        manager.addMessage('User', [{ type: 'text', text: 'Follow up please.' }]);
+        while (!manager.isReady()) {
+            await manager.tick();
+        }
+        // Compile with a budget tight enough to force folding
+        const compiled = await manager.compile({ maxTokens: 4000, reserveForResponse: 500 });
+        // Look for the Q+A recall pair pattern. If any folding happened, we
+        // should see "Context Manager" + summaryParticipant pairs in the
+        // compiled output.
+        const participants = compiled.messages.map((m) => m.participant);
+        const cmIndex = participants.indexOf('Context Manager');
+        const claudeIndex = participants.indexOf('Claude');
+        // The exact structure depends on which shards are folded and where the
+        // doc ends up. We assert at least one of the following holds:
+        //   - A Q+A pair appears (Context Manager followed by Claude/summary participant)
+        //   - OR no folding happened (everything fit at L0)
+        if (cmIndex >= 0) {
+            // Found a Q+A — there should be a Claude turn right after
+            assert.ok(participants[cmIndex + 1] === 'Claude' ||
+                participants[cmIndex + 1] === strategy['config'].summaryParticipant, `expected summary participant right after Context Manager; got ${participants[cmIndex + 1]}`);
+        }
+        // The bodyGroup should NOT be a single big composite entry with inline
+        // `[Section summary ...]` markers anymore. Verify no inline marker.
+        const allText = compiled.messages
+            .flatMap((m) => m.content)
+            .filter((b) => b.type === 'text')
+            .map((b) => b.text)
+            .join('\n');
+        assert.ok(!allText.includes('[Section summary ('), 'should NOT use inline [Section summary (...)] markers; should emit Q+A pairs instead');
+        manager.close();
+    });
+    it('flag on: tail-only bodyGroup renders as ONE composite User message (not N turns)', async () => {
+        const mock = makeMockMembrane();
+        const strategy = new AutobiographicalStrategy({
+            adaptiveResolution: true,
+            targetChunkTokens: 300,
+            recentWindowTokens: 100_000, // big tail so the doc fits entirely in tail
+        });
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+            membrane: mock,
+        });
+        const paras = [];
+        for (let p = 0; p < 16; p++) {
+            paras.push(`Section ${p}: ` + 'distinctive-text '.repeat(40));
+        }
+        const bigBody = paras.join('\n\n');
+        manager.addMessage('User', [{ type: 'text', text: bigBody }]);
+        const all = manager.getAllMessages();
+        assert.ok(all.length > 1, 'doc should be sharded');
+        const compiled = await manager.compile({ maxTokens: 100_000, reserveForResponse: 1000 });
+        // The doc is entirely in tail. After the post-processing pass in
+        // selectAdaptive, it should render as exactly ONE composite User
+        // message — NOT N separate messages.
+        const userEntries = compiled.messages.filter((m) => m.participant.toLowerCase() === 'user');
+        assert.ok(userEntries.length > 0, 'should have user entries');
+        const entriesWithSection0 = userEntries.filter((m) => m.content
+            .filter((b) => b.type === 'text')
+            .some((b) => b.text.includes('Section 0:')));
+        assert.equal(entriesWithSection0.length, 1, 'Section 0 should appear in exactly one user entry (composite)');
+        const compositeEntry = entriesWithSection0[0];
+        const compositeText = compositeEntry.content
+            .filter((b) => b.type === 'text')
+            .map((b) => b.text)
+            .join('');
+        assert.ok(compositeText.includes('Section 15:'), 'composite should also contain the last section (all shards merged)');
+        assert.equal(compositeText, bigBody, 'composite text should reassemble original body byte-for-byte');
+        manager.close();
+    });
+    it('flag on: non-text content (e.g., tool_use blocks) is preserved on first shard', async () => {
+        const mock = makeMockMembrane();
+        const strategy = new AutobiographicalStrategy({
+            adaptiveResolution: true,
+            targetChunkTokens: 500,
+        });
+        const manager = await ContextManager.open({
+            path: TEST_STORE_PATH,
+            strategy,
+            membrane: mock,
+        });
+        // A big text payload + a tool_use-like non-text block
+        const bigText = 'paragraph. '.repeat(2000);
+        manager.addMessage('User', [
+            { type: 'text', text: bigText },
+            // A simulated non-text block; the chunker passes it through.
+            { type: 'tool_use', id: 'tool-1', name: 'search', input: { q: 'test' } },
+        ]);
+        const all = manager.getAllMessages();
+        assert.ok(all.length > 1, 'should be sharded');
+        // First shard should carry the non-text block(s)
+        const firstNonText = all[0].content.filter((b) => b.type !== 'text');
+        assert.equal(firstNonText.length, 1, 'first shard should carry the tool_use block');
+        // Other shards should not
+        for (let idx = 1; idx < all.length; idx++) {
+            const nonText = all[idx].content.filter((b) => b.type !== 'text');
+            assert.equal(nonText.length, 0, `shard ${idx} should not carry tool_use`);
+        }
+        manager.close();
+    });
+});
+//# sourceMappingURL=ingestion.test.js.map

package/dist/test/adaptive/ingestion.test.js.map

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

package/dist/test/adaptive/integration.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Integration tests for the adaptive-resolution picker.
+ *
+ * These simulate realistic scenarios over many turns and verify the
+ * design's claimed properties end-to-end:
+ *  - 500K-doc ingestion + first compile fits in budget
+ *  - 200-turn growth with picker firing only as needed
+ *  - Monotonic cache stickiness (a chunk's resolution only ever rises)
+ *  - Group-fold operates correctly through chained levels
+ */
+export {};
+//# sourceMappingURL=integration.test.d.ts.map

package/dist/test/adaptive/integration.test.d.ts.map

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