@strands-agents/sdk 1.4.0 → 1.6.0

package/dist/src/conversation-manager/__tests__/token-usage-middleware.test.js

@@ -0,0 +1,138 @@
+import { describe, it, expect, vi } from 'vitest';
+import { createTokenUsageMiddleware } from '../../context-manager/modes/agentic/agentic-context.js';
+import { Message, TextBlock } from '../../types/messages.js';
+import { Agent } from '../../agent/agent.js';
+import { MockMessageModel } from '../../__fixtures__/mock-message-model.js';
+function createMockModel(contextWindowLimit) {
+    return {
+        getConfig: () => ({ contextWindowLimit }),
+    };
+}
+function createContext(overrides = {}) {
+    return {
+        agent: {},
+        messages: [new Message({ role: 'user', content: [new TextBlock('hello')] })],
+        toolSpecs: [],
+        invocationState: {},
+        ...overrides,
+    };
+}
+describe('createTokenUsageMiddleware', () => {
+    it('returns context unchanged when projectedInputTokens is not set', async () => {
+        const middleware = createTokenUsageMiddleware(createMockModel(200_000));
+        const context = createContext();
+        const result = await middleware(context);
+        expect(result).toBe(context);
+    });
+    it('returns context unchanged when messages are empty', async () => {
+        const middleware = createTokenUsageMiddleware(createMockModel(200_000));
+        const context = createContext({
+            messages: [],
+            projectedInputTokens: 50_000,
+        });
+        const result = await middleware(context);
+        expect(result).toBe(context);
+    });
+    it('appends context status to last message content', async () => {
+        const middleware = createTokenUsageMiddleware(createMockModel(200_000));
+        const context = createContext({
+            projectedInputTokens: 50_000,
+        });
+        const result = await middleware(context);
+        expect(result.messages.length).toBe(1);
+        const lastMsg = result.messages[0];
+        expect(lastMsg.content.length).toBe(2);
+        const statusBlock = lastMsg.content[1];
+        expect(statusBlock.text).toContain('<context-status>');
+        expect(statusBlock.text).toContain('25.0%');
+        expect(statusBlock.text).toContain('<remaining>');
+        expect(statusBlock.text).toContain('</context-status>');
+    });
+    it('does not mutate the original messages array', async () => {
+        const middleware = createTokenUsageMiddleware(createMockModel(200_000));
+        const originalMessage = new Message({ role: 'user', content: [new TextBlock('hello')] });
+        const context = createContext({
+            messages: [originalMessage],
+            projectedInputTokens: 50_000,
+        });
+        const result = await middleware(context);
+        expect(result.messages).not.toBe(context.messages);
+        expect(originalMessage.content.length).toBe(1);
+    });
+    it('uses DEFAULT_CONTEXT_WINDOW_LIMIT when model config has no limit', async () => {
+        const middleware = createTokenUsageMiddleware(createMockModel(undefined));
+        const context = createContext({
+            projectedInputTokens: 100_000,
+        });
+        const result = await middleware(context);
+        const statusBlock = result.messages[0].content[1];
+        expect(statusBlock.text).toContain('<context-status>');
+        expect(statusBlock.text).toContain('50.0%');
+        expect(statusBlock.text).toContain('200,000');
+    });
+    it('preserves message metadata', async () => {
+        const middleware = createTokenUsageMiddleware(createMockModel(200_000));
+        const metadata = { usage: { inputTokens: 10, outputTokens: 5, totalTokens: 15 } };
+        const context = createContext({
+            messages: [new Message({ role: 'user', content: [new TextBlock('hello')], metadata })],
+            projectedInputTokens: 50_000,
+        });
+        const result = await middleware(context);
+        expect(result.messages[0].metadata).toEqual(metadata);
+    });
+    it('reports correct remaining tokens', async () => {
+        const middleware = createTokenUsageMiddleware(createMockModel(100_000));
+        const context = createContext({
+            projectedInputTokens: 80_000,
+        });
+        const result = await middleware(context);
+        const statusBlock = result.messages[0].content[1];
+        expect(statusBlock.text).toContain('80.0%');
+        expect(statusBlock.text).toContain('<remaining>~20,000 tokens</remaining>');
+    });
+});
+describe('token usage middleware integration', () => {
+    it('injects context status into messages sent to model on second call', async () => {
+        const model = new MockMessageModel()
+            .addTurn({ type: 'textBlock', text: 'First response' }, { usage: { inputTokens: 1000, outputTokens: 200, totalTokens: 1200 } })
+            .addTurn({ type: 'textBlock', text: 'Second response' }, { usage: { inputTokens: 2000, outputTokens: 300, totalTokens: 2300 } });
+        model.updateConfig({ contextWindowLimit: 100_000 });
+        const agent = new Agent({ model, contextManager: 'agentic', printer: false });
+        const streamSpy = vi.spyOn(model, 'stream');
+        await agent.invoke('First message');
+        await agent.invoke('Second message');
+        const secondCallMessages = streamSpy.mock.calls[1][0];
+        const lastMessage = secondCallMessages[secondCallMessages.length - 1];
+        const lastBlock = lastMessage.content[lastMessage.content.length - 1];
+        expect(lastBlock.text).toContain('<context-status>');
+        expect(lastBlock.text).toContain('100,000');
+        expect(lastBlock.text).toContain('<remaining>');
+    });
+    it('injects on first call when token estimation succeeds', async () => {
+        const model = new MockMessageModel().addTurn({ type: 'textBlock', text: 'First response' }, { usage: { inputTokens: 1000, outputTokens: 200, totalTokens: 1200 } });
+        model.updateConfig({ contextWindowLimit: 100_000 });
+        const agent = new Agent({ model, contextManager: 'agentic', printer: false });
+        const streamSpy = vi.spyOn(model, 'stream');
+        await agent.invoke('First message');
+        const firstCallMessages = streamSpy.mock.calls[0][0];
+        const lastMessage = firstCallMessages[firstCallMessages.length - 1];
+        const lastBlock = lastMessage.content[lastMessage.content.length - 1];
+        expect(lastBlock.text).toContain('<context-status>');
+        expect(lastBlock.text).toContain('100,000');
+    });
+    it('does not register middleware when contextManager is not agentic', async () => {
+        const model = new MockMessageModel()
+            .addTurn({ type: 'textBlock', text: 'First response' }, { usage: { inputTokens: 1000, outputTokens: 200, totalTokens: 1200 } })
+            .addTurn({ type: 'textBlock', text: 'Second response' }, { usage: { inputTokens: 2000, outputTokens: 300, totalTokens: 2300 } });
+        model.updateConfig({ contextWindowLimit: 100_000 });
+        const agent = new Agent({ model, printer: false });
+        const streamSpy = vi.spyOn(model, 'stream');
+        await agent.invoke('First message');
+        await agent.invoke('Second message');
+        const secondCallMessages = streamSpy.mock.calls[1][0];
+        const lastMessage = secondCallMessages[secondCallMessages.length - 1];
+        const lastBlock = lastMessage.content[lastMessage.content.length - 1];
+        expect(lastBlock.text).not.toContain('<context-status>');
+    });
+});
+//# sourceMappingURL=token-usage-middleware.test.js.map

