@yuyuqueen/llm-context-kit 0.1.0

package/dist/compress-conversation.d.ts

@@ -0,0 +1,29 @@
+import type { CompressionConfig, ContextCompressor } from "./types.js";
+/**
+ * Create a context compressor that summarizes old conversation messages.
+ *
+ * Ported from OpenClaw's compact.ts core algorithm.
+ * Provider-agnostic: user provides their own LLM summarization callback.
+ *
+ * @example
+ * ```typescript
+ * const compressor = createContextCompressor({
+ *   summarize: async ({ messages, systemPrompt, signal }) => {
+ *     const response = await anthropic.messages.create({
+ *       model: "claude-haiku-4-5-20251001",
+ *       max_tokens: 4096,
+ *       system: systemPrompt,
+ *       messages: messages.map(m => ({ role: m.role, content: m.content })),
+ *     });
+ *     return response.content[0].text;
+ *   },
+ * });
+ *
+ * const result = await compressor.compress(messages);
+ * if (result.compressed) {
+ *   messages = result.messages; // Use compressed messages
+ * }
+ * ```
+ */
+export declare function createContextCompressor(config: CompressionConfig): ContextCompressor;
+//# sourceMappingURL=compress-conversation.d.ts.map

package/dist/compress-conversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compress-conversation.d.ts","sourceRoot":"","sources":["../src/compress-conversation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,iBAAiB,EAEjB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAwHpB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,iBAAiB,GACxB,iBAAiB,CA0GnB"}

package/dist/compress-conversation.js

