sliding-context 0.3.0

package/dist/__tests__/token-counter.test.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const token_counter_1 = require("../token-counter");
+(0, vitest_1.describe)('approximateTokenCounter', () => {
+    (0, vitest_1.it)('returns 0 for empty string', () => {
+        (0, vitest_1.expect)((0, token_counter_1.approximateTokenCounter)('')).toBe(0);
+    });
+    (0, vitest_1.it)('returns 1 for single character (ceil(1/4))', () => {
+        (0, vitest_1.expect)((0, token_counter_1.approximateTokenCounter)('a')).toBe(1);
+    });
+    (0, vitest_1.it)('returns 1 for exactly 4 characters', () => {
+        (0, vitest_1.expect)((0, token_counter_1.approximateTokenCounter)('abcd')).toBe(1);
+    });
+    (0, vitest_1.it)('returns 2 for 5 characters (ceil(5/4))', () => {
+        (0, vitest_1.expect)((0, token_counter_1.approximateTokenCounter)('abcde')).toBe(2);
+    });
+    (0, vitest_1.it)('returns 25 for 100-character string', () => {
+        const str = 'a'.repeat(100);
+        (0, vitest_1.expect)((0, token_counter_1.approximateTokenCounter)(str)).toBe(25);
+    });
+});
+(0, vitest_1.describe)('DEFAULT_MESSAGE_OVERHEAD', () => {
+    (0, vitest_1.it)('is 4', () => {
+        (0, vitest_1.expect)(token_counter_1.DEFAULT_MESSAGE_OVERHEAD).toBe(4);
+    });
+});
+(0, vitest_1.describe)('countMessageTokens', () => {
+    (0, vitest_1.it)('counts basic string content plus overhead', () => {
+        const message = { role: 'user', content: 'abcd' }; // 1 token
+        const result = (0, token_counter_1.countMessageTokens)(message, token_counter_1.approximateTokenCounter, 4);
+        (0, vitest_1.expect)(result).toBe(1 + 4); // 5
+    });
+    (0, vitest_1.it)('returns messageOverhead for empty content', () => {
+        const message = { role: 'user', content: '' };
+        const result = (0, token_counter_1.countMessageTokens)(message, token_counter_1.approximateTokenCounter, 4);
+        (0, vitest_1.expect)(result).toBe(4);
+    });
+    (0, vitest_1.it)('adds tool_calls JSON token cost', () => {
+        const message = {
+            role: 'assistant',
+            content: '',
+            tool_calls: [
+                {
+                    id: 'call_1',
+                    type: 'function',
+                    function: { name: 'fn', arguments: '{}' },
+                },
+            ],
+        };
+        const toolCallsJson = JSON.stringify(message.tool_calls);
+        const expectedToolTokens = (0, token_counter_1.approximateTokenCounter)(toolCallsJson);
+        const result = (0, token_counter_1.countMessageTokens)(message, token_counter_1.approximateTokenCounter, 4);
+        (0, vitest_1.expect)(result).toBe(0 + expectedToolTokens + 4);
+    });
+    (0, vitest_1.it)('adds tool_call_id token cost', () => {
+        const message = {
+            role: 'tool',
+            content: 'result',
+            tool_call_id: 'call_abc123',
+        };
+        const contentTokens = (0, token_counter_1.approximateTokenCounter)('result'); // ceil(6/4) = 2
+        const idTokens = (0, token_counter_1.approximateTokenCounter)('call_abc123'); // ceil(11/4) = 3
+        const result = (0, token_counter_1.countMessageTokens)(message, token_counter_1.approximateTokenCounter, 4);
+        (0, vitest_1.expect)(result).toBe(contentTokens + idTokens + 4);
+    });
+    (0, vitest_1.it)('uses custom tokenCounter', () => {
+        const mockCounter = vitest_1.vi.fn().mockReturnValue(10);
+        const message = { role: 'user', content: 'hello world' };
+        const result = (0, token_counter_1.countMessageTokens)(message, mockCounter, 2);
+        (0, vitest_1.expect)(mockCounter).toHaveBeenCalledWith('hello world');
+        (0, vitest_1.expect)(result).toBe(10 + 2);
+    });
+    (0, vitest_1.it)('uses custom tokenCounter with tool_calls and tool_call_id', () => {
+        const mockCounter = vitest_1.vi.fn().mockReturnValue(5);
+        const message = {
+            role: 'tool',
+            content: 'some result',
+            tool_call_id: 'call_xyz',
+        };
+        // Called twice: once for content, once for tool_call_id
+        const result = (0, token_counter_1.countMessageTokens)(message, mockCounter, 3);
+        (0, vitest_1.expect)(mockCounter).toHaveBeenCalledTimes(2);
+        (0, vitest_1.expect)(result).toBe(5 + 5 + 3); // content + id + overhead
+    });
+    (0, vitest_1.it)('handles array content: text parts summed, image parts use IMAGE_TOKEN_COST', () => {
+        // Simulate array content by casting through unknown
+        const imageTokenCost = 85;
+        const arrayContent = [
+            { type: 'text', text: 'abcd' }, // ceil(4/4) = 1 token
+            { type: 'image_url', url: 'http://example.com/img.png' }, // 85 tokens
+            { type: 'text', text: 'efgh' }, // ceil(4/4) = 1 token
+        ];
+        const message = {
+            role: 'user',
+            content: arrayContent,
+        };
+        const result = (0, token_counter_1.countMessageTokens)(message, token_counter_1.approximateTokenCounter, 4);
+        (0, vitest_1.expect)(result).toBe(1 + imageTokenCost + 1 + 4); // 91
+    });
+    (0, vitest_1.it)('handles array content with only text parts', () => {
+        const arrayContent = [
+            { type: 'text', text: 'hello' }, // ceil(5/4) = 2
+            { type: 'text', text: 'world' }, // ceil(5/4) = 2
+        ];
+        const message = {
+            role: 'user',
+            content: arrayContent,
+        };
+        const result = (0, token_counter_1.countMessageTokens)(message, token_counter_1.approximateTokenCounter, 4);
+        (0, vitest_1.expect)(result).toBe(2 + 2 + 4); // 8
+    });
+    (0, vitest_1.it)('handles array content with undefined type (treated as text)', () => {
+        const arrayContent = [{ text: 'abcdefgh' }]; // ceil(8/4) = 2
+        const message = {
+            role: 'user',
+            content: arrayContent,
+        };
+        const result = (0, token_counter_1.countMessageTokens)(message, token_counter_1.approximateTokenCounter, 4);
+        (0, vitest_1.expect)(result).toBe(2 + 4); // 6
+    });
+});
+//# sourceMappingURL=token-counter.test.js.map

