@linnlabs/linnkit 0.9.0 → 0.10.0

package/dist/context-manager.d.cts

@@ -1,11 +1,11 @@
 import { A as AiMessage, a as AssistantMessage } from './messages-XthmnHZ3.cjs';
-import { C as ChatMessage, P as ProviderContext$2, M as MessageProcessingState, B as BaseContextProvider$2, a as ProviderResult, I as IContextProvider$2, b as ContextTraceCollector, S as SummarizationCallbacks, G as GenerateRequest, c as GenerateResponse, d as ContextTrace } from './context-trace-HE2qY5Q-.cjs';
-export { e as ChatDocumentMetadata, f as ChatProjectMetadata, g as ChatUserQuote, h as ContextProviderError, i as ContextProviderErrorCode, j as ContextProviderErrorOptions, k as ContextTraceEvent, l as ContextTraceMessageDecisionEvent, m as ContextTraceProviderEvent, n as MessageRole, o as MessageType, R as RecentRejection, p as SUMMARIZATION_FAILED_ERROR_CODE, T as TOOL_HISTORY_OVERFLOW_ERROR_CODE, q as isContextProviderError } from './context-trace-HE2qY5Q-.cjs';
+import { C as ChatMessage, P as ProviderContext$2, M as MessageProcessingState, B as BaseContextProvider$2, a as ProviderResult, I as IContextProvider$2, b as ContextTraceCollector, S as SummarizationCallbacks, G as GenerateRequest, c as GenerateResponse, d as ContextTrace } from './context-trace-BHKDS-eq.cjs';
+export { e as ChatDocumentMetadata, f as ChatProjectMetadata, g as ChatUserQuote, h as ContextProviderError, i as ContextProviderErrorCode, j as ContextProviderErrorOptions, k as ContextTraceEvent, l as ContextTraceMessageDecisionEvent, m as ContextTraceProviderEvent, n as MessageRole, o as MessageType, R as RecentRejection, p as SUMMARIZATION_FAILED_ERROR_CODE, T as TOOL_HISTORY_OVERFLOW_ERROR_CODE, q as isContextProviderError } from './context-trace-BHKDS-eq.cjs';
 export { C as CHECKPOINT_MARKER_TYPE } from './checkpointMarker-DAI3wUQu.cjs';
-import { u as AgentSpecToolOutputPolicy, l as AgentSpecProviderReplayPolicy, d as AgentSpecCheckpointPolicy, n as AgentSpecSummarizationPolicy, g as AgentSpecContextTracePolicy, p as AgentSpecSystemReminderPolicy, a as AgentSpec, e as AgentSpecContextPolicy, f as AgentSpecContextPolicyInput } from './agentSpec-EkmviZjy.cjs';
-import { e as RuntimeEvent } from './todo-B1PmDlp3.cjs';
+import { A as AgentSpecToolOutputPolicy, a as AgentSpecProviderReplayPolicy, b as AgentSpecCheckpointPolicy, c as AgentSpecSummarizationPolicy, d as AgentSpecContextTracePolicy, e as AgentSpecSystemReminderPolicy, f as AgentSpec, g as AgentSpecContextPolicy, h as AgentSpecContextPolicyInput } from './agentSpec-Du4Iye0q.cjs';
+import { R as RuntimeEvent } from './todo-Ca8llpRQ.cjs';
 import { T as TokenizerPort } from './tokenizer-DH_JXv-H.cjs';
-import { a as ToolArgs } from './toolContracts-CLkQmhTG.cjs';
+import { T as ToolArgs } from './toolContracts-Bm3EZ1UM.cjs';
 import 'zod';
 import './ai-engine.types-BpeU_XQG.cjs';
 