@@ -0,0 +1,200 @@
+import { DEFAULT_PRESERVE_RECENT_TURNS, DEFAULT_COMPRESSION_TIMEOUT_MS, DEFAULT_SUMMARY_SYSTEM_PROMPT, COMPRESSION_MARKER, } from "./defaults.js";
+/**
+ * Check if a message contains image content blocks.
+ */
+function hasImageContent(msg) {
+    if (!Array.isArray(msg.content))
+        return false;
+    return msg.content.some((block) => block &&
+        typeof block === "object" &&
+        (block.type === "image" || block.type === "image_url"));
+}
+/**
+ * Strip image blocks from a message, keeping only text.
+ * Returns null if the message has no text content after stripping.
+ */
+function stripImages(msg) {
+    if (typeof msg.content === "string")
+        return msg;
+    if (!Array.isArray(msg.content))
+        return msg;
+    const textBlocks = msg.content.filter((block) => block &&
+        typeof block === "object" &&
+        block.type === "text");
+    if (textBlocks.length === 0)
+        return null;
+    return { ...msg, content: textBlocks };
+}
+/**
+ * Count conversation turns from the end.
+ * A turn is a user message + the following assistant message(s),
+ * including any tool_use/tool_result exchanges within that turn.
+ *
+ * Returns the index (exclusive) where the "recent" section begins.
+ */
+function findRecentTurnBoundary(messages, preserveTurns) {
+    if (preserveTurns <= 0)
+        return messages.length;
+    let turnsFound = 0;
+    let i = messages.length - 1;
+    while (i >= 0 && turnsFound < preserveTurns) {
+        // Skip assistant messages and tool messages (they belong to the current turn)
+        while (i >= 0 && messages[i].role !== "user") {
+            i--;
+        }
+        if (i < 0)
+            break;
+        // Found a user message — this is the start of a turn
+        // But if this user message only contains tool_result blocks (Anthropic format),
+        // it's part of a tool exchange, not a real user turn
+        const msg = messages[i];
+        const isToolResultOnly = Array.isArray(msg.content) &&
+            msg.content.length > 0 &&
+            msg.content.every((block) => block && typeof block === "object" && block.type === "tool_result");
+        if (!isToolResultOnly) {
+            turnsFound++;
+        }
+        i--;
+    }
+    // i + 1 is where the recent section starts
+    return i + 1;
+}
+/**
+ * Ensure tool_use/tool_result pairs are not split.
+ * If the boundary falls in the middle of a tool exchange,
+ * move it backward to include the full exchange.
+ */
+function adjustBoundaryForToolPairs(messages, boundary) {
+    // If boundary is at the start, nothing to adjust
+    if (boundary <= 0)
+        return 0;
+    // Check if the message at boundary is a tool_result (user msg with tool_result blocks)
+    // or a tool message — if so, we need to include the preceding assistant tool_use
+    let adjusted = boundary;
+    while (adjusted > 0) {
+        const msg = messages[adjusted];
+        const isToolRelated = msg.role === "tool" ||
+            (msg.role === "user" &&
+                Array.isArray(msg.content) &&
+                msg.content.some((block) => block && typeof block === "object" && block.type === "tool_result"));
+        if (!isToolRelated)
+            break;
+        adjusted--;
+    }
+    return adjusted;
+}
+/**
+ * Create a context compressor that summarizes old conversation messages.
+ *
+ * Ported from OpenClaw's compact.ts core algorithm.
+ * Provider-agnostic: user provides their own LLM summarization callback.
+ *
+ * @example
+ * ```typescript
+ * const compressor = createContextCompressor({
+ *   summarize: async ({ messages, systemPrompt, signal }) => {
+ *     const response = await anthropic.messages.create({
+ *       model: "claude-haiku-4-5-20251001",
+ *       max_tokens: 4096,
+ *       system: systemPrompt,
+ *       messages: messages.map(m => ({ role: m.role, content: m.content })),
+ *     });
+ *     return response.content[0].text;
+ *   },
+ * });
+ *
+ * const result = await compressor.compress(messages);
+ * if (result.compressed) {
+ *   messages = result.messages; // Use compressed messages
+ * }
+ * ```
+ */
+export function createContextCompressor(config) {
+    const { summarize, preserveRecentTurns = DEFAULT_PRESERVE_RECENT_TURNS, timeoutMs = DEFAULT_COMPRESSION_TIMEOUT_MS, summarySystemPrompt = DEFAULT_SUMMARY_SYSTEM_PROMPT, logger, } = config;
+    return {
+        async compress(messages) {
+            // 1. Separate system messages
+            const systemMessages = [];
+            const conversation = [];
+            for (const msg of messages) {
+                if (msg.role === "system") {
+                    systemMessages.push(msg);
+                }
+                else {
+                    conversation.push(msg);
+                }
+            }
+            // 2. Find boundary between old (compressible) and recent (preserved)
+            let boundary = findRecentTurnBoundary(conversation, preserveRecentTurns);
+            boundary = adjustBoundaryForToolPairs(conversation, boundary);
+            const oldMessages = conversation.slice(0, boundary);
+            const recentMessages = conversation.slice(boundary);
+            // 3. Check if there's anything to compress
+            if (oldMessages.length === 0) {
+                return {
+                    messages,
+                    compressed: false,
+                    removedCount: 0,
+                    description: "No messages to compress — conversation is short enough",
+                };
+            }
+            // 4. Prepare messages for summarization (strip images)
+            const messagesToSummarize = oldMessages
+                .map(stripImages)
+                .filter((m) => m !== null);
+            if (messagesToSummarize.length === 0) {
+                return {
+                    messages: [...systemMessages, ...recentMessages],
+                    compressed: true,
+                    removedCount: oldMessages.length,
+                    description: "Old messages contained only images — removed without summary",
+                };
+            }
+            // 5. Call summarize with timeout
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), timeoutMs);
+            let summary;
+            try {
+                summary = await summarize({
+                    messages: messagesToSummarize,
+                    systemPrompt: summarySystemPrompt,
+                    signal: controller.signal,
+                });
+            }
+            catch (error) {
+                clearTimeout(timer);
+                const isTimeout = error instanceof Error && error.name === "AbortError";
+                const reason = isTimeout
+                    ? "Compression timed out"
+                    : `Compression failed: ${error instanceof Error ? error.message : String(error)}`;
+                logger?.warn?.(reason);
+                return {
+                    messages,
+                    compressed: false,
+                    removedCount: 0,
+                    description: reason,
+                };
+            }
+            clearTimeout(timer);
+            // 6. Build compressed message array
+            const summaryMessage = {
+                role: "user",
+                content: `${COMPRESSION_MARKER}\n\n${summary}`,
+            };
+            const compressedMessages = [
+                ...systemMessages,
+                summaryMessage,
+                ...recentMessages,
+            ];
+            logger?.info?.(`Compressed ${oldMessages.length} messages into summary (${summary.length} chars)`);
+            return {
+                messages: compressedMessages,
+                compressed: true,
+                summary,
+                removedCount: oldMessages.length,
+                description: `Compressed ${oldMessages.length} messages into summary`,
+            };
+        },
+    };
+}
+//# sourceMappingURL=compress-conversation.js.map