package/dist/__tests__/token-counter.test.js.map

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

package/dist/__tests__/types.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.test.d.ts.map

package/dist/__tests__/types.test.d.ts.map

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

package/dist/__tests__/types.test.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+(0, vitest_1.describe)('types', () => {
+    (0, vitest_1.describe)('Message', () => {
+        (0, vitest_1.it)('accepts role: system', () => {
+            const msg = { role: 'system', content: 'You are helpful.' };
+            (0, vitest_1.expect)(msg.role).toBe('system');
+            (0, vitest_1.expect)(msg.content).toBe('You are helpful.');
+        });
+        (0, vitest_1.it)('accepts role: user', () => {
+            const msg = { role: 'user', content: 'Hello' };
+            (0, vitest_1.expect)(msg.role).toBe('user');
+        });
+        (0, vitest_1.it)('accepts role: assistant', () => {
+            const msg = { role: 'assistant', content: 'Hi!' };
+            (0, vitest_1.expect)(msg.role).toBe('assistant');
+        });
+        (0, vitest_1.it)('accepts role: tool', () => {
+            const msg = { role: 'tool', content: 'result data', tool_call_id: 'call_1' };
+            (0, vitest_1.expect)(msg.role).toBe('tool');
+            (0, vitest_1.expect)(msg.tool_call_id).toBe('call_1');
+        });
+        (0, vitest_1.it)('accepts optional tool_calls', () => {
+            const msg = {
+                role: 'assistant',
+                content: '',
+                tool_calls: [
+                    { id: 'call_1', type: 'function', function: { name: 'fn', arguments: '{}' } },
+                ],
+            };
+            (0, vitest_1.expect)(msg.tool_calls).toHaveLength(1);
+        });
+        (0, vitest_1.it)('accepts optional name field', () => {
+            const msg = { role: 'user', content: 'hi', name: 'alice' };
+            (0, vitest_1.expect)(msg.name).toBe('alice');
+        });
+    });
+    (0, vitest_1.describe)('ToolCall', () => {
+        (0, vitest_1.it)('has correct shape', () => {
+            const tc = {
+                id: 'call_xyz',
+                type: 'function',
+                function: { name: 'search', arguments: '{"q":"test"}' },
+            };
+            (0, vitest_1.expect)(tc.id).toBe('call_xyz');
+            (0, vitest_1.expect)(tc.type).toBe('function');
+            (0, vitest_1.expect)(tc.function.name).toBe('search');
+            (0, vitest_1.expect)(tc.function.arguments).toBe('{"q":"test"}');
+        });
+    });
+    (0, vitest_1.describe)('SlidingContextOptions', () => {
+        (0, vitest_1.it)('requires only tokenBudget', () => {
+            const opts = { tokenBudget: 4096 };
+            (0, vitest_1.expect)(opts.tokenBudget).toBe(4096);
+        });
+        (0, vitest_1.it)('accepts all optional fields', () => {
+            const opts = {
+                tokenBudget: 8192,
+                systemPrompt: 'Be helpful',
+                strategy: 'incremental',
+                maxSummaryTokens: 512,
+                minRecentTokens: 256,
+                summarizeThresholdTokens: 3000,
+                summarizeThresholdMessages: 10,
+                messageOverhead: 4,
+                summaryRole: 'system',
+                maxSummaryRounds: 3,
+                maxAnchorTokens: 1024,
+            };
+            (0, vitest_1.expect)(opts.tokenBudget).toBe(8192);
+            (0, vitest_1.expect)(opts.strategy).toBe('incremental');
+            (0, vitest_1.expect)(opts.summaryRole).toBe('system');
+        });
+    });
+    (0, vitest_1.describe)('ContextState', () => {
+        (0, vitest_1.it)('version is literal 1', () => {
+            const state = {
+                options: { tokenBudget: 4096 },
+                messages: [],
+                summary: undefined,
+                anchor: [],
+                pendingBuffer: [],
+                summaryRounds: 0,
+                tokenCounts: {},
+                version: 1,
+            };
+            (0, vitest_1.expect)(state.version).toBe(1);
+        });
+    });
+});
+//# sourceMappingURL=types.test.js.map