@@ -118,6 +118,7 @@ interface AgentContextBuilderConfigOverrides {
 interface AgentSpecPreprocessorOptions {
     toolHistory?: {
         strategy?: 'per-pair' | 'per-run' | 'none';
+        retentionMode?: 'drop' | 'compress';
         keepLatestToolPairs?: number;
         keepLatestRuns?: number;
         maxInteractionGroups?: number;
@@ -243,6 +244,26 @@ declare class FenceLifetimePreprocessor extends BasePreprocessor$1 {
     process(messages: AiMessage[], context: PreprocessorContext$1): Promise<PreprocessorResult$1>;
 }
 
+interface CurrentTurnMessageAssemblerOptions {
+    fenceRegistry: FenceRegistry;
+}
+/**
+ * 组装当前轮 prompt block。
+ *
+ * 中文说明：
+ * - formatter 只负责把单条消息转成 wire 形态，不负责猜测相邻消息是否应该合并；
+ * - 当前轮 system-side fence 在这里合入 system_prompt；
+ * - 当前轮 user-side fence 在这里合入同一条 user_input，未注入的 fence 不产生空标签。
+ */
+declare class CurrentTurnMessageAssembler extends BasePreprocessor$1 {
+    readonly name = "CurrentTurnMessageAssembler";
+    readonly description = "Assembles current-turn fences into system_prompt and user_input messages";
+    readonly priority = 10;
+    private readonly fenceRegistry;
+    constructor(options: CurrentTurnMessageAssemblerOptions);
+    process(messages: AiMessage[], _context: PreprocessorContext$1): Promise<PreprocessorResult$1>;
+}
+
 interface SummarizationConfig {
     SUMMARIZATION_TRIGGER_THRESHOLD: number;
     SUMMARY_OLDEST_MESSAGES_PERCENTAGE: number;
@@ -372,6 +393,11 @@ interface AgentConfig {
     defaultTools: string[];
     timeoutMs: number;
     debug: boolean;
+    /**
+     * @deprecated 不再参与上下文裁剪。
+     * 中文备注：Agent 历史保留现在由 `contextPolicy.budget` 与 `contextPolicy.toolHistory`
+     * 共同决定；保留这个字段只是为了兼容可能读取 `DEFAULT_AGENT_CONFIG` 的旧接入方。
+     */
     maxHistoryLength: number;
     tokenBudget: {
         maxTokens: number;
@@ -821,8 +847,8 @@ declare class AgentCoreContextProvider extends BaseContextProvider$1 {
  * @file src/agent/context/providers/AgentWorkingMemoryProvider.ts
  * @description Agent专用工作记忆填充层Provider - 第二阶段上下文构建
  *
- * 🎯 职责: 实现Agent的P1-P4优先级填充策略
- * 📖 策略: P1(工具交互) > P2(纯文本对话) > P3(历史工具交互) > P4(循环填充)
+ * 🎯 职责: 实现Agent的P1-P3优先级填充策略
+ * 📖 策略: P1(工具交互) > P2(纯文本对话) > P3(历史工具交互)
  * ✨ Agent特性: 工具调用优先级、配对保留策略
  * 🔧 核心逻辑: 保留工具调用时，必须确保其对应的另一半也被保留
  */
@@ -1190,8 +1216,10 @@ declare abstract class BasePreprocessor implements IPreprocessor {
 
 type ToolHistoryCompressionStrategy = 'per-pair' | 'per-run' | 'none';
 type ToolHistoryOverflowStrategy = 'keep-latest' | 'fail-fast';
+type ToolHistoryRetentionMode = 'drop' | 'compress';
 interface ToolHistoryCompressorOptions {
     strategy?: ToolHistoryCompressionStrategy;
+    retentionMode?: ToolHistoryRetentionMode;
     keepLatestToolPairs?: number;
     keepLatestRuns?: number;
     maxInteractionGroups?: number;
@@ -1200,26 +1228,30 @@ interface ToolHistoryCompressorOptions {
     maxOutputSummaryTokens?: number;
 }
 /**
- * 工具历史压缩预处理器。
+ * 工具历史保留预处理器。
  *
  * 三种策略边界：
- * - per-pair：旧行为，按全局最近 N 组完整工具交互保留，其余压成自然语言记录。
+ * - per-pair：按全局最近 N 组完整工具交互保留，其余按 retentionMode 处理。
  * - per-run：按 user_input 划分 run，完整保留最近 K 个历史 run 内的工具组，避免腰斩同一轮工具链。
  * - none：不做常规压缩，仅在 maxInteractionGroups 显式触发时执行安全阀。
  *
+ * retentionMode 边界：
+ * - drop：默认行为。旧工具组超过保留窗口后直接移除，避免改写历史前缀和制造伪 final_answer。
+ * - compress：兼容旧行为。把旧工具组替换为自然语言摘要，用于小上下文或审计友好的历史线索保留。
+ *
  * 注意：单个 tool_output 的 token 截断不在这里做，那是 WorkingMemory 阶段
- * ToolPairTruncator 的职责；本处理器只决定“工具组是原样保留还是压缩为摘要消息”。
+ * ToolPairTruncator 的职责；本处理器只决定“工具组是原样保留、删除，还是压缩为摘要消息”。
  */
 declare class ToolHistoryCompressorPreprocessor extends BasePreprocessor {
     readonly name = "ToolHistoryCompressorPreprocessor";
-    readonly description = "\u5DE5\u5177\u5386\u53F2\u538B\u7F29\u5904\u7406\u5668 - \u5C06\u8F83\u65E9\u7684\u5386\u53F2\u5DE5\u5177\u8C03\u7528\u5BF9\u538B\u7F29\u4E3A\u81EA\u7136\u8BED\u8A00\u8BB0\u5F55\u6D88\u606F";
+    readonly description = "\u5DE5\u5177\u5386\u53F2\u4FDD\u7559\u5904\u7406\u5668 - \u6309\u7B56\u7565\u4FDD\u7559\u3001\u5220\u9664\u6216\u538B\u7F29\u8F83\u65E9\u7684\u5386\u53F2\u5DE5\u5177\u8C03\u7528\u5BF9";
     readonly priority = 0;
     private summarizer;
     private readonly options;
     constructor(options?: ToolHistoryCompressorOptions);
     process(messages: AiMessage[], context: PreprocessorContext): Promise<PreprocessorResult>;
     shouldSkip(messages: AiMessage[], context: PreprocessorContext): boolean;
-    private compressToolCallPairsInHistory;
+    private processToolCallPairsInHistory;
     private selectGroupsToKeep;
     private enforceMaxInteractionGroups;
     private compressToolInteractionGroup;
@@ -1335,7 +1367,7 @@ interface PreprocessorPipelineResult {
  * 创建默认的Agent预处理器注册表
  *
  * 🔥 这里定义了Agent预处理管道的默认配置：
- * 1. ToolHistoryCompressorPreprocessor (priority: 0) - 工具历史压缩，最先执行
+ * 1. ToolHistoryCompressorPreprocessor (priority: 0) - 工具历史保留/删除，最先执行
  * 2. ToolReplayProtocolGuardPreprocessor (priority: 0.5) - 工具回放协议守卫，仅治理历史轮次
  * 3. HistoryPurificationPreprocessor (priority: 1) - Agent历史净化，在压缩后执行
  *
@@ -1354,6 +1386,8 @@ declare function createDefaultAgentPreprocessorPipeline(context?: PreprocessorCo
 
 type index$4_BasePreprocessor = BasePreprocessor;
 declare const index$4_BasePreprocessor: typeof BasePreprocessor;
+type index$4_CurrentTurnMessageAssembler = CurrentTurnMessageAssembler;
+declare const index$4_CurrentTurnMessageAssembler: typeof CurrentTurnMessageAssembler;
 type index$4_DefaultAgentPreprocessorRegistryOptions = DefaultAgentPreprocessorRegistryOptions;
 type index$4_FenceLifetimePreprocessor = FenceLifetimePreprocessor;
 declare const index$4_FenceLifetimePreprocessor: typeof FenceLifetimePreprocessor;
@@ -1373,6 +1407,7 @@ type index$4_ToolHistoryCompressorOptions = ToolHistoryCompressorOptions;
 type index$4_ToolHistoryCompressorPreprocessor = ToolHistoryCompressorPreprocessor;
 declare const index$4_ToolHistoryCompressorPreprocessor: typeof ToolHistoryCompressorPreprocessor;
 type index$4_ToolHistoryOverflowStrategy = ToolHistoryOverflowStrategy;
+type index$4_ToolHistoryRetentionMode = ToolHistoryRetentionMode;
 type index$4_ToolReplayProtocolGuardOptions = ToolReplayProtocolGuardOptions;
 type index$4_ToolReplayProtocolGuardPreprocessor = ToolReplayProtocolGuardPreprocessor;
 declare const index$4_ToolReplayProtocolGuardPreprocessor: typeof ToolReplayProtocolGuardPreprocessor;
@@ -1381,7 +1416,7 @@ declare const index$4_createDefaultAgentPreprocessorPipeline: typeof createDefau
 declare const index$4_createDefaultAgentPreprocessorRegistry: typeof createDefaultAgentPreprocessorRegistry;
 declare const index$4_resolveToolReplayProtocolPolicy: typeof resolveToolReplayProtocolPolicy;
 declare namespace index$4 {
-  export { index$4_BasePreprocessor as BasePreprocessor, type index$4_DefaultAgentPreprocessorRegistryOptions as DefaultAgentPreprocessorRegistryOptions, index$4_FenceLifetimePreprocessor as FenceLifetimePreprocessor, index$4_HistoryPurificationPreprocessor as HistoryPurificationPreprocessor, type index$4_IPreprocessor as IPreprocessor, type index$4_MissingSidecarBehavior as MissingSidecarBehavior, type index$4_PreprocessorContext as PreprocessorContext, index$4_PreprocessorPipeline as PreprocessorPipeline, type index$4_PreprocessorPipelineResult as PreprocessorPipelineResult, index$4_PreprocessorRegistry as PreprocessorRegistry, type index$4_PreprocessorResult as PreprocessorResult, type index$4_ToolHistoryCompressionStrategy as ToolHistoryCompressionStrategy, type index$4_ToolHistoryCompressorOptions as ToolHistoryCompressorOptions, index$4_ToolHistoryCompressorPreprocessor as ToolHistoryCompressorPreprocessor, type index$4_ToolHistoryOverflowStrategy as ToolHistoryOverflowStrategy, type index$4_ToolReplayProtocolGuardOptions as ToolReplayProtocolGuardOptions, index$4_ToolReplayProtocolGuardPreprocessor as ToolReplayProtocolGuardPreprocessor, type index$4_ToolReplayProtocolPolicy as ToolReplayProtocolPolicy, index$4_createDefaultAgentPreprocessorPipeline as createDefaultAgentPreprocessorPipeline, index$4_createDefaultAgentPreprocessorRegistry as createDefaultAgentPreprocessorRegistry, index$4_resolveToolReplayProtocolPolicy as resolveToolReplayProtocolPolicy };
+  export { index$4_BasePreprocessor as BasePreprocessor, index$4_CurrentTurnMessageAssembler as CurrentTurnMessageAssembler, type index$4_DefaultAgentPreprocessorRegistryOptions as DefaultAgentPreprocessorRegistryOptions, index$4_FenceLifetimePreprocessor as FenceLifetimePreprocessor, index$4_HistoryPurificationPreprocessor as HistoryPurificationPreprocessor, type index$4_IPreprocessor as IPreprocessor, type index$4_MissingSidecarBehavior as MissingSidecarBehavior, type index$4_PreprocessorContext as PreprocessorContext, index$4_PreprocessorPipeline as PreprocessorPipeline, type index$4_PreprocessorPipelineResult as PreprocessorPipelineResult, index$4_PreprocessorRegistry as PreprocessorRegistry, type index$4_PreprocessorResult as PreprocessorResult, type index$4_ToolHistoryCompressionStrategy as ToolHistoryCompressionStrategy, type index$4_ToolHistoryCompressorOptions as ToolHistoryCompressorOptions, index$4_ToolHistoryCompressorPreprocessor as ToolHistoryCompressorPreprocessor, type index$4_ToolHistoryOverflowStrategy as ToolHistoryOverflowStrategy, type index$4_ToolHistoryRetentionMode as ToolHistoryRetentionMode, type index$4_ToolReplayProtocolGuardOptions as ToolReplayProtocolGuardOptions, index$4_ToolReplayProtocolGuardPreprocessor as ToolReplayProtocolGuardPreprocessor, type index$4_ToolReplayProtocolPolicy as ToolReplayProtocolPolicy, index$4_createDefaultAgentPreprocessorPipeline as createDefaultAgentPreprocessorPipeline, index$4_createDefaultAgentPreprocessorRegistry as createDefaultAgentPreprocessorRegistry, index$4_resolveToolReplayProtocolPolicy as resolveToolReplayProtocolPolicy };
 }
 
 interface ToolManagerRegistry extends ToolSummaryProvider {
@@ -1470,6 +1505,7 @@ declare class AgentMessageOrchestrator {
     private resolvePreprocessorModel;
     private resolveContextPolicy;
     private applyContextPolicy;
+    private resolveEffectiveContextBudget;
     processAgentConversation(request: AgentProfileRequest, history: RuntimeEvent[], toolManager: ToolManager, callbacks?: SummarizationCallbacks, extraOptions?: {
         generate?: (request: GenerateRequest) => Promise<GenerateResponse>;
     }): Promise<AgentProcessingResult>;
@@ -1521,6 +1557,7 @@ declare abstract class BaseAgentTask implements IAgentTask {
     protected abstract getSystemPrompt(request: AgentProfileRequest): string;
     getSystemPromptForRequest(request: AgentProfileRequest): string;
     buildMessages(request: AgentProfileRequest, history: AiMessage[]): AiMessage[];
+    private createCurrentUserMessage;
     private createFenceMessages;
     private createFenceMessage;
     private insertAfterLastToolResult;
@@ -2187,4 +2224,4 @@ interface ChatGenerateRequestAdapterInput extends AgentProfileRequest {
  */
 declare function buildGenerateRequestFromAgentRequest(request: ChatGenerateRequestAdapterInput, conversationHistory: AiMessage[]): GenerateRequest;
 
-export { AGENT_CONSTANTS, AGENT_CONTEXT_BUILDER_CONFIG, AISummaryGenerator, type AgentContextBuilderConfigOverrides, type AgentSpecExecutionOptions, type AgentSpecPreprocessorOptions, type AgentSpecProviderOptions, type AgentSpecRuntimeOptions, BaseContextProvider$1 as BaseContextProvider, BaseConversationalTask, BasePreprocessor$1 as BasePreprocessor, ContextProviderRegistry as ChatContextProviderRegistry, CoreContextProvider as ChatCoreContextProvider, ChatMessage, MessageOrchestrator as ChatMessageOrchestrator, type OrchestratorOptions as ChatOrchestratorOptions, type ChatTaskResolver, WorkingMemoryProvider as ChatWorkingMemoryProvider, ContextProviderRegistry$2 as ContextProviderRegistry, ContextTrace, ContextTraceCollector, DEFAULT_MUST_KEEP_POLICY, type FenceDescriptor, type FenceInjection, type FenceLifetime, FenceLifetimePreprocessor, type FenceLifetimePreprocessorOptions, type FenceLlmRole, type FencePlacement, type FenceRegistry, GenerateRequest, GenerateResponse, type HistoryPurificationConfig, HistoryPurificationPreprocessor, type IChatTask, type IContextProvider$1 as IContextProvider, type IPreprocessor$1 as IPreprocessor, type LlmMessage, type MergeContextPolicyParams, type MessageFormatOptions, type MessageFormatterOptions, MessageProcessingState, type MustKeepPolicy, type MustKeepTruncationRule, type NativeToolCallingMessage, type PreprocessorContext$1 as PreprocessorContext, type PreprocessorResult$1 as PreprocessorResult, type ProviderContext$1 as ProviderContext, ProviderResult, SummarizationCallbacks, SummarizationCandidateSelector, type SummarizationOptions, SummarizationProvider, SummarizationStateUtils, SummarizationTrigger, type ToolSummaryProvider, config as agentConfig, index$5 as agentContext, contracts as agentContracts, index$3 as agentOrchestration, index$4 as agentPreprocessors, agentSpecToContextBuilderConfig, agentSpecToRuntimeOptions, index$2 as agentTasks, index$1 as agentTools, index as agentUtils, aiMessageToChatMessage, buildGenerateRequestFromAgentRequest, chatMessageToAiMessage, contextPolicyToContextBuilderConfig, contextPolicyToExecutionOptions, contextPolicyToMustKeepPolicy, contextPolicyToPreprocessorOptions, contextPolicyToProviderOptions, contextPolicyToRuntimeOptions, contextPolicyToSystemReminderOptions, convertEventToChatMessage, convertEventsToChatMessages, createFenceRegistry, createMessageFormatter, findMatchingTruncationRule, formatAgentLlmMessages, getDefaultTokenConfig, mergeContextPolicy, messageFormatter };
+export { AGENT_CONSTANTS, AGENT_CONTEXT_BUILDER_CONFIG, AISummaryGenerator, type AgentContextBuilderConfigOverrides, type AgentSpecExecutionOptions, type AgentSpecPreprocessorOptions, type AgentSpecProviderOptions, type AgentSpecRuntimeOptions, BaseContextProvider$1 as BaseContextProvider, BaseConversationalTask, BasePreprocessor$1 as BasePreprocessor, ContextProviderRegistry as ChatContextProviderRegistry, CoreContextProvider as ChatCoreContextProvider, ChatMessage, MessageOrchestrator as ChatMessageOrchestrator, type OrchestratorOptions as ChatOrchestratorOptions, type ChatTaskResolver, WorkingMemoryProvider as ChatWorkingMemoryProvider, ContextProviderRegistry$2 as ContextProviderRegistry, ContextTrace, ContextTraceCollector, CurrentTurnMessageAssembler, type CurrentTurnMessageAssemblerOptions, DEFAULT_MUST_KEEP_POLICY, type FenceDescriptor, type FenceInjection, type FenceLifetime, FenceLifetimePreprocessor, type FenceLifetimePreprocessorOptions, type FenceLlmRole, type FencePlacement, type FenceRegistry, GenerateRequest, GenerateResponse, type HistoryPurificationConfig, HistoryPurificationPreprocessor, type IChatTask, type IContextProvider$1 as IContextProvider, type IPreprocessor$1 as IPreprocessor, type LlmMessage, type MergeContextPolicyParams, type MessageFormatOptions, type MessageFormatterOptions, MessageProcessingState, type MustKeepPolicy, type MustKeepTruncationRule, type NativeToolCallingMessage, type PreprocessorContext$1 as PreprocessorContext, type PreprocessorResult$1 as PreprocessorResult, type ProviderContext$1 as ProviderContext, ProviderResult, SummarizationCallbacks, SummarizationCandidateSelector, type SummarizationOptions, SummarizationProvider, SummarizationStateUtils, SummarizationTrigger, type ToolSummaryProvider, config as agentConfig, index$5 as agentContext, contracts as agentContracts, index$3 as agentOrchestration, index$4 as agentPreprocessors, agentSpecToContextBuilderConfig, agentSpecToRuntimeOptions, index$2 as agentTasks, index$1 as agentTools, index as agentUtils, aiMessageToChatMessage, buildGenerateRequestFromAgentRequest, chatMessageToAiMessage, contextPolicyToContextBuilderConfig, contextPolicyToExecutionOptions, contextPolicyToMustKeepPolicy, contextPolicyToPreprocessorOptions, contextPolicyToProviderOptions, contextPolicyToRuntimeOptions, contextPolicyToSystemReminderOptions, convertEventToChatMessage, convertEventsToChatMessages, createFenceRegistry, createMessageFormatter, findMatchingTruncationRule, formatAgentLlmMessages, getDefaultTokenConfig, mergeContextPolicy, messageFormatter };

package/dist/context-manager.d.ts

@@ -1,11 +1,11 @@
 import { A as AiMessage, a as AssistantMessage } from './messages-XthmnHZ3.js';
-import { C as ChatMessage, P as ProviderContext$2, M as MessageProcessingState, B as BaseContextProvider$2, a as ProviderResult, I as IContextProvider$2, b as ContextTraceCollector, S as SummarizationCallbacks, G as GenerateRequest, c as GenerateResponse, d as ContextTrace } from './context-trace-DRi5M4lX.js';
-export { e as ChatDocumentMetadata, f as ChatProjectMetadata, g as ChatUserQuote, h as ContextProviderError, i as ContextProviderErrorCode, j as ContextProviderErrorOptions, k as ContextTraceEvent, l as ContextTraceMessageDecisionEvent, m as ContextTraceProviderEvent, n as MessageRole, o as MessageType, R as RecentRejection, p as SUMMARIZATION_FAILED_ERROR_CODE, T as TOOL_HISTORY_OVERFLOW_ERROR_CODE, q as isContextProviderError } from './context-trace-DRi5M4lX.js';
+import { C as ChatMessage, P as ProviderContext$2, M as MessageProcessingState, B as BaseContextProvider$2, a as ProviderResult, I as IContextProvider$2, b as ContextTraceCollector, S as SummarizationCallbacks, G as GenerateRequest, c as GenerateResponse, d as ContextTrace } from './context-trace-CHbqHmyE.js';
+export { e as ChatDocumentMetadata, f as ChatProjectMetadata, g as ChatUserQuote, h as ContextProviderError, i as ContextProviderErrorCode, j as ContextProviderErrorOptions, k as ContextTraceEvent, l as ContextTraceMessageDecisionEvent, m as ContextTraceProviderEvent, n as MessageRole, o as MessageType, R as RecentRejection, p as SUMMARIZATION_FAILED_ERROR_CODE, T as TOOL_HISTORY_OVERFLOW_ERROR_CODE, q as isContextProviderError } from './context-trace-CHbqHmyE.js';
 export { C as CHECKPOINT_MARKER_TYPE } from './checkpointMarker-DAI3wUQu.js';
-import { u as AgentSpecToolOutputPolicy, l as AgentSpecProviderReplayPolicy, d as AgentSpecCheckpointPolicy, n as AgentSpecSummarizationPolicy, g as AgentSpecContextTracePolicy, p as AgentSpecSystemReminderPolicy, a as AgentSpec, e as AgentSpecContextPolicy, f as AgentSpecContextPolicyInput } from './agentSpec-EkmviZjy.js';
-import { e as RuntimeEvent } from './todo-B1PmDlp3.js';
+import { A as AgentSpecToolOutputPolicy, a as AgentSpecProviderReplayPolicy, b as AgentSpecCheckpointPolicy, c as AgentSpecSummarizationPolicy, d as AgentSpecContextTracePolicy, e as AgentSpecSystemReminderPolicy, f as AgentSpec, g as AgentSpecContextPolicy, h as AgentSpecContextPolicyInput } from './agentSpec-Du4Iye0q.js';
+import { R as RuntimeEvent } from './todo-Ca8llpRQ.js';
 import { T as TokenizerPort } from './tokenizer-DFL4I7-I.js';
-import { a as ToolArgs } from './toolContracts-Blll0241.js';
+import { T as ToolArgs } from './toolContracts-f8lzZBNa.js';
 import 'zod';
 import './ai-engine.types-vZRnQcJa.js';
 
@@ -118,6 +118,7 @@ interface AgentContextBuilderConfigOverrides {
 interface AgentSpecPreprocessorOptions {
     toolHistory?: {
         strategy?: 'per-pair' | 'per-run' | 'none';
+        retentionMode?: 'drop' | 'compress';
         keepLatestToolPairs?: number;
         keepLatestRuns?: number;
         maxInteractionGroups?: number;
@@ -243,6 +244,26 @@ declare class FenceLifetimePreprocessor extends BasePreprocessor$1 {
     process(messages: AiMessage[], context: PreprocessorContext$1): Promise<PreprocessorResult$1>;
 }
 
+interface CurrentTurnMessageAssemblerOptions {
+    fenceRegistry: FenceRegistry;
+}
+/**
+ * 组装当前轮 prompt block。
+ *
+ * 中文说明：
+ * - formatter 只负责把单条消息转成 wire 形态，不负责猜测相邻消息是否应该合并；
+ * - 当前轮 system-side fence 在这里合入 system_prompt；
+ * - 当前轮 user-side fence 在这里合入同一条 user_input，未注入的 fence 不产生空标签。
+ */
+declare class CurrentTurnMessageAssembler extends BasePreprocessor$1 {
+    readonly name = "CurrentTurnMessageAssembler";
+    readonly description = "Assembles current-turn fences into system_prompt and user_input messages";
+    readonly priority = 10;
+    private readonly fenceRegistry;
+    constructor(options: CurrentTurnMessageAssemblerOptions);
+    process(messages: AiMessage[], _context: PreprocessorContext$1): Promise<PreprocessorResult$1>;
+}
+
 interface SummarizationConfig {
     SUMMARIZATION_TRIGGER_THRESHOLD: number;
     SUMMARY_OLDEST_MESSAGES_PERCENTAGE: number;
@@ -372,6 +393,11 @@ interface AgentConfig {
     defaultTools: string[];
     timeoutMs: number;
     debug: boolean;
+    /**
+     * @deprecated 不再参与上下文裁剪。
+     * 中文备注：Agent 历史保留现在由 `contextPolicy.budget` 与 `contextPolicy.toolHistory`
+     * 共同决定；保留这个字段只是为了兼容可能读取 `DEFAULT_AGENT_CONFIG` 的旧接入方。
+     */
     maxHistoryLength: number;
     tokenBudget: {
         maxTokens: number;
@@ -821,8 +847,8 @@ declare class AgentCoreContextProvider extends BaseContextProvider$1 {
  * @file src/agent/context/providers/AgentWorkingMemoryProvider.ts
  * @description Agent专用工作记忆填充层Provider - 第二阶段上下文构建
  *
- * 🎯 职责: 实现Agent的P1-P4优先级填充策略
- * 📖 策略: P1(工具交互) > P2(纯文本对话) > P3(历史工具交互) > P4(循环填充)
+ * 🎯 职责: 实现Agent的P1-P3优先级填充策略
+ * 📖 策略: P1(工具交互) > P2(纯文本对话) > P3(历史工具交互)
  * ✨ Agent特性: 工具调用优先级、配对保留策略
  * 🔧 核心逻辑: 保留工具调用时，必须确保其对应的另一半也被保留
  */
@@ -1190,8 +1216,10 @@ declare abstract class BasePreprocessor implements IPreprocessor {
 
 type ToolHistoryCompressionStrategy = 'per-pair' | 'per-run' | 'none';
 type ToolHistoryOverflowStrategy = 'keep-latest' | 'fail-fast';
+type ToolHistoryRetentionMode = 'drop' | 'compress';
 interface ToolHistoryCompressorOptions {
     strategy?: ToolHistoryCompressionStrategy;
+    retentionMode?: ToolHistoryRetentionMode;
     keepLatestToolPairs?: number;
     keepLatestRuns?: number;
     maxInteractionGroups?: number;
@@ -1200,26 +1228,30 @@ interface ToolHistoryCompressorOptions {
     maxOutputSummaryTokens?: number;
 }
 /**
- * 工具历史压缩预处理器。
+ * 工具历史保留预处理器。
  *
  * 三种策略边界：
- * - per-pair：旧行为，按全局最近 N 组完整工具交互保留，其余压成自然语言记录。
+ * - per-pair：按全局最近 N 组完整工具交互保留，其余按 retentionMode 处理。
  * - per-run：按 user_input 划分 run，完整保留最近 K 个历史 run 内的工具组，避免腰斩同一轮工具链。
  * - none：不做常规压缩，仅在 maxInteractionGroups 显式触发时执行安全阀。
  *
+ * retentionMode 边界：
+ * - drop：默认行为。旧工具组超过保留窗口后直接移除，避免改写历史前缀和制造伪 final_answer。
+ * - compress：兼容旧行为。把旧工具组替换为自然语言摘要，用于小上下文或审计友好的历史线索保留。
+ *
  * 注意：单个 tool_output 的 token 截断不在这里做，那是 WorkingMemory 阶段
- * ToolPairTruncator 的职责；本处理器只决定“工具组是原样保留还是压缩为摘要消息”。
+ * ToolPairTruncator 的职责；本处理器只决定“工具组是原样保留、删除，还是压缩为摘要消息”。
  */
 declare class ToolHistoryCompressorPreprocessor extends BasePreprocessor {
     readonly name = "ToolHistoryCompressorPreprocessor";
-    readonly description = "\u5DE5\u5177\u5386\u53F2\u538B\u7F29\u5904\u7406\u5668 - \u5C06\u8F83\u65E9\u7684\u5386\u53F2\u5DE5\u5177\u8C03\u7528\u5BF9\u538B\u7F29\u4E3A\u81EA\u7136\u8BED\u8A00\u8BB0\u5F55\u6D88\u606F";
+    readonly description = "\u5DE5\u5177\u5386\u53F2\u4FDD\u7559\u5904\u7406\u5668 - \u6309\u7B56\u7565\u4FDD\u7559\u3001\u5220\u9664\u6216\u538B\u7F29\u8F83\u65E9\u7684\u5386\u53F2\u5DE5\u5177\u8C03\u7528\u5BF9";
     readonly priority = 0;
     private summarizer;
     private readonly options;
     constructor(options?: ToolHistoryCompressorOptions);
     process(messages: AiMessage[], context: PreprocessorContext): Promise<PreprocessorResult>;
     shouldSkip(messages: AiMessage[], context: PreprocessorContext): boolean;
-    private compressToolCallPairsInHistory;
+    private processToolCallPairsInHistory;
     private selectGroupsToKeep;
     private enforceMaxInteractionGroups;
     private compressToolInteractionGroup;
@@ -1335,7 +1367,7 @@ interface PreprocessorPipelineResult {
  * 创建默认的Agent预处理器注册表
  *
  * 🔥 这里定义了Agent预处理管道的默认配置：
- * 1. ToolHistoryCompressorPreprocessor (priority: 0) - 工具历史压缩，最先执行
+ * 1. ToolHistoryCompressorPreprocessor (priority: 0) - 工具历史保留/删除，最先执行
  * 2. ToolReplayProtocolGuardPreprocessor (priority: 0.5) - 工具回放协议守卫，仅治理历史轮次
  * 3. HistoryPurificationPreprocessor (priority: 1) - Agent历史净化，在压缩后执行
  *
@@ -1354,6 +1386,8 @@ declare function createDefaultAgentPreprocessorPipeline(context?: PreprocessorCo
 
 type index$4_BasePreprocessor = BasePreprocessor;
 declare const index$4_BasePreprocessor: typeof BasePreprocessor;
+type index$4_CurrentTurnMessageAssembler = CurrentTurnMessageAssembler;
+declare const index$4_CurrentTurnMessageAssembler: typeof CurrentTurnMessageAssembler;
 type index$4_DefaultAgentPreprocessorRegistryOptions = DefaultAgentPreprocessorRegistryOptions;
 type index$4_FenceLifetimePreprocessor = FenceLifetimePreprocessor;
 declare const index$4_FenceLifetimePreprocessor: typeof FenceLifetimePreprocessor;
@@ -1373,6 +1407,7 @@ type index$4_ToolHistoryCompressorOptions = ToolHistoryCompressorOptions;
 type index$4_ToolHistoryCompressorPreprocessor = ToolHistoryCompressorPreprocessor;
 declare const index$4_ToolHistoryCompressorPreprocessor: typeof ToolHistoryCompressorPreprocessor;
 type index$4_ToolHistoryOverflowStrategy = ToolHistoryOverflowStrategy;
+type index$4_ToolHistoryRetentionMode = ToolHistoryRetentionMode;
 type index$4_ToolReplayProtocolGuardOptions = ToolReplayProtocolGuardOptions;
 type index$4_ToolReplayProtocolGuardPreprocessor = ToolReplayProtocolGuardPreprocessor;
 declare const index$4_ToolReplayProtocolGuardPreprocessor: typeof ToolReplayProtocolGuardPreprocessor;
@@ -1381,7 +1416,7 @@ declare const index$4_createDefaultAgentPreprocessorPipeline: typeof createDefau
 declare const index$4_createDefaultAgentPreprocessorRegistry: typeof createDefaultAgentPreprocessorRegistry;
 declare const index$4_resolveToolReplayProtocolPolicy: typeof resolveToolReplayProtocolPolicy;
 declare namespace index$4 {
-  export { index$4_BasePreprocessor as BasePreprocessor, type index$4_DefaultAgentPreprocessorRegistryOptions as DefaultAgentPreprocessorRegistryOptions, index$4_FenceLifetimePreprocessor as FenceLifetimePreprocessor, index$4_HistoryPurificationPreprocessor as HistoryPurificationPreprocessor, type index$4_IPreprocessor as IPreprocessor, type index$4_MissingSidecarBehavior as MissingSidecarBehavior, type index$4_PreprocessorContext as PreprocessorContext, index$4_PreprocessorPipeline as PreprocessorPipeline, type index$4_PreprocessorPipelineResult as PreprocessorPipelineResult, index$4_PreprocessorRegistry as PreprocessorRegistry, type index$4_PreprocessorResult as PreprocessorResult, type index$4_ToolHistoryCompressionStrategy as ToolHistoryCompressionStrategy, type index$4_ToolHistoryCompressorOptions as ToolHistoryCompressorOptions, index$4_ToolHistoryCompressorPreprocessor as ToolHistoryCompressorPreprocessor, type index$4_ToolHistoryOverflowStrategy as ToolHistoryOverflowStrategy, type index$4_ToolReplayProtocolGuardOptions as ToolReplayProtocolGuardOptions, index$4_ToolReplayProtocolGuardPreprocessor as ToolReplayProtocolGuardPreprocessor, type index$4_ToolReplayProtocolPolicy as ToolReplayProtocolPolicy, index$4_createDefaultAgentPreprocessorPipeline as createDefaultAgentPreprocessorPipeline, index$4_createDefaultAgentPreprocessorRegistry as createDefaultAgentPreprocessorRegistry, index$4_resolveToolReplayProtocolPolicy as resolveToolReplayProtocolPolicy };
+  export { index$4_BasePreprocessor as BasePreprocessor, index$4_CurrentTurnMessageAssembler as CurrentTurnMessageAssembler, type index$4_DefaultAgentPreprocessorRegistryOptions as DefaultAgentPreprocessorRegistryOptions, index$4_FenceLifetimePreprocessor as FenceLifetimePreprocessor, index$4_HistoryPurificationPreprocessor as HistoryPurificationPreprocessor, type index$4_IPreprocessor as IPreprocessor, type index$4_MissingSidecarBehavior as MissingSidecarBehavior, type index$4_PreprocessorContext as PreprocessorContext, index$4_PreprocessorPipeline as PreprocessorPipeline, type index$4_PreprocessorPipelineResult as PreprocessorPipelineResult, index$4_PreprocessorRegistry as PreprocessorRegistry, type index$4_PreprocessorResult as PreprocessorResult, type index$4_ToolHistoryCompressionStrategy as ToolHistoryCompressionStrategy, type index$4_ToolHistoryCompressorOptions as ToolHistoryCompressorOptions, index$4_ToolHistoryCompressorPreprocessor as ToolHistoryCompressorPreprocessor, type index$4_ToolHistoryOverflowStrategy as ToolHistoryOverflowStrategy, type index$4_ToolHistoryRetentionMode as ToolHistoryRetentionMode, type index$4_ToolReplayProtocolGuardOptions as ToolReplayProtocolGuardOptions, index$4_ToolReplayProtocolGuardPreprocessor as ToolReplayProtocolGuardPreprocessor, type index$4_ToolReplayProtocolPolicy as ToolReplayProtocolPolicy, index$4_createDefaultAgentPreprocessorPipeline as createDefaultAgentPreprocessorPipeline, index$4_createDefaultAgentPreprocessorRegistry as createDefaultAgentPreprocessorRegistry, index$4_resolveToolReplayProtocolPolicy as resolveToolReplayProtocolPolicy };
 }
 
 interface ToolManagerRegistry extends ToolSummaryProvider {
@@ -1470,6 +1505,7 @@ declare class AgentMessageOrchestrator {
     private resolvePreprocessorModel;
     private resolveContextPolicy;
     private applyContextPolicy;
+    private resolveEffectiveContextBudget;
     processAgentConversation(request: AgentProfileRequest, history: RuntimeEvent[], toolManager: ToolManager, callbacks?: SummarizationCallbacks, extraOptions?: {
         generate?: (request: GenerateRequest) => Promise<GenerateResponse>;
     }): Promise<AgentProcessingResult>;
@@ -1521,6 +1557,7 @@ declare abstract class BaseAgentTask implements IAgentTask {
     protected abstract getSystemPrompt(request: AgentProfileRequest): string;
     getSystemPromptForRequest(request: AgentProfileRequest): string;
     buildMessages(request: AgentProfileRequest, history: AiMessage[]): AiMessage[];
+    private createCurrentUserMessage;
     private createFenceMessages;
     private createFenceMessage;
     private insertAfterLastToolResult;
@@ -2187,4 +2224,4 @@ interface ChatGenerateRequestAdapterInput extends AgentProfileRequest {
  */
 declare function buildGenerateRequestFromAgentRequest(request: ChatGenerateRequestAdapterInput, conversationHistory: AiMessage[]): GenerateRequest;
 
-export { AGENT_CONSTANTS, AGENT_CONTEXT_BUILDER_CONFIG, AISummaryGenerator, type AgentContextBuilderConfigOverrides, type AgentSpecExecutionOptions, type AgentSpecPreprocessorOptions, type AgentSpecProviderOptions, type AgentSpecRuntimeOptions, BaseContextProvider$1 as BaseContextProvider, BaseConversationalTask, BasePreprocessor$1 as BasePreprocessor, ContextProviderRegistry as ChatContextProviderRegistry, CoreContextProvider as ChatCoreContextProvider, ChatMessage, MessageOrchestrator as ChatMessageOrchestrator, type OrchestratorOptions as ChatOrchestratorOptions, type ChatTaskResolver, WorkingMemoryProvider as ChatWorkingMemoryProvider, ContextProviderRegistry$2 as ContextProviderRegistry, ContextTrace, ContextTraceCollector, DEFAULT_MUST_KEEP_POLICY, type FenceDescriptor, type FenceInjection, type FenceLifetime, FenceLifetimePreprocessor, type FenceLifetimePreprocessorOptions, type FenceLlmRole, type FencePlacement, type FenceRegistry, GenerateRequest, GenerateResponse, type HistoryPurificationConfig, HistoryPurificationPreprocessor, type IChatTask, type IContextProvider$1 as IContextProvider, type IPreprocessor$1 as IPreprocessor, type LlmMessage, type MergeContextPolicyParams, type MessageFormatOptions, type MessageFormatterOptions, MessageProcessingState, type MustKeepPolicy, type MustKeepTruncationRule, type NativeToolCallingMessage, type PreprocessorContext$1 as PreprocessorContext, type PreprocessorResult$1 as PreprocessorResult, type ProviderContext$1 as ProviderContext, ProviderResult, SummarizationCallbacks, SummarizationCandidateSelector, type SummarizationOptions, SummarizationProvider, SummarizationStateUtils, SummarizationTrigger, type ToolSummaryProvider, config as agentConfig, index$5 as agentContext, contracts as agentContracts, index$3 as agentOrchestration, index$4 as agentPreprocessors, agentSpecToContextBuilderConfig, agentSpecToRuntimeOptions, index$2 as agentTasks, index$1 as agentTools, index as agentUtils, aiMessageToChatMessage, buildGenerateRequestFromAgentRequest, chatMessageToAiMessage, contextPolicyToContextBuilderConfig, contextPolicyToExecutionOptions, contextPolicyToMustKeepPolicy, contextPolicyToPreprocessorOptions, contextPolicyToProviderOptions, contextPolicyToRuntimeOptions, contextPolicyToSystemReminderOptions, convertEventToChatMessage, convertEventsToChatMessages, createFenceRegistry, createMessageFormatter, findMatchingTruncationRule, formatAgentLlmMessages, getDefaultTokenConfig, mergeContextPolicy, messageFormatter };
+export { AGENT_CONSTANTS, AGENT_CONTEXT_BUILDER_CONFIG, AISummaryGenerator, type AgentContextBuilderConfigOverrides, type AgentSpecExecutionOptions, type AgentSpecPreprocessorOptions, type AgentSpecProviderOptions, type AgentSpecRuntimeOptions, BaseContextProvider$1 as BaseContextProvider, BaseConversationalTask, BasePreprocessor$1 as BasePreprocessor, ContextProviderRegistry as ChatContextProviderRegistry, CoreContextProvider as ChatCoreContextProvider, ChatMessage, MessageOrchestrator as ChatMessageOrchestrator, type OrchestratorOptions as ChatOrchestratorOptions, type ChatTaskResolver, WorkingMemoryProvider as ChatWorkingMemoryProvider, ContextProviderRegistry$2 as ContextProviderRegistry, ContextTrace, ContextTraceCollector, CurrentTurnMessageAssembler, type CurrentTurnMessageAssemblerOptions, DEFAULT_MUST_KEEP_POLICY, type FenceDescriptor, type FenceInjection, type FenceLifetime, FenceLifetimePreprocessor, type FenceLifetimePreprocessorOptions, type FenceLlmRole, type FencePlacement, type FenceRegistry, GenerateRequest, GenerateResponse, type HistoryPurificationConfig, HistoryPurificationPreprocessor, type IChatTask, type IContextProvider$1 as IContextProvider, type IPreprocessor$1 as IPreprocessor, type LlmMessage, type MergeContextPolicyParams, type MessageFormatOptions, type MessageFormatterOptions, MessageProcessingState, type MustKeepPolicy, type MustKeepTruncationRule, type NativeToolCallingMessage, type PreprocessorContext$1 as PreprocessorContext, type PreprocessorResult$1 as PreprocessorResult, type ProviderContext$1 as ProviderContext, ProviderResult, SummarizationCallbacks, SummarizationCandidateSelector, type SummarizationOptions, SummarizationProvider, SummarizationStateUtils, SummarizationTrigger, type ToolSummaryProvider, config as agentConfig, index$5 as agentContext, contracts as agentContracts, index$3 as agentOrchestration, index$4 as agentPreprocessors, agentSpecToContextBuilderConfig, agentSpecToRuntimeOptions, index$2 as agentTasks, index$1 as agentTools, index as agentUtils, aiMessageToChatMessage, buildGenerateRequestFromAgentRequest, chatMessageToAiMessage, contextPolicyToContextBuilderConfig, contextPolicyToExecutionOptions, contextPolicyToMustKeepPolicy, contextPolicyToPreprocessorOptions, contextPolicyToProviderOptions, contextPolicyToRuntimeOptions, contextPolicyToSystemReminderOptions, convertEventToChatMessage, convertEventsToChatMessages, createFenceRegistry, createMessageFormatter, findMatchingTruncationRule, formatAgentLlmMessages, getDefaultTokenConfig, mergeContextPolicy, messageFormatter };