package/dist/compress-conversation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compress-conversation.js","sourceRoot":"","sources":["../src/compress-conversation.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,6BAA6B,EAC7B,8BAA8B,EAC9B,6BAA6B,EAC7B,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAEvB;;GAEG;AACH,SAAS,eAAe,CAAC,GAAY;IACnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9C,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,CACrB,CAAC,KAAK,EAAE,EAAE,CACR,KAAK;QACL,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,CACzD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,GAAY;IAC/B,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO,GAAG,CAAC;IAE5C,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CACnC,CAAC,KAAK,EAAE,EAAE,CACR,KAAK;QACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,IAAI,KAAK,MAAM,CACxB,CAAC;IAEF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,OAAO,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AACzC,CAAC;AAED;;;;;;GAMG;AACH,SAAS,sBAAsB,CAC7B,QAAmB,EACnB,aAAqB;IAErB,IAAI,aAAa,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC,MAAM,CAAC;IAE/C,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAE5B,OAAO,CAAC,IAAI,CAAC,IAAI,UAAU,GAAG,aAAa,EAAE,CAAC;QAC5C,8EAA8E;QAC9E,OAAO,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC7C,CAAC,EAAE,CAAC;QACN,CAAC;QAED,IAAI,CAAC,GAAG,CAAC;YAAE,MAAM;QAEjB,qDAAqD;QACrD,gFAAgF;QAChF,qDAAqD;QACrD,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACxB,MAAM,gBAAgB,GACpB,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;YAC1B,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YACtB,GAAG,CAAC,OAAO,CAAC,KAAK,CACf,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,CACrE,CAAC;QAEJ,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,UAAU,EAAE,CAAC;QACf,CAAC;QAED,CAAC,EAAE,CAAC;IACN,CAAC;IAED,2CAA2C;IAC3C,OAAO,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,SAAS,0BAA0B,CACjC,QAAmB,EACnB,QAAgB;IAEhB,iDAAiD;IACjD,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAE5B,uFAAuF;IACvF,iFAAiF;IACjF,IAAI,QAAQ,GAAG,QAAQ,CAAC;IACxB,OAAO,QAAQ,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC/B,MAAM,aAAa,GACjB,GAAG,CAAC,IAAI,KAAK,MAAM;YACnB,CAAC,GAAG,CAAC,IAAI,KAAK,MAAM;gBAClB,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;gBAC1B,GAAG,CAAC,OAAO,CAAC,IAAI,CACd,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,CACrE,CAAC,CAAC;QAEP,IAAI,CAAC,aAAa;YAAE,MAAM;QAC1B,QAAQ,EAAE,CAAC;IACb,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAyB;IAEzB,MAAM,EACJ,SAAS,EACT,mBAAmB,GAAG,6BAA6B,EACnD,SAAS,GAAG,8BAA8B,EAC1C,mBAAmB,GAAG,6BAA6B,EACnD,MAAM,GACP,GAAG,MAAM,CAAC;IAEX,OAAO;QACL,KAAK,CAAC,QAAQ,CAAC,QAAmB;YAChC,8BAA8B;YAC9B,MAAM,cAAc,GAAc,EAAE,CAAC;YACrC,MAAM,YAAY,GAAc,EAAE,CAAC;YACnC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;gBAC3B,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC1B,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC3B,CAAC;qBAAM,CAAC;oBACN,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACzB,CAAC;YACH,CAAC;YAED,qEAAqE;YACrE,IAAI,QAAQ,GAAG,sBAAsB,CAAC,YAAY,EAAE,mBAAmB,CAAC,CAAC;YACzE,QAAQ,GAAG,0BAA0B,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;YAE9D,MAAM,WAAW,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;YACpD,MAAM,cAAc,GAAG,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAEpD,2CAA2C;YAC3C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7B,OAAO;oBACL,QAAQ;oBACR,UAAU,EAAE,KAAK;oBACjB,YAAY,EAAE,CAAC;oBACf,WAAW,EAAE,wDAAwD;iBACtE,CAAC;YACJ,CAAC;YAED,uDAAuD;YACvD,MAAM,mBAAmB,GAAG,WAAW;iBACpC,GAAG,CAAC,WAAW,CAAC;iBAChB,MAAM,CAAC,CAAC,CAAC,EAAgB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;YAE3C,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACrC,OAAO;oBACL,QAAQ,EAAE,CAAC,GAAG,cAAc,EAAE,GAAG,cAAc,CAAC;oBAChD,UAAU,EAAE,IAAI;oBAChB,YAAY,EAAE,WAAW,CAAC,MAAM;oBAChC,WAAW,EAAE,8DAA8D;iBAC5E,CAAC;YACJ,CAAC;YAED,iCAAiC;YACjC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;YAE9D,IAAI,OAAe,CAAC;YACpB,IAAI,CAAC;gBACH,OAAO,GAAG,MAAM,SAAS,CAAC;oBACxB,QAAQ,EAAE,mBAAmB;oBAC7B,YAAY,EAAE,mBAAmB;oBACjC,MAAM,EAAE,UAAU,CAAC,MAAM;iBAC1B,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,MAAM,SAAS,GACb,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC;gBACxD,MAAM,MAAM,GAAG,SAAS;oBACtB,CAAC,CAAC,uBAAuB;oBACzB,CAAC,CAAC,uBAAuB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBACpF,MAAM,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC;gBACvB,OAAO;oBACL,QAAQ;oBACR,UAAU,EAAE,KAAK;oBACjB,YAAY,EAAE,CAAC;oBACf,WAAW,EAAE,MAAM;iBACpB,CAAC;YACJ,CAAC;YACD,YAAY,CAAC,KAAK,CAAC,CAAC;YAEpB,oCAAoC;YACpC,MAAM,cAAc,GAAY;gBAC9B,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,GAAG,kBAAkB,OAAO,OAAO,EAAE;aAC/C,CAAC;YAEF,MAAM,kBAAkB,GAAG;gBACzB,GAAG,cAAc;gBACjB,cAAc;gBACd,GAAG,cAAc;aAClB,CAAC;YAEF,MAAM,EAAE,IAAI,EAAE,CACZ,cAAc,WAAW,CAAC,MAAM,2BAA2B,OAAO,CAAC,MAAM,SAAS,CACnF,CAAC;YAEF,OAAO;gBACL,QAAQ,EAAE,kBAAkB;gBAC5B,UAAU,EAAE,IAAI;gBAChB,OAAO;gBACP,YAAY,EAAE,WAAW,CAAC,MAAM;gBAChC,WAAW,EAAE,cAAc,WAAW,CAAC,MAAM,wBAAwB;aACtE,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/context-budget.d.ts