package/dist/__tests__/types.test.js.map

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

package/dist/budget.d.ts

@@ -0,0 +1,16 @@
+import type { SlidingContextOptions } from './types';
+export interface BudgetAllocation {
+    systemTokens: number;
+    summaryTokens: number;
+    recentTokens: number;
+}
+/**
+ * Allocate token budget across the three context zones.
+ *
+ * Priority order:
+ *   1. System tokens (fixed — caller provides actual count)
+ *   2. Summary tokens (capped at maxSummaryTokens; 0 if no summarizer)
+ *   3. Recent tokens (remainder, enforcing minRecentTokens)
+ */
+export declare function allocateBudget(options: SlidingContextOptions, systemTokensUsed: number): BudgetAllocation;
+//# sourceMappingURL=budget.d.ts.map

package/dist/budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../src/budget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,qBAAqB,EAC9B,gBAAgB,EAAE,MAAM,GACvB,gBAAgB,CA4BlB"}

package/dist/budget.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allocateBudget = allocateBudget;
+/**
+ * Allocate token budget across the three context zones.
+ *
+ * Priority order:
+ *   1. System tokens (fixed — caller provides actual count)
+ *   2. Summary tokens (capped at maxSummaryTokens; 0 if no summarizer)
+ *   3. Recent tokens (remainder, enforcing minRecentTokens)
+ */
+function allocateBudget(options, systemTokensUsed) {
+    const total = options.tokenBudget;
+    const afterSystem = Math.max(0, total - systemTokensUsed);
+    const hasSummarizer = typeof options.summarizer === 'function';
+    const defaultMaxSummary = Math.floor(total * 0.3);
+    const maxSummaryTokens = hasSummarizer
+        ? (options.maxSummaryTokens ?? defaultMaxSummary)
+        : 0;
+    const defaultMinRecent = Math.floor(total * 0.3);
+    const minRecentTokens = options.minRecentTokens ?? defaultMinRecent;
+    // How much can summary actually use?
+    const summaryTokens = Math.min(maxSummaryTokens, Math.max(0, afterSystem - minRecentTokens));
+    const recentTokens = Math.max(0, afterSystem - summaryTokens);
+    return {
+        systemTokens: systemTokensUsed,
+        summaryTokens,
+        recentTokens,
+    };
+}
+//# sourceMappingURL=budget.js.map