package/dist/src/conversation-manager/__tests__/token-usage-middleware.test.js.map

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

package/dist/src/conversation-manager/compression/context-compression.d.ts

@@ -0,0 +1,39 @@
+import { Message } from '../../types/messages.js';
+import type { Model } from '../../models/model.js';
+export declare const DEFAULT_SUMMARIZATION_PROMPT = "You are a conversation summarizer. Provide a concise summary of the conversation history.\n\nFormat Requirements:\n- You MUST create a structured and concise summary in bullet-point format.\n- You MUST NOT respond conversationally.\n- You MUST NOT address the user directly.\n- You MUST NOT comment on tool availability.\n\nAssumptions:\n- You MUST NOT assume tool executions failed unless otherwise stated.\n\nTask:\nYour task is to create a structured summary document:\n- It MUST contain bullet points with key topics and questions covered\n- It MUST contain bullet points for all significant tools executed and their results\n- It MUST contain bullet points for any code or technical information shared\n- It MUST contain a section of key insights gained\n- It MUST format the summary in the third person\n\nExample format:\n\n## Conversation Summary\n* Topic 1: Key information\n* Topic 2: Key information\n\n## Tools Executed\n* Tool X: Result Y";
+/**
+ * Adjust a split point forward to avoid breaking tool use/result pairs.
+ *
+ * Walks the split point forward until the message at that position is neither
+ * an orphaned toolResult nor a toolUse without an immediately following toolResult.
+ *
+ * @throws If no valid split point can be found (walked past all messages)
+ */
+export declare function adjustSplitPointForToolPairs(messages: Message[], splitPoint: number): number;
+/**
+ * Find a valid trim point for truncation starting at `startIndex`.
+ *
+ * A valid trim point must:
+ * 1. Be a user message (required by some models)
+ * 2. Not be an orphaned toolResult
+ * 3. Not be a toolUse unless its toolResult immediately follows
+ *
+ * @returns The valid trim index, or `messages.length` if none found
+ */
+export declare function findValidTrimPoint(messages: Message[], startIndex: number): number;
+/**
+ * Generate a summary of the provided messages by calling the model.
+ *
+ * @returns A user-role message containing the model-generated summary
+ * @throws If the model fails to produce a response
+ */
+export declare function generateSummary(messagesToSummarize: Message[], model: Model, systemPrompt?: string): Promise<Message>;
+export type MessageTypeFilter = 'tools' | 'messages' | 'all';
+/**
+ * Returns true if the message matches the given type filter.
+ * - 'tools': message contains at least one toolUseBlock or toolResultBlock
+ * - 'messages': message contains no toolUseBlock or toolResultBlock
+ * - 'all': always matches
+ */
+export declare function matchesMessageType(message: Message, filter: MessageTypeFilter): boolean;
+//# sourceMappingURL=context-compression.d.ts.map