@@ -0,0 +1,11 @@
+import type { Message, BudgetConfig, ContextBudget } from "./types.js";
+/**
+ * Estimate token count for an array of messages.
+ * Uses a simple chars-per-token heuristic (default: 4 chars ≈ 1 token).
+ */
+export declare function estimateMessageTokens(messages: Message[], charsPerToken?: number): number;
+/**
+ * Create a context budget checker.
+ */
+export declare function createContextBudget(config: BudgetConfig): ContextBudget;
+//# sourceMappingURL=context-budget.d.ts.map

package/dist/context-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-budget.d.ts","sourceRoot":"","sources":["../src/context-budget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAgB,aAAa,EAAE,MAAM,YAAY,CAAC;AAiCrF;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,OAAO,EAAE,EACnB,aAAa,GAAE,MAAgC,GAC9C,MAAM,CAMR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CAuBvE"}

package/dist/context-budget.js

@@ -0,0 +1,68 @@
+import { DEFAULT_RESERVE_OUTPUT_TOKENS, DEFAULT_CHARS_PER_TOKEN } from "./defaults.js";
+/**
+ * Get total character count from a message's content.
+ */
+function getMessageChars(msg) {
+    const { content } = msg;
+    if (typeof content === "string") {
+        return content.length;
+    }
+    if (!Array.isArray(content)) {
+        return 0;
+    }
+    let total = 0;
+    for (const block of content) {
+        if (!block || typeof block !== "object")
+            continue;
+        const b = block;
+        if (b.type === "text" && typeof b.text === "string") {
+            total += b.text.length;
+        }
+        else if (b.type === "tool_result" || b.type === "tool_use") {
+            // Count nested text content
+            const nested = b.content ?? b.input;
+            if (typeof nested === "string") {
+                total += nested.length;
+            }
+            else if (typeof nested === "object") {
+                total += JSON.stringify(nested).length;
+            }
+        }
+    }
+    return total;
+}
+/**
+ * Estimate token count for an array of messages.
+ * Uses a simple chars-per-token heuristic (default: 4 chars ≈ 1 token).
+ */
+export function estimateMessageTokens(messages, charsPerToken = DEFAULT_CHARS_PER_TOKEN) {
+    let totalChars = 0;
+    for (const msg of messages) {
+        totalChars += getMessageChars(msg);
+    }
+    return Math.ceil(totalChars / charsPerToken);
+}
+/**
+ * Create a context budget checker.
+ */
+export function createContextBudget(config) {
+    const { contextWindowTokens } = config;
+    const reserveOutput = config.reserveOutputTokens ?? DEFAULT_RESERVE_OUTPUT_TOKENS;
+    const charsPerToken = config.charsPerToken ?? DEFAULT_CHARS_PER_TOKEN;
+    const availableForInput = contextWindowTokens - reserveOutput;
+    return {
+        check(messages) {
+            const estimatedTokens = estimateMessageTokens(messages, charsPerToken);
+            const availableTokens = Math.max(0, availableForInput - estimatedTokens);
+            const withinBudget = estimatedTokens <= availableForInput;
+            const utilizationPercent = availableForInput > 0
+                ? Math.min(100, Math.round((estimatedTokens / availableForInput) * 100))
+                : 100;
+            return { estimatedTokens, availableTokens, withinBudget, utilizationPercent };
+        },
+        estimateTokens(messages) {
+            return estimateMessageTokens(messages, charsPerToken);
+        },
+    };
+}
+//# sourceMappingURL=context-budget.js.map

package/dist/context-budget.js.map

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

package/dist/defaults.d.ts

@@ -0,0 +1,12 @@
+export declare const MAX_TOOL_RESULT_CONTEXT_SHARE = 0.3;
+export declare const HARD_MAX_TOOL_RESULT_CHARS = 400000;
+export declare const MIN_KEEP_CHARS = 2000;
+export declare const DEFAULT_TRUNCATION_SUFFIX: string;
+export declare const NEWLINE_CUT_THRESHOLD = 0.8;
+export declare const DEFAULT_PRESERVE_RECENT_TURNS = 4;
+export declare const DEFAULT_COMPRESSION_TIMEOUT_MS = 300000;
+export declare const DEFAULT_SUMMARY_SYSTEM_PROMPT: string;
+export declare const COMPRESSION_MARKER = "[Previous conversation compressed]";
+export declare const DEFAULT_RESERVE_OUTPUT_TOKENS = 4096;
+export declare const DEFAULT_CHARS_PER_TOKEN = 4;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAEjD,eAAO,MAAM,0BAA0B,SAAU,CAAC;AAElD,eAAO,MAAM,cAAc,OAAQ,CAAC;AAEpC,eAAO,MAAM,yBAAyB,QAGc,CAAC;AAErD,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAIzC,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAE/C,eAAO,MAAM,8BAA8B,SAAU,CAAC;AAEtD,eAAO,MAAM,6BAA6B,QAOqB,CAAC;AAEhE,eAAO,MAAM,kBAAkB,uCAAuC,CAAC;AAIvE,eAAO,MAAM,6BAA6B,OAAQ,CAAC;AAEnD,eAAO,MAAM,uBAAuB,IAAI,CAAC"}