package/dist/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../src/budget.ts"],"names":[],"mappings":";;AAgBA,wCA+BC;AAvCD;;;;;;;GAOG;AACH,SAAgB,cAAc,CAC5B,OAA8B,EAC9B,gBAAwB;IAExB,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC;IAElC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,gBAAgB,CAAC,CAAC;IAE1D,MAAM,aAAa,GAAG,OAAO,OAAO,CAAC,UAAU,KAAK,UAAU,CAAC;IAE/D,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;IAClD,MAAM,gBAAgB,GAAG,aAAa;QACpC,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,IAAI,iBAAiB,CAAC;QACjD,CAAC,CAAC,CAAC,CAAC;IAEN,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;IACjD,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,gBAAgB,CAAC;IAEpE,qCAAqC;IACrC,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAC5B,gBAAgB,EAChB,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,eAAe,CAAC,CAC3C,CAAC;IAEF,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC,CAAC;IAE9D,OAAO;QACL,YAAY,EAAE,gBAAgB;QAC9B,aAAa;QACb,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,16 @@
+import type { SlidingContextOptions, SlidingContext } from './types';
+/**
+ * Create a new SlidingContext instance.
+ */
+export declare function createSlidingContext(options: SlidingContextOptions): SlidingContext;
+/**
+ * Serialize a SlidingContext's state to a JSON string suitable for storage.
+ */
+export declare function serializeContext(ctx: SlidingContext): string;
+/**
+ * Restore a SlidingContext from a JSON string produced by `serializeContext()`.
+ * Re-supply function-valued options (summarizer, tokenCounter, hooks) since
+ * they cannot be serialized.
+ */
+export declare function restoreSlidingContext(data: string, options: SlidingContextOptions): SlidingContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,qBAAqB,EAErB,cAAc,EACf,MAAM,SAAS,CAAC;AAmSjB;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAEnF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,qBAAqB,GAC7B,cAAc,CAGhB"}

package/dist/context.js

