sliding-context 0.3.0

package/dist/eviction.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evictMessages = evictMessages;
+const token_counter_1 = require("./token-counter");
+/**
+ * Build a set of tool_call_id values that are "anchored" to a given assistant
+ * message — i.e. the message contains tool_calls whose results we still need.
+ */
+function toolCallIds(message) {
+    const ids = new Set();
+    if (message.tool_calls) {
+        for (const tc of message.tool_calls) {
+            ids.add(tc.id);
+        }
+    }
+    return ids;
+}
+/**
+ * Compute total tokens for a list of messages.
+ */
+function totalTokens(messages, tokenCounter, overhead) {
+    return messages.reduce((sum, m) => sum + (0, token_counter_1.countMessageTokens)(m, tokenCounter, overhead), 0);
+}
+/**
+ * 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 }`.
+ */
+function evictMessages(messages, targetTokens, tokenCounter, overhead) {
+    // Nothing to evict.
+    if (totalTokens(messages, tokenCounter, overhead) <= targetTokens) {
+        return { evicted: [], remaining: messages.slice() };
+    }
+    const remaining = messages.slice();
+    const evicted = [];
+    while (remaining.length > 0 &&
+        totalTokens(remaining, tokenCounter, overhead) > targetTokens) {
+        // Find the first non-system message to evict.
+        const idx = remaining.findIndex((m) => m.role !== 'system');
+        if (idx === -1) {
+            // Only system messages left — cannot evict further.
+            break;
+        }
+        const candidate = remaining[idx];
+        // Collect the group to evict atomically.
+        const group = [candidate];
+        if (candidate.tool_calls && candidate.tool_calls.length > 0) {
+            // This is a tool-call message.  Find all paired tool-result messages that
+            // immediately follow it (they may be interspersed in the remaining list).
+            const pendingIds = toolCallIds(candidate);
+            let searchIdx = idx + 1;
+            while (pendingIds.size > 0 && searchIdx < remaining.length) {
+                const next = remaining[searchIdx];
+                if (next.role === 'tool' && next.tool_call_id && pendingIds.has(next.tool_call_id)) {
+                    group.push(next);
+                    pendingIds.delete(next.tool_call_id);
+                }
+                searchIdx++;
+            }
+        }
+        // Remove the group from remaining.
+        const groupSet = new Set(group);
+        const newRemaining = remaining.filter((m) => !groupSet.has(m));
+        // Safety: never leave remaining empty if we started with messages.
+        // If removing the group would empty everything, stop.
+        if (newRemaining.length === 0 && messages.length > group.length) {
+            break;
+        }
+        // Commit the eviction.
+        evicted.push(...group);
+        remaining.splice(0, remaining.length, ...newRemaining);
+    }
+    return { evicted, remaining };
+}
+//# sourceMappingURL=eviction.js.map