package/dist/defaults.js

@@ -0,0 +1,23 @@
+// ===== Tool Result Truncation =====
+export const MAX_TOOL_RESULT_CONTEXT_SHARE = 0.3;
+export const HARD_MAX_TOOL_RESULT_CHARS = 400_000;
+export const MIN_KEEP_CHARS = 2_000;
+export const DEFAULT_TRUNCATION_SUFFIX = "\n\n[Content truncated — original was too large for the model's context window. " +
+    "The content above is a partial view. If you need more, request specific sections or use " +
+    "offset/limit parameters to read smaller chunks.]";
+export const NEWLINE_CUT_THRESHOLD = 0.8;
+// ===== Conversation Compression =====
+export const DEFAULT_PRESERVE_RECENT_TURNS = 4;
+export const DEFAULT_COMPRESSION_TIMEOUT_MS = 300_000;
+export const DEFAULT_SUMMARY_SYSTEM_PROMPT = "You are a conversation summarizer. Summarize the following conversation, preserving:\n" +
+    "- Key facts and decisions made\n" +
+    "- User preferences and requirements\n" +
+    "- Current task state and progress\n" +
+    "- Important file paths, code snippets, or technical details\n" +
+    "- Any errors encountered and their resolutions\n\n" +
+    "Be concise but comprehensive. Do not lose critical context.";
+export const COMPRESSION_MARKER = "[Previous conversation compressed]";
+// ===== Context Budget =====
+export const DEFAULT_RESERVE_OUTPUT_TOKENS = 4_096;
+export const DEFAULT_CHARS_PER_TOKEN = 4;
+//# sourceMappingURL=defaults.js.map

package/dist/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAErC,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAG,CAAC;AAEjD,MAAM,CAAC,MAAM,0BAA0B,GAAG,OAAO,CAAC;AAElD,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC;AAEpC,MAAM,CAAC,MAAM,yBAAyB,GACpC,kFAAkF;IAClF,0FAA0F;IAC1F,kDAAkD,CAAC;AAErD,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC,uCAAuC;AAEvC,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC;AAE/C,MAAM,CAAC,MAAM,8BAA8B,GAAG,OAAO,CAAC;AAEtD,MAAM,CAAC,MAAM,6BAA6B,GACxC,wFAAwF;IACxF,kCAAkC;IAClC,uCAAuC;IACvC,qCAAqC;IACrC,+DAA+D;IAC/D,oDAAoD;IACpD,6DAA6D,CAAC;AAEhE,MAAM,CAAC,MAAM,kBAAkB,GAAG,oCAAoC,CAAC;AAEvE,6BAA6B;AAE7B,MAAM,CAAC,MAAM,6BAA6B,GAAG,KAAK,CAAC;AAEnD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { createToolResultTruncator } from "./truncate-tool-results.js";
+export { createContextCompressor } from "./compress-conversation.js";
+export { createContextBudget, estimateMessageTokens } from "./context-budget.js";
+export { truncateText } from "./truncate-text.js";
+export { MAX_TOOL_RESULT_CONTEXT_SHARE, HARD_MAX_TOOL_RESULT_CHARS, MIN_KEEP_CHARS, DEFAULT_COMPRESSION_TIMEOUT_MS, DEFAULT_PRESERVE_RECENT_TURNS, } from "./defaults.js";
+export type { Message, TextBlock, ToolUseBlock, ToolResultBlock, ContentBlock, TruncateTextOptions, TruncationConfig, TruncationResult, ToolResultTruncator, SummaryFn, CompressionConfig, CompressionResult, ContextCompressor, BudgetConfig, BudgetStatus, ContextBudget, Logger, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAGjF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,EAC1B,cAAc,EACd,8BAA8B,EAC9B,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AAGvB,YAAY,EAEV,OAAO,EACP,SAAS,EACT,YAAY,EACZ,eAAe,EACf,YAAY,EAEZ,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EAEnB,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EAEjB,YAAY,EACZ,YAAY,EACZ,aAAa,EAEb,MAAM,GACP,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+// Factory functions
+export { createToolResultTruncator } from "./truncate-tool-results.js";
+export { createContextCompressor } from "./compress-conversation.js";
+export { createContextBudget, estimateMessageTokens } from "./context-budget.js";
+// Pure utility
+export { truncateText } from "./truncate-text.js";
+// Constants
+export { MAX_TOOL_RESULT_CONTEXT_SHARE, HARD_MAX_TOOL_RESULT_CHARS, MIN_KEEP_CHARS, DEFAULT_COMPRESSION_TIMEOUT_MS, DEFAULT_PRESERVE_RECENT_TURNS, } from "./defaults.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjF,eAAe;AACf,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,YAAY;AACZ,OAAO,EACL,6BAA6B,EAC7B,0BAA0B,EAC1B,cAAc,EACd,8BAA8B,EAC9B,6BAA6B,GAC9B,MAAM,eAAe,CAAC"}