package/dist/src/conversation-manager/compression/context-compression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-compression.d.ts","sourceRoot":"","sources":["../../../../src/conversation-manager/compression/context-compression.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAa,MAAM,yBAAyB,CAAA;AAC5D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAElD,eAAO,MAAM,4BAA4B,47BA2BtB,CAAA;AAEnB;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAgC5F;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAgClF;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,mBAAmB,EAAE,OAAO,EAAE,EAC9B,KAAK,EAAE,KAAK,EACZ,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,OAAO,CAAC,CA2BlB;AAED,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,UAAU,GAAG,KAAK,CAAA;AAE5D;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAMvF"}

package/dist/src/conversation-manager/compression/context-compression.js

@@ -0,0 +1,150 @@
+import { Message, TextBlock } from '../../types/messages.js';
+export const DEFAULT_SUMMARIZATION_PROMPT = `You are a conversation summarizer. Provide a concise summary of the conversation \
+history.
+
+Format Requirements:
+- You MUST create a structured and concise summary in bullet-point format.
+- You MUST NOT respond conversationally.
+- You MUST NOT address the user directly.
+- You MUST NOT comment on tool availability.
+
+Assumptions:
+- You MUST NOT assume tool executions failed unless otherwise stated.
+
+Task:
+Your task is to create a structured summary document:
+- It MUST contain bullet points with key topics and questions covered
+- It MUST contain bullet points for all significant tools executed and their results
+- It MUST contain bullet points for any code or technical information shared
+- It MUST contain a section of key insights gained
+- It MUST format the summary in the third person
+
+Example format:
+
+## Conversation Summary
+* Topic 1: Key information
+* Topic 2: Key information
+
+## Tools Executed
+* Tool X: Result Y`;
+/**
+ * Adjust a split point forward to avoid breaking tool use/result pairs.
+ *
+ * Walks the split point forward until the message at that position is neither
+ * an orphaned toolResult nor a toolUse without an immediately following toolResult.
+ *
+ * @throws If no valid split point can be found (walked past all messages)
+ */
+export function adjustSplitPointForToolPairs(messages, splitPoint) {
+    if (splitPoint >= messages.length) {
+        return splitPoint;
+    }
+    while (splitPoint < messages.length) {
+        const message = messages[splitPoint];
+        const hasToolResult = message.content.some((block) => block.type === 'toolResultBlock');
+        if (hasToolResult) {
+            splitPoint++;
+            continue;
+        }
+        const hasToolUse = message.content.some((block) => block.type === 'toolUseBlock');
+        if (hasToolUse) {
+            const nextMessage = messages[splitPoint + 1];
+            const nextHasToolResult = nextMessage?.content.some((block) => block.type === 'toolResultBlock');
+            if (!nextHasToolResult) {
+                splitPoint++;
+                continue;
+            }
+        }
+        break;
+    }
+    if (splitPoint >= messages.length) {
+        throw new Error('Unable to find valid split point for summarization');
+    }
+    return splitPoint;
+}
+/**
+ * Find a valid trim point for truncation starting at `startIndex`.
+ *
+ * A valid trim point must:
+ * 1. Be a user message (required by some models)
+ * 2. Not be an orphaned toolResult
+ * 3. Not be a toolUse unless its toolResult immediately follows
+ *
+ * @returns The valid trim index, or `messages.length` if none found
+ */
+export function findValidTrimPoint(messages, startIndex) {
+    let trimIndex = startIndex;
+    while (trimIndex < messages.length) {
+        const message = messages[trimIndex];
+        if (!message)
+            break;
+        if (message.role !== 'user') {
+            trimIndex++;
+            continue;
+        }
+        const hasToolResult = message.content.some((block) => block.type === 'toolResultBlock');
+        if (hasToolResult) {
+            trimIndex++;
+            continue;
+        }
+        const hasToolUse = message.content.some((block) => block.type === 'toolUseBlock');
+        if (hasToolUse) {
+            const nextMessage = messages[trimIndex + 1];
+            const nextHasToolResult = nextMessage && nextMessage.content.some((block) => block.type === 'toolResultBlock');
+            if (!nextHasToolResult) {
+                trimIndex++;
+                continue;
+            }
+        }
+        break;
+    }
+    return trimIndex;
+}
+/**
+ * Generate a summary of the provided messages by calling the model.
+ *
+ * @returns A user-role message containing the model-generated summary
+ * @throws If the model fails to produce a response
+ */
+export async function generateSummary(messagesToSummarize, model, systemPrompt) {
+    const summarizationMessages = [
+        ...messagesToSummarize,
+        new Message({
+            role: 'user',
+            content: [new TextBlock('Please summarize this conversation.')],
+        }),
+    ];
+    const stream = model.streamAggregated(summarizationMessages, {
+        systemPrompt: systemPrompt ?? DEFAULT_SUMMARIZATION_PROMPT,
+    });
+    let result;
+    for (;;) {
+        result = await stream.next();
+        if (result.done)
+            break;
+    }
+    if (!result?.done || !result.value) {
+        throw new Error('Failed to generate summary: no response from model');
+    }
+    return new Message({
+        role: 'user',
+        content: result.value.message.content,
+    });
+}
+/**
+ * Returns true if the message matches the given type filter.
+ * - 'tools': message contains at least one toolUseBlock or toolResultBlock
+ * - 'messages': message contains no toolUseBlock or toolResultBlock
+ * - 'all': always matches
+ */
+export function matchesMessageType(message, filter) {
+    if (filter === 'all')
+        return true;
+    const hasTool = message.content.some((b) => b.type === 'toolUseBlock' || b.type === 'toolResultBlock');
+    if (filter === 'tools')
+        return hasTool;
+    if (filter === 'messages')
+        return !hasTool;
+    return false;
+}
+//# sourceMappingURL=context-compression.js.map