@@ -0,0 +1,245 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSlidingContext = createSlidingContext;
+exports.serializeContext = serializeContext;
+exports.restoreSlidingContext = restoreSlidingContext;
+const token_counter_1 = require("./token-counter");
+const eviction_1 = require("./eviction");
+const budget_1 = require("./budget");
+const summarization_1 = require("./summarization");
+const serialization_1 = require("./serialization");
+// ---------------------------------------------------------------------------
+// Shared helpers
+// ---------------------------------------------------------------------------
+function msgTokens(message, opts) {
+    const counter = opts.tokenCounter ?? token_counter_1.approximateTokenCounter;
+    const overhead = opts.messageOverhead ?? token_counter_1.DEFAULT_MESSAGE_OVERHEAD;
+    return (0, token_counter_1.countMessageTokens)(message, counter, overhead);
+}
+function listTokens(messages, opts) {
+    return messages.reduce((sum, m) => sum + msgTokens(m, opts), 0);
+}
+// ---------------------------------------------------------------------------
+// Core factory (accepts optional initial state for restore path)
+// ---------------------------------------------------------------------------
+function createWithState(options, initialState) {
+    if (!Number.isFinite(options.tokenBudget) || options.tokenBudget < 100) {
+        throw new RangeError(`sliding-context: tokenBudget must be a finite number >= 100, got ${options.tokenBudget}`);
+    }
+    // ---------------------------------------------------------------------------
+    // Mutable state
+    // ---------------------------------------------------------------------------
+    let tokenBudget = options.tokenBudget;
+    const systemMessage = options.systemPrompt
+        ? { role: 'system', content: options.systemPrompt }
+        : null;
+    let anchorMessages = initialState
+        ? initialState.anchor.slice()
+        : options.anchor
+            ? options.anchor.slice()
+            : [];
+    let currentSummary = initialState?.summary;
+    let recentMessages = initialState ? initialState.messages.slice() : [];
+    let pendingBuffer = initialState ? initialState.pendingBuffer.slice() : [];
+    let summaryRounds = initialState?.summaryRounds ?? 0;
+    // ---------------------------------------------------------------------------
+    // Token accessors
+    // ---------------------------------------------------------------------------
+    function effectiveOpts() {
+        return { ...options, tokenBudget };
+    }
+    function sysTokens() {
+        return systemMessage ? msgTokens(systemMessage, effectiveOpts()) : 0;
+    }
+    function ancTokens() {
+        return listTokens(anchorMessages, effectiveOpts());
+    }
+    function sumTokens() {
+        if (currentSummary === undefined)
+            return 0;
+        return msgTokens({ role: options.summaryRole ?? 'system', content: currentSummary }, effectiveOpts());
+    }
+    function recTokens() {
+        return listTokens(recentMessages, effectiveOpts());
+    }
+    function pendTokens() {
+        return listTokens(pendingBuffer, effectiveOpts());
+    }
+    // ---------------------------------------------------------------------------
+    // Summarization
+    // ---------------------------------------------------------------------------
+    async function triggerSummarization() {
+        const { summarizer } = options;
+        if (!summarizer || pendingBuffer.length === 0)
+            return;
+        const maxRounds = options.maxSummaryRounds ?? 5;
+        if (summaryRounds >= maxRounds)
+            return;
+        const startMs = Date.now();
+        const toSummarize = pendingBuffer.slice();
+        const existingSummary = currentSummary;
+        const newSummary = await (0, summarization_1.runSummarizer)(toSummarize, summarizer, existingSummary);
+        if (newSummary === null)
+            return;
+        summaryRounds += 1;
+        if (options.hooks?.onSummarize) {
+            options.hooks.onSummarize(toSummarize, existingSummary, newSummary, Date.now() - startMs);
+        }
+        if (existingSummary !== undefined && options.hooks?.onSummaryCompressed) {
+            options.hooks.onSummaryCompressed(existingSummary, newSummary);
+        }
+        currentSummary = newSummary;
+        pendingBuffer = [];
+    }
+    // ---------------------------------------------------------------------------
+    // Budget enforcement
+    // ---------------------------------------------------------------------------
+    async function enforceBudget() {
+        const opts = effectiveOpts();
+        const counter = opts.tokenCounter ?? token_counter_1.approximateTokenCounter;
+        const overhead = opts.messageOverhead ?? token_counter_1.DEFAULT_MESSAGE_OVERHEAD;
+        const allocation = (0, budget_1.allocateBudget)(opts, sysTokens() + ancTokens() + sumTokens());
+        const targetRecent = allocation.recentTokens;
+        if (recTokens() <= targetRecent)
+            return;
+        if (options.hooks?.onBudgetExceeded) {
+            const total = sysTokens() + ancTokens() + sumTokens() + recTokens() + pendTokens();
+            options.hooks.onBudgetExceeded(total, tokenBudget);
+        }
+        const { evicted, remaining } = (0, eviction_1.evictMessages)(recentMessages, targetRecent, counter, overhead);
+        if (evicted.length > 0) {
+            recentMessages = remaining;
+            pendingBuffer = [...pendingBuffer, ...evicted];
+            if (options.hooks?.onEvict)
+                options.hooks.onEvict(evicted, 'budget');
+        }
+        const thresholdTokens = opts.summarizeThresholdTokens ?? Math.floor(tokenBudget * 0.1);
+        const thresholdMessages = opts.summarizeThresholdMessages ?? 6;
+        if (pendingBuffer.length >= thresholdMessages ||
+            pendTokens() >= thresholdTokens) {
+            await triggerSummarization();
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Public API
+    // ---------------------------------------------------------------------------
+    async function addMessage(message) {
+        recentMessages.push(message);
+        await enforceBudget();
+    }
+    function getMessages() {
+        const result = [];
+        if (systemMessage)
+            result.push(systemMessage);
+        if (anchorMessages.length > 0)
+            result.push(...anchorMessages);
+        // Pending messages are older than recent — include before summary/recent.
+        if (pendingBuffer.length > 0)
+            result.push(...pendingBuffer);
+        if (currentSummary !== undefined) {
+            result.push({ role: options.summaryRole ?? 'system', content: currentSummary });
+        }
+        result.push(...recentMessages);
+        return result;
+    }
+    function getSummary() {
+        return currentSummary;
+    }
+    function getTokenCount() {
+        return sysTokens() + ancTokens() + sumTokens() + recTokens() + pendTokens();
+    }
+    function getTokenBreakdown() {
+        const system = sysTokens();
+        const anchor = ancTokens();
+        const summary = sumTokens();
+        const recent = recTokens() + pendTokens();
+        return { system, anchor, summary, recent, total: system + anchor + summary + recent };
+    }
+    function getRecentMessageCount() {
+        return recentMessages.length + pendingBuffer.length;
+    }
+    function getTotalMessageCount() {
+        let count = recentMessages.length + pendingBuffer.length;
+        if (currentSummary !== undefined)
+            count += 1;
+        if (systemMessage)
+            count += 1;
+        count += anchorMessages.length;
+        return count;
+    }
+    function setAnchor(messages) {
+        anchorMessages = messages.slice();
+    }
+    function setTokenBudget(budget) {
+        if (!Number.isFinite(budget) || budget < 100) {
+            throw new RangeError(`sliding-context: tokenBudget must be a finite number >= 100, got ${budget}`);
+        }
+        tokenBudget = budget;
+        void enforceBudget();
+    }
+    function clear() {
+        recentMessages = [];
+        pendingBuffer = [];
+        currentSummary = undefined;
+        summaryRounds = 0;
+        anchorMessages = options.anchor ? options.anchor.slice() : [];
+    }
+    function serialize() {
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        const { summarizer, tokenCounter, hooks, ...serializableOptions } = options;
+        return {
+            options: { ...serializableOptions, tokenBudget },
+            messages: recentMessages.slice(),
+            summary: currentSummary,
+            anchor: anchorMessages.slice(),
+            pendingBuffer: pendingBuffer.slice(),
+            summaryRounds,
+            tokenCounts: {
+                system: sysTokens(),
+                anchor: ancTokens(),
+                summary: sumTokens(),
+                recent: recTokens(),
+                pending: pendTokens(),
+            },
+            version: 1,
+        };
+    }
+    return {
+        addMessage,
+        getMessages,
+        getSummary,
+        getTokenCount,
+        getTokenBreakdown,
+        getRecentMessageCount,
+        getTotalMessageCount,
+        setAnchor,
+        setTokenBudget,
+        clear,
+        serialize,
+    };
+}
+// ---------------------------------------------------------------------------
+// Public exports
+// ---------------------------------------------------------------------------
+/**
+ * Create a new SlidingContext instance.
+ */
+function createSlidingContext(options) {
+    return createWithState(options);
+}
+/**
+ * Serialize a SlidingContext's state to a JSON string suitable for storage.
+ */
+function serializeContext(ctx) {
+    return (0, serialization_1.serialize)(ctx.serialize());
+}
+/**
+ * Restore a SlidingContext from a JSON string produced by `serializeContext()`.
+ * Re-supply function-valued options (summarizer, tokenCounter, hooks) since
+ * they cannot be serialized.
+ */
+function restoreSlidingContext(data, options) {
+    const state = (0, serialization_1.deserialize)(data);
+    return createWithState({ ...options, tokenBudget: state.options.tokenBudget }, state);
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":";;AA2SA,oDAEC;AAKD,4CAEC;AAOD,sDAMC;AA3TD,mDAIyB;AACzB,yCAA2C;AAC3C,qCAA0C;AAC1C,mDAAgD;AAChD,mDAA0F;AAE1F,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,SAAS,SAAS,CAAC,OAAgB,EAAE,IAA2B;IAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,IAAI,uCAAuB,CAAC;IAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,IAAI,wCAAwB,CAAC;IAClE,OAAO,IAAA,kCAAkB,EAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,UAAU,CAAC,QAAmB,EAAE,IAA2B;IAClE,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,8EAA8E;AAC9E,iEAAiE;AACjE,8EAA8E;AAE9E,SAAS,eAAe,CACtB,OAA8B,EAC9B,YAA2B;IAE3B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,WAAW,GAAG,GAAG,EAAE,CAAC;QACvE,MAAM,IAAI,UAAU,CAClB,oEAAoE,OAAO,CAAC,WAAW,EAAE,CAC1F,CAAC;IACJ,CAAC;IAED,8EAA8E;IAC9E,gBAAgB;IAChB,8EAA8E;IAE9E,IAAI,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAEtC,MAAM,aAAa,GAAmB,OAAO,CAAC,YAAY;QACxD,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,YAAY,EAAE;QACnD,CAAC,CAAC,IAAI,CAAC;IAET,IAAI,cAAc,GAAc,YAAY;QAC1C,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE;QAC7B,CAAC,CAAC,OAAO,CAAC,MAAM;YACd,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE;YACxB,CAAC,CAAC,EAAE,CAAC;IAET,IAAI,cAAc,GAAuB,YAAY,EAAE,OAAO,CAAC;IAC/D,IAAI,cAAc,GAAc,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAClF,IAAI,aAAa,GAAc,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACtF,IAAI,aAAa,GAAG,YAAY,EAAE,aAAa,IAAI,CAAC,CAAC;IAErD,8EAA8E;IAC9E,kBAAkB;IAClB,8EAA8E;IAE9E,SAAS,aAAa;QACpB,OAAO,EAAE,GAAG,OAAO,EAAE,WAAW,EAAE,CAAC;IACrC,CAAC;IAED,SAAS,SAAS;QAChB,OAAO,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,SAAS,SAAS;QAChB,OAAO,UAAU,CAAC,cAAc,EAAE,aAAa,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,SAAS,SAAS;QAChB,IAAI,cAAc,KAAK,SAAS;YAAE,OAAO,CAAC,CAAC;QAC3C,OAAO,SAAS,CACd,EAAE,IAAI,EAAE,OAAO,CAAC,WAAW,IAAI,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,EAClE,aAAa,EAAE,CAChB,CAAC;IACJ,CAAC;IAED,SAAS,SAAS;QAChB,OAAO,UAAU,CAAC,cAAc,EAAE,aAAa,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,SAAS,UAAU;QACjB,OAAO,UAAU,CAAC,aAAa,EAAE,aAAa,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,8EAA8E;IAC9E,gBAAgB;IAChB,8EAA8E;IAE9E,KAAK,UAAU,oBAAoB;QACjC,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;QAC/B,IAAI,CAAC,UAAU,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEtD,MAAM,SAAS,GAAG,OAAO,CAAC,gBAAgB,IAAI,CAAC,CAAC;QAChD,IAAI,aAAa,IAAI,SAAS;YAAE,OAAO;QAEvC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAG,aAAa,CAAC,KAAK,EAAE,CAAC;QAC1C,MAAM,eAAe,GAAG,cAAc,CAAC;QAEvC,MAAM,UAAU,GAAG,MAAM,IAAA,6BAAa,EAAC,WAAW,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;QACjF,IAAI,UAAU,KAAK,IAAI;YAAE,OAAO;QAEhC,aAAa,IAAI,CAAC,CAAC;QAEnB,IAAI,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC;YAC/B,OAAO,CAAC,KAAK,CAAC,WAAW,CACvB,WAAW,EACX,eAAe,EACf,UAAU,EACV,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CACrB,CAAC;QACJ,CAAC;QAED,IAAI,eAAe,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,EAAE,mBAAmB,EAAE,CAAC;YACxE,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;QACjE,CAAC;QAED,cAAc,GAAG,UAAU,CAAC;QAC5B,aAAa,GAAG,EAAE,CAAC;IACrB,CAAC;IAED,8EAA8E;IAC9E,qBAAqB;IACrB,8EAA8E;IAE9E,KAAK,UAAU,aAAa;QAC1B,MAAM,IAAI,GAAG,aAAa,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,IAAI,uCAAuB,CAAC;QAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,IAAI,wCAAwB,CAAC;QAElE,MAAM,UAAU,GAAG,IAAA,uBAAc,EAAC,IAAI,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;QACjF,MAAM,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC;QAE7C,IAAI,SAAS,EAAE,IAAI,YAAY;YAAE,OAAO;QAExC,IAAI,OAAO,CAAC,KAAK,EAAE,gBAAgB,EAAE,CAAC;YACpC,MAAM,KAAK,GAAG,SAAS,EAAE,GAAG,SAAS,EAAE,GAAG,SAAS,EAAE,GAAG,SAAS,EAAE,GAAG,UAAU,EAAE,CAAC;YACnF,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAA,wBAAa,EAC1C,cAAc,EACd,YAAY,EACZ,OAAO,EACP,QAAQ,CACT,CAAC;QAEF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,cAAc,GAAG,SAAS,CAAC;YAC3B,aAAa,GAAG,CAAC,GAAG,aAAa,EAAE,GAAG,OAAO,CAAC,CAAC;YAC/C,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO;gBAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,eAAe,GACnB,IAAI,CAAC,wBAAwB,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC;QACjE,MAAM,iBAAiB,GAAG,IAAI,CAAC,0BAA0B,IAAI,CAAC,CAAC;QAE/D,IACE,aAAa,CAAC,MAAM,IAAI,iBAAiB;YACzC,UAAU,EAAE,IAAI,eAAe,EAC/B,CAAC;YACD,MAAM,oBAAoB,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,aAAa;IACb,8EAA8E;IAE9E,KAAK,UAAU,UAAU,CAAC,OAAgB;QACxC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,aAAa,EAAE,CAAC;IACxB,CAAC;IAED,SAAS,WAAW;QAClB,MAAM,MAAM,GAAc,EAAE,CAAC;QAC7B,IAAI,aAAa;YAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC9C,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,CAAC;QAC9D,0EAA0E;QAC1E,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC;QAC5D,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,WAAW,IAAI,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,CAAC;QAC/B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,SAAS,UAAU;QACjB,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,SAAS,aAAa;QACpB,OAAO,SAAS,EAAE,GAAG,SAAS,EAAE,GAAG,SAAS,EAAE,GAAG,SAAS,EAAE,GAAG,UAAU,EAAE,CAAC;IAC9E,CAAC;IAED,SAAS,iBAAiB;QAOxB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,SAAS,EAAE,GAAG,UAAU,EAAE,CAAC;QAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAC;IACxF,CAAC;IAED,SAAS,qBAAqB;QAC5B,OAAO,cAAc,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;IACtD,CAAC;IAED,SAAS,oBAAoB;QAC3B,IAAI,KAAK,GAAG,cAAc,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC;QACzD,IAAI,cAAc,KAAK,SAAS;YAAE,KAAK,IAAI,CAAC,CAAC;QAC7C,IAAI,aAAa;YAAE,KAAK,IAAI,CAAC,CAAC;QAC9B,KAAK,IAAI,cAAc,CAAC,MAAM,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,SAAS,SAAS,CAAC,QAAmB;QACpC,cAAc,GAAG,QAAQ,CAAC,KAAK,EAAE,CAAC;IACpC,CAAC;IAED,SAAS,cAAc,CAAC,MAAc;QACpC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;YAC7C,MAAM,IAAI,UAAU,CAClB,oEAAoE,MAAM,EAAE,CAC7E,CAAC;QACJ,CAAC;QACD,WAAW,GAAG,MAAM,CAAC;QACrB,KAAK,aAAa,EAAE,CAAC;IACvB,CAAC;IAED,SAAS,KAAK;QACZ,cAAc,GAAG,EAAE,CAAC;QACpB,aAAa,GAAG,EAAE,CAAC;QACnB,cAAc,GAAG,SAAS,CAAC;QAC3B,aAAa,GAAG,CAAC,CAAC;QAClB,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,CAAC;IAED,SAAS,SAAS;QAChB,6DAA6D;QAC7D,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,mBAAmB,EAAE,GAAG,OAAO,CAAC;QAC5E,OAAO;YACL,OAAO,EAAE,EAAE,GAAG,mBAAmB,EAAE,WAAW,EAAE;YAChD,QAAQ,EAAE,cAAc,CAAC,KAAK,EAAE;YAChC,OAAO,EAAE,cAAc;YACvB,MAAM,EAAE,cAAc,CAAC,KAAK,EAAE;YAC9B,aAAa,EAAE,aAAa,CAAC,KAAK,EAAE;YACpC,aAAa;YACb,WAAW,EAAE;gBACX,MAAM,EAAE,SAAS,EAAE;gBACnB,MAAM,EAAE,SAAS,EAAE;gBACnB,OAAO,EAAE,SAAS,EAAE;gBACpB,MAAM,EAAE,SAAS,EAAE;gBACnB,OAAO,EAAE,UAAU,EAAE;aACtB;YACD,OAAO,EAAE,CAAC;SACX,CAAC;IACJ,CAAC;IAED,OAAO;QACL,UAAU;QACV,WAAW;QACX,UAAU;QACV,aAAa;QACb,iBAAiB;QACjB,qBAAqB;QACrB,oBAAoB;QACpB,SAAS;QACT,cAAc;QACd,KAAK;QACL,SAAS;KACV,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;GAEG;AACH,SAAgB,oBAAoB,CAAC,OAA8B;IACjE,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,GAAmB;IAClD,OAAO,IAAA,yBAAe,EAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,SAAgB,qBAAqB,CACnC,IAAY,EACZ,OAA8B;IAE9B,MAAM,KAAK,GAAG,IAAA,2BAAU,EAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,eAAe,CAAC,EAAE,GAAG,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,CAAC;AACxF,CAAC"}

package/dist/eviction.d.ts

@@ -0,0 +1,14 @@
+import type { Message, TokenCounter } from './types';
+/**
+ * Evict the oldest messages from `messages` until `totalTokens` fits within
+ * `targetTokens`.  Tool-call pairs are kept atomic: an assistant message with
+ * `tool_calls` is always evicted together with all its paired `tool` result
+ * messages.
+ *
+ * Returns `{ evicted, remaining }`.
+ */
+export declare function evictMessages(messages: Message[], targetTokens: number, tokenCounter: TokenCounter, overhead: number): {
+    evicted: Message[];
+    remaining: Message[];
+};
+//# sourceMappingURL=eviction.d.ts.map

package/dist/eviction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eviction.d.ts","sourceRoot":"","sources":["../src/eviction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AA+BrD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,OAAO,EAAE,EACnB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,MAAM,GACf;IAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAAC,SAAS,EAAE,OAAO,EAAE,CAAA;CAAE,CAyD9C"}