package/dist/truncate-text.d.ts

@@ -0,0 +1,9 @@
+import type { TruncateTextOptions } from "./types.js";
+/**
+ * Truncate text to fit within maxChars, preserving the beginning.
+ * Uses newline-boundary optimization to avoid cutting mid-line.
+ *
+ * Ported from OpenClaw's truncateToolResultText.
+ */
+export declare function truncateText(text: string, maxChars: number, options?: TruncateTextOptions): string;
+//# sourceMappingURL=truncate-text.d.ts.map

package/dist/truncate-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate-text.d.ts","sourceRoot":"","sources":["../src/truncate-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAOtD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,MAAM,CAmBR"}

package/dist/truncate-text.js

@@ -0,0 +1,24 @@
+import { MIN_KEEP_CHARS, DEFAULT_TRUNCATION_SUFFIX, NEWLINE_CUT_THRESHOLD, } from "./defaults.js";
+/**
+ * Truncate text to fit within maxChars, preserving the beginning.
+ * Uses newline-boundary optimization to avoid cutting mid-line.
+ *
+ * Ported from OpenClaw's truncateToolResultText.
+ */
+export function truncateText(text, maxChars, options) {
+    if (text.length <= maxChars) {
+        return text;
+    }
+    const minKeep = options?.minKeepChars ?? MIN_KEEP_CHARS;
+    const suffix = options?.truncationSuffix ?? DEFAULT_TRUNCATION_SUFFIX;
+    const threshold = options?.newlineCutThreshold ?? NEWLINE_CUT_THRESHOLD;
+    const keepChars = Math.max(minKeep, maxChars - suffix.length);
+    // Try to break at a newline boundary to avoid cutting mid-line
+    let cutPoint = keepChars;
+    const lastNewline = text.lastIndexOf("\n", keepChars);
+    if (lastNewline > keepChars * threshold) {
+        cutPoint = lastNewline;
+    }
+    return text.slice(0, cutPoint) + suffix;
+}
+//# sourceMappingURL=truncate-text.js.map

package/dist/truncate-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate-text.js","sourceRoot":"","sources":["../src/truncate-text.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,QAAgB,EAChB,OAA6B;IAE7B,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,EAAE,YAAY,IAAI,cAAc,CAAC;IACxD,MAAM,MAAM,GAAG,OAAO,EAAE,gBAAgB,IAAI,yBAAyB,CAAC;IACtE,MAAM,SAAS,GAAG,OAAO,EAAE,mBAAmB,IAAI,qBAAqB,CAAC;IAExE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAE9D,+DAA+D;IAC/D,IAAI,QAAQ,GAAG,SAAS,CAAC;IACzB,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACtD,IAAI,WAAW,GAAG,SAAS,GAAG,SAAS,EAAE,CAAC;QACxC,QAAQ,GAAG,WAAW,CAAC;IACzB,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,MAAM,CAAC;AAC1C,CAAC"}

package/dist/truncate-tool-results.d.ts

@@ -0,0 +1,9 @@
+import type { TruncationConfig, ToolResultTruncator } from "./types.js";
+/**
+ * Create a tool result truncator.
+ *
+ * Ported from OpenClaw's tool-result-truncation.ts.
+ * Strips OpenClaw-specific session management; operates on message arrays.
+ */
+export declare function createToolResultTruncator(config?: TruncationConfig): ToolResultTruncator;
+//# sourceMappingURL=truncate-tool-results.d.ts.map

package/dist/truncate-tool-results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncate-tool-results.d.ts","sourceRoot":"","sources":["../src/truncate-tool-results.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,gBAAgB,EAEhB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AA+KpB;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,CAAC,EAAE,gBAAgB,GACxB,mBAAmB,CAgDrB"}

package/dist/truncate-tool-results.js