package/dist/src/conversation-manager/compression/context-compression.js.map

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

package/dist/src/conversation-manager/compression/pin-message.d.ts

@@ -0,0 +1,45 @@
+import { Message } from '../../types/messages.js';
+/**
+ * Check if a message is pinned, including tool-pair partner protection.
+ * Returns `true` if the message at `index` is pinned, or if it is the
+ * adjacent tool-pair partner (toolUse/toolResult) of a pinned message,
+ * matched by toolUseId.
+ *
+ * @param messages - The full messages array.
+ * @param index - The index to check.
+ * @returns `true` if the message or its tool-pair partner is pinned.
+ */
+export declare function isPinned(messages: Message[], index: number): boolean;
+/**
+ * Pin a message so it is protected from eviction during context reduction.
+ * Mutates the message in place by setting `metadata.custom.pinned = true`.
+ *
+ * @param messages - The messages array containing the message to pin.
+ * @param index - The index of the message to pin.
+ */
+export declare function pinMessage(messages: Message[], index: number): void;
+/**
+ * Pin the first N messages in the array permanently.
+ *
+ * @param messages - The messages array.
+ * @param count - Number of messages from the start to pin.
+ */
+export declare function applyPinFirst(messages: Message[], count: number): void;
+/**
+ * Partition a range of messages into pinned (protected) and unpinned arrays.
+ *
+ * @param messages - The full messages array.
+ * @param start - Start index of the range (inclusive).
+ * @param end - End index of the range (exclusive).
+ * @returns A tuple of [pinned, unpinned] message arrays.
+ */
+export declare function partitionPinned(messages: Message[], start: number, end: number): [Message[], Message[]];
+/**
+ * Unpin a message so it can be evicted during context reduction.
+ * Mutates the message in place by removing the `pinned` flag from metadata.
+ *
+ * @param messages - The messages array containing the message to unpin.
+ * @param index - The index of the message to unpin.
+ */
+export declare function unpinMessage(messages: Message[], index: number): void;
+//# sourceMappingURL=pin-message.d.ts.map