package/dist/eviction.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export type { Message, ToolCall, TokenCounter, Summarizer, SummarizationStrategy, SummaryRole, EventHooks, SlidingContextOptions, ContextState, SlidingContext } from './types';
+export { approximateTokenCounter, countMessageTokens, DEFAULT_MESSAGE_OVERHEAD } from './token-counter';
+export { createSlidingContext, serializeContext, restoreSlidingContext } from './context';
+export { evictMessages } from './eviction';
+export { allocateBudget } from './budget';
+export { runSummarizer } from './summarization';
+export { serialize, deserialize } from './serialization';
+export { defaultSummarizationPrompt } from './prompt';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,qBAAqB,EAAE,WAAW,EAAE,UAAU,EAAE,qBAAqB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAChL,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AACxG,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultSummarizationPrompt = exports.deserialize = exports.serialize = exports.runSummarizer = exports.allocateBudget = exports.evictMessages = exports.restoreSlidingContext = exports.serializeContext = exports.createSlidingContext = exports.DEFAULT_MESSAGE_OVERHEAD = exports.countMessageTokens = exports.approximateTokenCounter = void 0;
+var token_counter_1 = require("./token-counter");
+Object.defineProperty(exports, "approximateTokenCounter", { enumerable: true, get: function () { return token_counter_1.approximateTokenCounter; } });
+Object.defineProperty(exports, "countMessageTokens", { enumerable: true, get: function () { return token_counter_1.countMessageTokens; } });
+Object.defineProperty(exports, "DEFAULT_MESSAGE_OVERHEAD", { enumerable: true, get: function () { return token_counter_1.DEFAULT_MESSAGE_OVERHEAD; } });
+var context_1 = require("./context");
+Object.defineProperty(exports, "createSlidingContext", { enumerable: true, get: function () { return context_1.createSlidingContext; } });
+Object.defineProperty(exports, "serializeContext", { enumerable: true, get: function () { return context_1.serializeContext; } });
+Object.defineProperty(exports, "restoreSlidingContext", { enumerable: true, get: function () { return context_1.restoreSlidingContext; } });
+var eviction_1 = require("./eviction");
+Object.defineProperty(exports, "evictMessages", { enumerable: true, get: function () { return eviction_1.evictMessages; } });
+var budget_1 = require("./budget");
+Object.defineProperty(exports, "allocateBudget", { enumerable: true, get: function () { return budget_1.allocateBudget; } });
+var summarization_1 = require("./summarization");
+Object.defineProperty(exports, "runSummarizer", { enumerable: true, get: function () { return summarization_1.runSummarizer; } });
+var serialization_1 = require("./serialization");
+Object.defineProperty(exports, "serialize", { enumerable: true, get: function () { return serialization_1.serialize; } });
+Object.defineProperty(exports, "deserialize", { enumerable: true, get: function () { return serialization_1.deserialize; } });
+var prompt_1 = require("./prompt");
+Object.defineProperty(exports, "defaultSummarizationPrompt", { enumerable: true, get: function () { return prompt_1.defaultSummarizationPrompt; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAEA,iDAAwG;AAA/F,wHAAA,uBAAuB,OAAA;AAAE,mHAAA,kBAAkB,OAAA;AAAE,yHAAA,wBAAwB,OAAA;AAC9E,qCAA0F;AAAjF,+GAAA,oBAAoB,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAAE,gHAAA,qBAAqB,OAAA;AACtE,uCAA2C;AAAlC,yGAAA,aAAa,OAAA;AACtB,mCAA0C;AAAjC,wGAAA,cAAc,OAAA;AACvB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,iDAAyD;AAAhD,0GAAA,SAAS,OAAA;AAAE,4GAAA,WAAW,OAAA;AAC/B,mCAAsD;AAA7C,oHAAA,0BAA0B,OAAA"}

package/dist/prompt.d.ts

@@ -0,0 +1,6 @@
+import type { Message } from './types';
+/**
+ * Returns a summarization prompt for the given messages.
+ */
+export declare function defaultSummarizationPrompt(messages: Message[]): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAoBvC;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAGtE"}

package/dist/prompt.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultSummarizationPrompt = defaultSummarizationPrompt;
+/**
+ * Formats a message array into a plain-text block for the summarization prompt.
+ */
+function formatMessages(messages) {
+    return messages
+        .map((m) => {
+        const role = m.role.toUpperCase();
+        if (m.tool_calls && m.tool_calls.length > 0) {
+            return `${role}: [tool_calls] ${JSON.stringify(m.tool_calls)}`;
+        }
+        if (m.role === 'tool') {
+            return `TOOL(${m.tool_call_id ?? ''}): ${m.content}`;
+        }
+        return `${role}: ${m.content}`;
+    })
+        .join('\n');
+}
+/**
+ * Returns a summarization prompt for the given messages.
+ */
+function defaultSummarizationPrompt(messages) {
+    const formatted = formatMessages(messages);
+    return `Summarize the following conversation concisely:\n\n${formatted}`;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":";;AAuBA,gEAGC;AAxBD;;GAEG;AACH,SAAS,cAAc,CAAC,QAAmB;IACzC,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAClC,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,OAAO,GAAG,IAAI,kBAAkB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC;QACjE,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACtB,OAAO,QAAQ,CAAC,CAAC,YAAY,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;QACvD,CAAC;QACD,OAAO,GAAG,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;IACjC,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAgB,0BAA0B,CAAC,QAAmB;IAC5D,MAAM,SAAS,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC3C,OAAO,sDAAsD,SAAS,EAAE,CAAC;AAC3E,CAAC"}

package/dist/serialization.d.ts

@@ -0,0 +1,12 @@
+import type { ContextState } from './types';
+/**
+ * Serialize context state to a JSON string.
+ * Always includes `version: 1`.
+ */
+export declare function serialize(state: ContextState): string;
+/**
+ * Deserialize a JSON string back to ContextState.
+ * Throws if the version field does not match the expected schema version.
+ */
+export declare function deserialize(data: string): ContextState;
+//# sourceMappingURL=serialization.d.ts.map

package/dist/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../src/serialization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAI5C;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAErD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAoBtD"}

package/dist/serialization.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serialize = serialize;
+exports.deserialize = deserialize;
+const CURRENT_VERSION = 1;
+/**
+ * Serialize context state to a JSON string.
+ * Always includes `version: 1`.
+ */
+function serialize(state) {
+    return JSON.stringify({ ...state, version: CURRENT_VERSION });
+}
+/**
+ * Deserialize a JSON string back to ContextState.
+ * Throws if the version field does not match the expected schema version.
+ */
+function deserialize(data) {
+    let parsed;
+    try {
+        parsed = JSON.parse(data);
+    }
+    catch (err) {
+        throw new Error(`sliding-context: failed to parse serialized state: ${String(err)}`);
+    }
+    if (typeof parsed !== 'object' ||
+        parsed === null ||
+        parsed['version'] !== CURRENT_VERSION) {
+        throw new Error(`sliding-context: schema mismatch — expected version ${CURRENT_VERSION}, ` +
+            `got ${String(parsed?.['version'])}`);
+    }
+    return parsed;
+}
+//# sourceMappingURL=serialization.js.map

package/dist/serialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.js","sourceRoot":"","sources":["../src/serialization.ts"],"names":[],"mappings":";;AAQA,8BAEC;AAMD,kCAoBC;AAlCD,MAAM,eAAe,GAAG,CAAU,CAAC;AAEnC;;;GAGG;AACH,SAAgB,SAAS,CAAC,KAAmB;IAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAAC;AAChE,CAAC;AAED;;;GAGG;AACH,SAAgB,WAAW,CAAC,IAAY;IACtC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,sDAAsD,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,IACE,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACd,MAAkC,CAAC,SAAS,CAAC,KAAK,eAAe,EAClE,CAAC;QACD,MAAM,IAAI,KAAK,CACb,uDAAuD,eAAe,IAAI;YACxE,OAAO,MAAM,CAAE,MAAkC,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,CACpE,CAAC;IACJ,CAAC;IAED,OAAO,MAAsB,CAAC;AAChC,CAAC"}

package/dist/summarization.d.ts

@@ -0,0 +1,13 @@
+import type { Message, Summarizer } from './types';
+/**
+ * Invoke the summarizer with `messages` and the optional `existingSummary`.
+ * Returns the summary string on success, or `null` if the summarizer throws.
+ *
+ * The `prompt` function is intentionally not used here because the Summarizer
+ * type already receives the raw messages and existing summary — the caller
+ * (typically the LLM wrapper) is responsible for prompt construction.  The
+ * `prompt` parameter is retained for callers that want to inspect or log the
+ * prompt used.
+ */
+export declare function runSummarizer(messages: Message[], summarizer: Summarizer, existingSummary: string | undefined): Promise<string | null>;
+//# sourceMappingURL=summarization.d.ts.map

package/dist/summarization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarization.d.ts","sourceRoot":"","sources":["../src/summarization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEnD;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,OAAO,EAAE,EACnB,UAAU,EAAE,UAAU,EACtB,eAAe,EAAE,MAAM,GAAG,SAAS,GAClC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOxB"}

package/dist/summarization.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSummarizer = runSummarizer;
+/**
+ * Invoke the summarizer with `messages` and the optional `existingSummary`.
+ * Returns the summary string on success, or `null` if the summarizer throws.
+ *
+ * The `prompt` function is intentionally not used here because the Summarizer
+ * type already receives the raw messages and existing summary — the caller
+ * (typically the LLM wrapper) is responsible for prompt construction.  The
+ * `prompt` parameter is retained for callers that want to inspect or log the
+ * prompt used.
+ */
+async function runSummarizer(messages, summarizer, existingSummary) {
+    try {
+        const result = await summarizer(messages, existingSummary);
+        return result;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=summarization.js.map

package/dist/summarization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarization.js","sourceRoot":"","sources":["../src/summarization.ts"],"names":[],"mappings":";;AAYA,sCAWC;AArBD;;;;;;;;;GASG;AACI,KAAK,UAAU,aAAa,CACjC,QAAmB,EACnB,UAAsB,EACtB,eAAmC;IAEnC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;QAC3D,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/token-counter.d.ts

@@ -0,0 +1,7 @@
+import type { Message, TokenCounter } from './types';
+export declare const DEFAULT_MESSAGE_OVERHEAD = 4;
+/** Default token counter: Math.ceil(text.length / 4). Returns 0 for empty/null. */
+export declare function approximateTokenCounter(text: string): number;
+/** Count tokens for a single message including per-message overhead. */
+export declare function countMessageTokens(message: Message, tokenCounter: TokenCounter, messageOverhead: number): number;
+//# sourceMappingURL=token-counter.d.ts.map

package/dist/token-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-counter.d.ts","sourceRoot":"","sources":["../src/token-counter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAIrD,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,mFAAmF;AACnF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG5D;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,YAAY,EAC1B,eAAe,EAAE,MAAM,GACtB,MAAM,CA2BR"}

package/dist/token-counter.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_MESSAGE_OVERHEAD = void 0;
+exports.approximateTokenCounter = approximateTokenCounter;
+exports.countMessageTokens = countMessageTokens;
+const IMAGE_TOKEN_COST = 85;
+exports.DEFAULT_MESSAGE_OVERHEAD = 4;
+/** Default token counter: Math.ceil(text.length / 4). Returns 0 for empty/null. */
+function approximateTokenCounter(text) {
+    if (!text)
+        return 0;
+    return Math.ceil(text.length / 4);
+}
+/** Count tokens for a single message including per-message overhead. */
+function countMessageTokens(message, tokenCounter, messageOverhead) {
+    let contentTokens = 0;
+    const content = message.content;
+    if (Array.isArray(content)) {
+        for (const part of content) {
+            if (part.type === 'text' || part.type === undefined) {
+                contentTokens += tokenCounter(part.text ?? '');
+            }
+            else {
+                contentTokens += IMAGE_TOKEN_COST;
+            }
+        }
+    }
+    else if (typeof content === 'string' && content) {
+        contentTokens = tokenCounter(content);
+    }
+    let toolTokens = 0;
+    if (message.tool_calls && message.tool_calls.length > 0) {
+        toolTokens = tokenCounter(JSON.stringify(message.tool_calls));
+    }
+    let toolIdTokens = 0;
+    if (message.tool_call_id) {
+        toolIdTokens = tokenCounter(message.tool_call_id);
+    }
+    return contentTokens + toolTokens + toolIdTokens + messageOverhead;
+}
+//# sourceMappingURL=token-counter.js.map

package/dist/token-counter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-counter.js","sourceRoot":"","sources":["../src/token-counter.ts"],"names":[],"mappings":";;;AAOA,0DAGC;AAGD,gDA+BC;AA1CD,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAEf,QAAA,wBAAwB,GAAG,CAAC,CAAC;AAE1C,mFAAmF;AACnF,SAAgB,uBAAuB,CAAC,IAAY;IAClD,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,wEAAwE;AACxE,SAAgB,kBAAkB,CAChC,OAAgB,EAChB,YAA0B,EAC1B,eAAuB;IAEvB,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAkB,CAAC;IAE3C,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,OAAkD,EAAE,CAAC;YACtE,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACpD,aAAa,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YACjD,CAAC;iBAAM,CAAC;gBACN,aAAa,IAAI,gBAAgB,CAAC;YACpC,CAAC;QACH,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,EAAE,CAAC;QAClD,aAAa,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxD,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,aAAa,GAAG,UAAU,GAAG,YAAY,GAAG,eAAe,CAAC;AACrE,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,72 @@
+export interface ToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface Message {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    tool_calls?: ToolCall[];
+    tool_call_id?: string;
+    name?: string;
+}
+export type TokenCounter = (text: string) => number;
+export type Summarizer = (messages: Message[], existingSummary?: string) => Promise<string>;
+export type SummarizationStrategy = 'incremental' | 'rolling' | 'anchored';
+export type SummaryRole = 'system' | 'user';
+export interface EventHooks {
+    onEvict?: (messages: Message[], reason: string) => void;
+    onSummarize?: (inputMessages: Message[], existingSummary: string | undefined, newSummary: string, durationMs: number) => void;
+    onBudgetExceeded?: (totalTokens: number, budget: number) => void;
+    onSummaryCompressed?: (oldSummary: string, newSummary: string) => void;
+}
+export interface SlidingContextOptions {
+    tokenBudget: number;
+    systemPrompt?: string;
+    summarizer?: Summarizer;
+    strategy?: SummarizationStrategy;
+    maxSummaryTokens?: number;
+    minRecentTokens?: number;
+    summarizeThresholdTokens?: number;
+    summarizeThresholdMessages?: number;
+    tokenCounter?: TokenCounter;
+    messageOverhead?: number;
+    summaryRole?: SummaryRole;
+    maxSummaryRounds?: number;
+    anchor?: Message[];
+    maxAnchorTokens?: number;
+    hooks?: EventHooks;
+}
+export interface ContextState {
+    options: Omit<SlidingContextOptions, 'summarizer' | 'tokenCounter' | 'hooks'>;
+    messages: Message[];
+    summary: string | undefined;
+    anchor: Message[];
+    pendingBuffer: Message[];
+    summaryRounds: number;
+    tokenCounts: Record<string, number>;
+    version: 1;
+}
+export interface SlidingContext {
+    addMessage(message: Message): Promise<void>;
+    getMessages(): Message[];
+    getSummary(): string | undefined;
+    getTokenCount(): number;
+    getTokenBreakdown(): {
+        system: number;
+        anchor: number;
+        summary: number;
+        recent: number;
+        total: number;
+    };
+    getRecentMessageCount(): number;
+    getTotalMessageCount(): number;
+    setAnchor(messages: Message[]): void;
+    setTokenBudget(budget: number): void;
+    clear(): void;
+    serialize(): ContextState;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "sliding-context",
+  "version": "0.3.0",
+  "description": "Provider-agnostic sliding window context manager for LLMs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "lint": "eslint src/",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "@typescript-eslint/eslint-plugin": "^8.57.1",
+    "@typescript-eslint/parser": "^8.57.1",
+    "eslint": "^10.1.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0"
+  }
+}