@@ -0,0 +1,173 @@
+import { truncateText } from "./truncate-text.js";
+import { MAX_TOOL_RESULT_CONTEXT_SHARE, HARD_MAX_TOOL_RESULT_CHARS, MIN_KEEP_CHARS, DEFAULT_TRUNCATION_SUFFIX, } from "./defaults.js";
+/**
+ * Default tool result detection.
+ * Handles both Anthropic format (content blocks with type "tool_result")
+ * and OpenAI format (role "tool").
+ */
+function defaultIsToolResult(msg) {
+    // OpenAI format
+    if (msg.role === "tool") {
+        return true;
+    }
+    // Anthropic format: user message containing tool_result blocks
+    if (msg.role === "user" && Array.isArray(msg.content)) {
+        return msg.content.some((block) => block && typeof block === "object" && block.type === "tool_result");
+    }
+    return false;
+}
+/**
+ * Get total text character count from content blocks.
+ * Handles both flat text blocks and nested tool_result blocks (Anthropic format).
+ */
+function getBlocksTextLength(blocks) {
+    let total = 0;
+    for (const block of blocks) {
+        if (!block || typeof block !== "object")
+            continue;
+        const b = block;
+        if (b.type === "text" && typeof b.text === "string") {
+            total += b.text.length;
+        }
+        else if (b.type === "tool_result") {
+            // Anthropic format: tool_result has nested content
+            const nested = b.content;
+            if (typeof nested === "string") {
+                total += nested.length;
+            }
+            else if (Array.isArray(nested)) {
+                total += getBlocksTextLength(nested);
+            }
+        }
+    }
+    return total;
+}
+/**
+ * Get total text character count from a message's content.
+ */
+function getMessageTextLength(msg) {
+    const { content } = msg;
+    if (typeof content === "string") {
+        return content.length;
+    }
+    if (!Array.isArray(content)) {
+        return 0;
+    }
+    return getBlocksTextLength(content);
+}
+/**
+ * Recursively truncate text blocks within a content block array.
+ * Handles both flat text blocks and nested tool_result content.
+ */
+function truncateBlocks(blocks, totalTextChars, maxChars, minKeepChars, truncationSuffix) {
+    return blocks.map((block) => {
+        if (!block || typeof block !== "object")
+            return block;
+        const b = block;
+        if (b.type === "text" && typeof b.text === "string") {
+            const blockShare = b.text.length / totalTextChars;
+            const blockBudget = Math.max(minKeepChars, Math.floor(maxChars * blockShare));
+            return {
+                ...b,
+                text: truncateText(b.text, blockBudget, {
+                    minKeepChars,
+                    truncationSuffix,
+                }),
+            };
+        }
+        if (b.type === "tool_result") {
+            const nested = b.content;
+            if (typeof nested === "string" && nested.length > maxChars) {
+                return {
+                    ...b,
+                    content: truncateText(nested, maxChars, {
+                        minKeepChars,
+                        truncationSuffix,
+                    }),
+                };
+            }
+            if (Array.isArray(nested)) {
+                return {
+                    ...b,
+                    content: truncateBlocks(nested, totalTextChars, maxChars, minKeepChars, truncationSuffix),
+                };
+            }
+        }
+        return block;
+    });
+}
+/**
+ * Truncate a single message's text content blocks to fit within maxChars.
+ * Returns a new message (does not mutate the original).
+ *
+ * Ported from OpenClaw's truncateToolResultMessage.
+ */
+function truncateMessage(msg, maxChars, minKeepChars, truncationSuffix) {
+    const { content } = msg;
+    // String content
+    if (typeof content === "string") {
+        if (content.length <= maxChars) {
+            return msg;
+        }
+        return {
+            ...msg,
+            content: truncateText(content, maxChars, {
+                minKeepChars,
+                truncationSuffix,
+            }),
+        };
+    }
+    if (!Array.isArray(content)) {
+        return msg;
+    }
+    const totalTextChars = getMessageTextLength(msg);
+    if (totalTextChars <= maxChars) {
+        return msg;
+    }
+    // Distribute budget proportionally among text blocks (handles nesting)
+    const newContent = truncateBlocks(content, totalTextChars, maxChars, minKeepChars, truncationSuffix);
+    return { ...msg, content: newContent };
+}
+/**
+ * Create a tool result truncator.
+ *
+ * Ported from OpenClaw's tool-result-truncation.ts.
+ * Strips OpenClaw-specific session management; operates on message arrays.
+ */
+export function createToolResultTruncator(config) {
+    const maxContextShare = config?.maxContextShare ?? MAX_TOOL_RESULT_CONTEXT_SHARE;
+    const hardMax = config?.hardMaxChars ?? HARD_MAX_TOOL_RESULT_CHARS;
+    const minKeep = config?.minKeepChars ?? MIN_KEEP_CHARS;
+    const suffix = config?.truncationSuffix ?? DEFAULT_TRUNCATION_SUFFIX;
+    const isToolResult = config?.isToolResult ?? defaultIsToolResult;
+    function calculateMaxChars(contextWindowTokens) {
+        const maxTokens = Math.floor(contextWindowTokens * maxContextShare);
+        const maxChars = maxTokens * 4;
+        return Math.min(maxChars, hardMax);
+    }
+    function isOversized(message, contextWindowTokens) {
+        if (!isToolResult(message)) {
+            return false;
+        }
+        const textLength = getMessageTextLength(message);
+        return textLength > calculateMaxChars(contextWindowTokens);
+    }
+    function truncate(messages, contextWindowTokens) {
+        const maxChars = calculateMaxChars(contextWindowTokens);
+        let truncatedCount = 0;
+        const newMessages = messages.map((msg) => {
+            if (!isToolResult(msg)) {
+                return msg;
+            }
+            const textLength = getMessageTextLength(msg);
+            if (textLength <= maxChars) {
+                return msg;
+            }
+            truncatedCount++;
+            return truncateMessage(msg, maxChars, minKeep, suffix);
+        });
+        return { messages: newMessages, truncatedCount };
+    }
+    return { truncate, isOversized, calculateMaxChars };
+}
+//# sourceMappingURL=truncate-tool-results.js.map