package/dist/src/conversation-manager/compression/pin-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pin-message.d.ts","sourceRoot":"","sources":["../../../../src/conversation-manager/compression/pin-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA2C,MAAM,yBAAyB,CAAA;AAE1F;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CA8BpE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAMnE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAItE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,CAWvG;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAWrE"}

package/dist/src/conversation-manager/compression/pin-message.js

@@ -0,0 +1,106 @@
+import { Message } from '../../types/messages.js';
+/**
+ * Check if a message is pinned, including tool-pair partner protection.
+ * Returns `true` if the message at `index` is pinned, or if it is the
+ * adjacent tool-pair partner (toolUse/toolResult) of a pinned message,
+ * matched by toolUseId.
+ *
+ * @param messages - The full messages array.
+ * @param index - The index to check.
+ * @returns `true` if the message or its tool-pair partner is pinned.
+ */
+export function isPinned(messages, index) {
+    const msg = messages[index];
+    if (msg.metadata?.custom?.pinned === true)
+        return true;
+    // Tool-pair partner protection: if this is a toolResult, check if prev toolUse is pinned
+    const toolResultBlocks = msg.content.filter((b) => b.type === 'toolResultBlock');
+    if (toolResultBlocks.length > 0 && index > 0) {
+        const prev = messages[index - 1];
+        if (prev.metadata?.custom?.pinned === true) {
+            const resultIds = new Set(toolResultBlocks.map((b) => b.toolUseId));
+            if (prev.content.some((b) => b.type === 'toolUseBlock' && resultIds.has(b.toolUseId))) {
+                return true;
+            }
+        }
+    }
+    // Tool-pair partner protection: if this is a toolUse, check if next toolResult is pinned
+    const toolUseBlocks = msg.content.filter((b) => b.type === 'toolUseBlock');
+    if (toolUseBlocks.length > 0 && index + 1 < messages.length) {
+        const next = messages[index + 1];
+        if (next.metadata?.custom?.pinned === true) {
+            const useIds = new Set(toolUseBlocks.map((b) => b.toolUseId));
+            if (next.content.some((b) => b.type === 'toolResultBlock' && useIds.has(b.toolUseId))) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Pin a message so it is protected from eviction during context reduction.
+ * Mutates the message in place by setting `metadata.custom.pinned = true`.
+ *
+ * @param messages - The messages array containing the message to pin.
+ * @param index - The index of the message to pin.
+ */
+export function pinMessage(messages, index) {
+    const message = messages[index];
+    message.metadata = {
+        ...message.metadata,
+        custom: { ...message.metadata?.custom, pinned: true },
+    };
+}
+/**
+ * Pin the first N messages in the array permanently.
+ *
+ * @param messages - The messages array.
+ * @param count - Number of messages from the start to pin.
+ */
+export function applyPinFirst(messages, count) {
+    for (let i = 0; i < Math.min(count, messages.length); i++) {
+        pinMessage(messages, i);
+    }
+}
+/**
+ * Partition a range of messages into pinned (protected) and unpinned arrays.
+ *
+ * @param messages - The full messages array.
+ * @param start - Start index of the range (inclusive).
+ * @param end - End index of the range (exclusive).
+ * @returns A tuple of [pinned, unpinned] message arrays.
+ */
+export function partitionPinned(messages, start, end) {
+    const pinned = [];
+    const unpinned = [];
+    for (let i = start; i < end; i++) {
+        if (isPinned(messages, i)) {
+            pinned.push(messages[i]);
+        }
+        else {
+            unpinned.push(messages[i]);
+        }
+    }
+    return [pinned, unpinned];
+}
+/**
+ * Unpin a message so it can be evicted during context reduction.
+ * Mutates the message in place by removing the `pinned` flag from metadata.
+ *
+ * @param messages - The messages array containing the message to unpin.
+ * @param index - The index of the message to unpin.
+ */
+export function unpinMessage(messages, index) {
+    const message = messages[index];
+    const { pinned: _, ...restCustom } = message.metadata?.custom ?? {};
+    const { custom: __, ...restMetadata } = message.metadata ?? {};
+    const hasCustom = Object.keys(restCustom).length > 0;
+    const hasMetadata = hasCustom || Object.keys(restMetadata).length > 0;
+    if (hasMetadata) {
+        message.metadata = { ...restMetadata, ...(hasCustom ? { custom: restCustom } : {}) };
+    }
+    else {
+        delete message.metadata;
+    }
+}
+//# sourceMappingURL=pin-message.js.map

package/dist/src/conversation-manager/compression/pin-message.js.map

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

package/dist/src/conversation-manager/conversation-manager.d.ts

@@ -8,6 +8,8 @@ import type { Plugin } from '../plugins/plugin.js';
 import type { LocalAgent } from '../types/agent.js';
 import { ContextWindowOverflowError } from '../errors.js';
 import type { Model } from '../models/model.js';
+/** @internal Default context window limit fallback when the model doesn't report one. */
+export declare const DEFAULT_CONTEXT_WINDOW_LIMIT = 200000;
 /**
  * Options passed to {@link ConversationManager.reduce}.
  *

package/dist/src/conversation-manager/conversation-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-manager.d.ts","sourceRoot":"","sources":["../../../src/conversation-manager/conversation-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAEnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAU/C;;;;;;;;GAQG;AACH,MAAM,MAAM,gCAAgC,GAAG;IAC7C;;OAEG;IACH,KAAK,EAAE,UAAU,CAAA;IAEjB;;;OAGG;IACH,KAAK,EAAE,KAAK,CAAA;IAEZ;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,0BAA0B,CAAA;CACnC,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC;;;;OAIG;IACH,oBAAoB,EAAE,MAAM,CAAA;CAC7B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,OAAO,GAAG,0BAA0B,CAAA;CAC5D,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,8BAAsB,mBAAoB,YAAW,MAAM;IACzD;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAE9B,SAAS,CAAC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,GAAG,SAAS,CAAA;IAE5D;;OAEG;gBACS,OAAO,CAAC,EAAE,0BAA0B;IAehD;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,gCAAgC,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAEtF;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;CA2CnC"}
+{"version":3,"file":"conversation-manager.d.ts","sourceRoot":"","sources":["../../../src/conversation-manager/conversation-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAEnD,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAO/C,yFAAyF;AACzF,eAAO,MAAM,4BAA4B,SAAU,CAAA;AAEnD;;;;;;;;GAQG;AACH,MAAM,MAAM,gCAAgC,GAAG;IAC7C;;OAEG;IACH,KAAK,EAAE,UAAU,CAAA;IAEjB;;;OAGG;IACH,KAAK,EAAE,KAAK,CAAA;IAEZ;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,0BAA0B,CAAA;CACnC,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC;;;;OAIG;IACH,oBAAoB,EAAE,MAAM,CAAA;CAC7B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,OAAO,GAAG,0BAA0B,CAAA;CAC5D,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,8BAAsB,mBAAoB,YAAW,MAAM;IACzD;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAE9B,SAAS,CAAC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,GAAG,SAAS,CAAA;IAE5D;;OAEG;gBACS,OAAO,CAAC,EAAE,0BAA0B;IAehD;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,gCAAgC,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAEtF;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;CA2CnC"}

package/dist/src/conversation-manager/conversation-manager.js

@@ -10,8 +10,8 @@ import { logger } from '../logging/logger.js';
 import { warnOnce } from '../logging/warn-once.js';
 /** Default compression threshold ratio. */
 const DEFAULT_COMPRESSION_THRESHOLD = 0.7;
-/** Default context window limit fallback when the model doesn't report one. */
-const DEFAULT_CONTEXT_WINDOW_LIMIT = 200_000;
+/** @internal Default context window limit fallback when the model doesn't report one. */
+export const DEFAULT_CONTEXT_WINDOW_LIMIT = 200_000;
 /**
  * Abstract base class for conversation history management strategies.
  *

package/dist/src/conversation-manager/conversation-manager.js.map

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

package/dist/src/conversation-manager/sliding-window-conversation-manager.d.ts

@@ -28,6 +28,11 @@ export type SlidingWindowConversationManagerConfig = {
      * - `false` or omitted: disabled, only reactive overflow recovery is used.
      */
     proactiveCompression?: boolean | ProactiveCompressionConfig;
+    /**
+     * Number of messages at the start of the conversation to permanently pin.
+     * Pinned messages are protected from eviction during context reduction.
+     */
+    pinFirst?: number;
 };
 /**
  * Implements a sliding window strategy for managing conversation history.
@@ -45,6 +50,8 @@ export type SlidingWindowConversationManagerConfig = {
 export declare class SlidingWindowConversationManager extends ConversationManager {
     private readonly _windowSize;
     private readonly _shouldTruncateResults;
+    private readonly _pinFirst;
+    private _pinFirstApplied;
     /**
      * Unique identifier for this conversation manager.
      */

package/dist/src/conversation-manager/sliding-window-conversation-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sliding-window-conversation-manager.d.ts","sourceRoot":"","sources":["../../../src/conversation-manager/sliding-window-conversation-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAEnD,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,KAAK,gCAAgC,EACtC,MAAM,2BAA2B,CAAA;AAkElC;;GAEG;AACH,MAAM,MAAM,sCAAsC,GAAG;IACnD;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAE/B;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,OAAO,GAAG,0BAA0B,CAAA;CAC5D,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,gCAAiC,SAAQ,mBAAmB;IACvE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IAEhD;;OAEG;IACH,QAAQ,CAAC,IAAI,iDAAgD;IAE7D;;;;OAIG;gBACS,MAAM,CAAC,EAAE,sCAAsC;IAM3D;;;;;;;;;OASG;IACa,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAQlD;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,gCAAgC,GAAG,OAAO;IAInE;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,cAAc;IAkEtB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,oBAAoB;IAoI5B;;;;;;;;OAQG;IACH,OAAO,CAAC,iCAAiC;CAa1C"}
+{"version":3,"file":"sliding-window-conversation-manager.d.ts","sourceRoot":"","sources":["../../../src/conversation-manager/sliding-window-conversation-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAEnD,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,KAAK,gCAAgC,EACtC,MAAM,2BAA2B,CAAA;AAoElC;;GAEG;AACH,MAAM,MAAM,sCAAsC,GAAG;IACnD;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAE/B;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,OAAO,GAAG,0BAA0B,CAAA;IAE3D;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,gCAAiC,SAAQ,mBAAmB;IACvE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,gBAAgB,CAAQ;IAEhC;;OAEG;IACH,QAAQ,CAAC,IAAI,iDAAgD;IAE7D;;;;OAIG;gBACS,MAAM,CAAC,EAAE,sCAAsC;IAO3D;;;;;;;;;OASG;IACa,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAQlD;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,gCAAgC,GAAG,OAAO;IAInE;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,cAAc;IAmDtB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,oBAAoB;IAoI5B;;;;;;;;OAQG;IACH,OAAO,CAAC,iCAAiC;CAY1C"}