// Copyright (c) Microsoft. All rights reserved.
using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using Microsoft.Agents.AI.Compaction;
using Microsoft.Extensions.AI;
namespace Microsoft.Agents.AI.UnitTests.Compaction;
///
/// Contains tests for the class.
///
public class ContextWindowCompactionStrategyTests
{
[Fact]
public void Constructor_ValidParameters_SetsProperties()
{
// Arrange & Act
var strategy = new ContextWindowCompactionStrategy(
maxContextWindowTokens: 1_050_000,
maxOutputTokens: 128_000);
// Assert
Assert.Equal(1_050_000, strategy.MaxContextWindowTokens);
Assert.Equal(128_000, strategy.MaxOutputTokens);
Assert.Equal(922_000, strategy.InputBudgetTokens);
Assert.Equal(ContextWindowCompactionStrategy.DefaultToolEvictionThreshold, strategy.ToolEvictionThreshold);
Assert.Equal(ContextWindowCompactionStrategy.DefaultTruncationThreshold, strategy.TruncationThreshold);
}
[Fact]
public void Constructor_CustomThresholds_SetsProperties()
{
// Arrange & Act
var strategy = new ContextWindowCompactionStrategy(
maxContextWindowTokens: 1_000_000,
maxOutputTokens: 100_000,
toolEvictionThreshold: 0.3,
truncationThreshold: 0.6);
// Assert
Assert.Equal(900_000, strategy.InputBudgetTokens);
Assert.Equal(0.3, strategy.ToolEvictionThreshold);
Assert.Equal(0.6, strategy.TruncationThreshold);
}
[Theory]
[InlineData(0, 100)] // maxContextWindowTokens <= 0
[InlineData(-1, 100)] // maxContextWindowTokens negative
public void Constructor_InvalidContextWindow_Throws(int contextWindow, int maxOutput)
{
// Act & Assert
Assert.Throws(() =>
new ContextWindowCompactionStrategy(contextWindow, maxOutput));
}
[Theory]
[InlineData(1000, -1)] // maxOutputTokens negative
[InlineData(1000, 1000)] // maxOutputTokens == contextWindow
[InlineData(1000, 1001)] // maxOutputTokens > contextWindow
public void Constructor_InvalidOutputTokens_Throws(int contextWindow, int maxOutput)
{
// Act & Assert
Assert.Throws(() =>
new ContextWindowCompactionStrategy(contextWindow, maxOutput));
}
[Theory]
[InlineData(0.0)] // Zero threshold
[InlineData(-0.1)] // Negative threshold
[InlineData(1.1)] // Over 1.0
public void Constructor_InvalidToolEvictionThreshold_Throws(double threshold)
{
// Act & Assert
Assert.Throws(() =>
new ContextWindowCompactionStrategy(1000, 100, toolEvictionThreshold: threshold));
}
[Theory]
[InlineData(0.0)] // Zero threshold
[InlineData(-0.1)] // Negative threshold
[InlineData(1.1)] // Over 1.0
public void Constructor_InvalidTruncationThreshold_Throws(double threshold)
{
// Act & Assert
Assert.Throws(() =>
new ContextWindowCompactionStrategy(1000, 100, truncationThreshold: threshold));
}
[Fact]
public void Constructor_TruncationBelowToolEviction_Throws()
{
// Act & Assert
Assert.Throws(() =>
new ContextWindowCompactionStrategy(1000, 100, toolEvictionThreshold: 0.8, truncationThreshold: 0.5));
}
[Fact]
public async Task CompactAsync_BelowToolEvictionThreshold_NoCompactionAsync()
{
// Arrange — input budget = 900 tokens, tool eviction at 450, truncation at 720
// A few short messages should be well below any threshold.
var strategy = new ContextWindowCompactionStrategy(
maxContextWindowTokens: 1000,
maxOutputTokens: 100);
CompactionMessageIndex index = CompactionMessageIndex.Create(
[
new ChatMessage(ChatRole.User, "Hello"),
new ChatMessage(ChatRole.Assistant, "Hi there!"),
]);
// Act
bool result = await strategy.CompactAsync(index);
// Assert
Assert.False(result);
Assert.Equal(2, index.IncludedGroupCount);
}
[Fact]
public async Task CompactAsync_AboveTruncationThreshold_TruncatesOldestAsync()
{
// Arrange — use a budget of 5 tokens with truncation at 80% = 4 token threshold.
// Even the shortest messages will exceed this, ensuring truncation fires.
var strategy = new ContextWindowCompactionStrategy(
maxContextWindowTokens: 10,
maxOutputTokens: 5,
toolEvictionThreshold: 0.5,
truncationThreshold: 0.8);
// Verify internal budget calculation
Assert.Equal(5, strategy.InputBudgetTokens);
CompactionMessageIndex index = CompactionMessageIndex.Create(
[
new ChatMessage(ChatRole.User, "First user message"),
new ChatMessage(ChatRole.Assistant, "First response"),
new ChatMessage(ChatRole.User, "Second user message"),
new ChatMessage(ChatRole.Assistant, "Second response"),
]);
int groupsBefore = index.IncludedGroupCount;
int tokensBefore = index.IncludedTokenCount;
// Verify tokens actually exceed the truncation threshold (80% of 5 = 4)
Assert.True(tokensBefore > 4, $"Expected tokens > 4 but got {tokensBefore}");
Assert.True(groupsBefore > 1, $"Expected groups > 1 but got {groupsBefore}");
// Act
bool result = await strategy.CompactAsync(index);
// Assert — with tokens well above a 4-token threshold, truncation should fire
Assert.True(result, $"Expected compaction to occur. Tokens before: {tokensBefore}, groups before: {groupsBefore}, NonSystemGroups: {index.IncludedNonSystemGroupCount}");
Assert.True(index.IncludedGroupCount < groupsBefore);
}
[Fact]
public async Task CompactAsync_ToolCallsAboveEvictionThreshold_CollapsesToolCallsAsync()
{
// Arrange — very small budget so tool eviction fires.
// Input budget = 5, tool eviction at 50% = 2 token threshold.
var strategy = new ContextWindowCompactionStrategy(
maxContextWindowTokens: 10,
maxOutputTokens: 5,
toolEvictionThreshold: 0.5,
truncationThreshold: 0.9);
// Build messages with a tool call group: assistant with FunctionCallContent + tool result
var assistantMessage = new ChatMessage(ChatRole.Assistant, [new FunctionCallContent("call1", "get_data", arguments: new Dictionary { ["query"] = "test" })]);
var toolResultMessage = new ChatMessage(ChatRole.Tool, [new FunctionResultContent("call1", "Here is a long result with many words to ensure we exceed the token threshold")]);
var userMessage = new ChatMessage(ChatRole.User, "What did you find?");
var assistantResponse = new ChatMessage(ChatRole.Assistant, "Based on the results I found information.");
CompactionMessageIndex index = CompactionMessageIndex.Create(
[
assistantMessage,
toolResultMessage,
userMessage,
assistantResponse,
]);
// Act
bool result = await strategy.CompactAsync(index);
// Assert — compaction should succeed for tool calls above the eviction threshold.
// Do not assert on IncludedTokenCount because tool-result compaction preserves content
// in summary form and tokenization can make the count stay the same or increase.
Assert.True(result);
}
[Fact]
public void Constructor_EqualThresholds_Succeeds()
{
// Arrange & Act — truncation == tool eviction should be valid
var strategy = new ContextWindowCompactionStrategy(
maxContextWindowTokens: 1000,
maxOutputTokens: 100,
toolEvictionThreshold: 0.7,
truncationThreshold: 0.7);
// Assert
Assert.Equal(0.7, strategy.ToolEvictionThreshold);
Assert.Equal(0.7, strategy.TruncationThreshold);
}
[Fact]
public void Constructor_ZeroMaxOutputTokens_FullBudget()
{
// Arrange & Act
var strategy = new ContextWindowCompactionStrategy(
maxContextWindowTokens: 1_000_000,
maxOutputTokens: 0);
// Assert — entire context window is the input budget
Assert.Equal(1_000_000, strategy.InputBudgetTokens);
}
}