package/dist/truncate-tool-results.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,128 @@
+export type TextBlock = {
+    type: "text";
+    text: string;
+};
+export type ToolUseBlock = {
+    type: "tool_use";
+    id: string;
+    name: string;
+    input: unknown;
+};
+export type ToolResultBlock = {
+    type: "tool_result";
+    tool_use_id: string;
+    content?: string | ContentBlock[];
+};
+export type ContentBlock = TextBlock | ToolUseBlock | ToolResultBlock | {
+    type: string;
+    [key: string]: unknown;
+};
+/**
+ * Provider-agnostic message format.
+ * Compatible with Anthropic and OpenAI message shapes.
+ */
+export type Message = {
+    role: "user" | "assistant" | "system" | "tool" | (string & {});
+    content: string | ContentBlock[];
+    name?: string;
+    tool_use_id?: string;
+    [key: string]: unknown;
+};
+export type TruncateTextOptions = {
+    /** Minimum characters to keep (default: 2_000) */
+    minKeepChars?: number;
+    /** Suffix appended to truncated text */
+    truncationSuffix?: string;
+    /** Threshold for newline-boundary optimization (default: 0.8) */
+    newlineCutThreshold?: number;
+};
+export type TruncationConfig = {
+    /** Max share of context window for a single tool result (default: 0.3) */
+    maxContextShare?: number;
+    /** Hard character cap for any single tool result (default: 400_000) */
+    hardMaxChars?: number;
+    /** Minimum characters to keep when truncating (default: 2_000) */
+    minKeepChars?: number;
+    /** Custom suffix appended to truncated results */
+    truncationSuffix?: string;
+    /** Custom function to identify tool result messages */
+    isToolResult?: (msg: Message) => boolean;
+};
+export type TruncationResult = {
+    messages: Message[];
+    truncatedCount: number;
+};
+export type ToolResultTruncator = {
+    /** Truncate oversized tool results in a message array */
+    truncate: (messages: Message[], contextWindowTokens: number) => TruncationResult;
+    /** Check if a single message is an oversized tool result */
+    isOversized: (message: Message, contextWindowTokens: number) => boolean;
+    /** Calculate max chars allowed for a given context window */
+    calculateMaxChars: (contextWindowTokens: number) => number;
+};
+/**
+ * User-provided LLM callback for generating summaries.
+ * Provider-agnostic: user brings their own LLM client.
+ */
+export type SummaryFn = (params: {
+    messages: Message[];
+    systemPrompt: string;
+    signal?: AbortSignal;
+}) => Promise<string>;
+export type CompressionConfig = {
+    /** User-provided LLM function for summarization */
+    summarize: SummaryFn;
+    /** Number of recent conversation turns to preserve (default: 4) */
+    preserveRecentTurns?: number;
+    /** Timeout in ms for summarization call (default: 300_000) */
+    timeoutMs?: number;
+    /** Custom system prompt for the summarization LLM call */
+    summarySystemPrompt?: string;
+    /** Logger */
+    logger?: Logger;
+};
+export type CompressionResult = {
+    messages: Message[];
+    compressed: boolean;
+    /** Summary text that replaced old messages */
+    summary?: string;
+    /** How many messages were removed */
+    removedCount: number;
+    /** Description of what happened */
+    description?: string;
+};
+export type ContextCompressor = {
+    /** Compress a conversation by summarizing old messages */
+    compress: (messages: Message[]) => Promise<CompressionResult>;
+};
+export type BudgetConfig = {
+    /** Total context window size in tokens */
+    contextWindowTokens: number;
+    /** Reserve tokens for output (default: 4_096) */
+    reserveOutputTokens?: number;
+    /** Chars-per-token ratio for estimation (default: 4) */
+    charsPerToken?: number;
+};
+export type BudgetStatus = {
+    /** Estimated total tokens used */
+    estimatedTokens: number;
+    /** Available tokens remaining */
+    availableTokens: number;
+    /** Whether messages fit within budget */
+    withinBudget: boolean;
+    /** Utilization percentage (0-100) */
+    utilizationPercent: number;
+};
+export type ContextBudget = {
+    /** Check if messages fit within the context window */
+    check: (messages: Message[]) => BudgetStatus;
+    /** Estimate token count for messages */
+    estimateTokens: (messages: Message[]) => number;
+};
+export type Logger = {
+    debug?: (message: string) => void;
+    info?: (message: string) => void;
+    warn?: (message: string) => void;
+    error?: (message: string) => void;
+};
+//# 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 @@
+// ===== Content Blocks =====
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@yuyuqueen/llm-context-kit",
+  "version": "0.1.0",
+  "description": "Context window management for LLM applications. Tool result truncation, conversation compression, and context budget estimation.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "llm",
+    "context-window",
+    "truncation",
+    "compression",
+    "token",
+    "anthropic",
+    "openai",
+    "ai"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}