@linnlabs/linnkit 0.8.0

package/dist/context-manager.d.ts

@@ -0,0 +1,2190 @@
+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';
+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 { T as TokenizerPort } from './tokenizer-DFL4I7-I.js';
+import { a as ToolArgs } from './toolContracts-Blll0241.js';
+import 'zod';
+import './ai-engine.types-vZRnQcJa.js';
+
+type FenceLlmRole = 'user' | 'system';
+type FencePlacement = 'after-system' | 'before-current-user' | 'after-current-user' | 'after-last-tool-result';
+type FenceLifetime = 'turn-only' | 'persisted';
+interface FenceDescriptor {
+    kind: string;
+    llmRole: FenceLlmRole;
+    placement: FencePlacement;
+    lifetime: FenceLifetime;
+    mustKeep?: boolean;
+    maxBudgetFraction?: number;
+    formatter: (content: string, attrs: Record<string, unknown>) => string;
+}
+interface FenceInjection {
+    kind: string;
+    content: string;
+    attrs?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+interface FenceRegistry {
+    register(descriptor: FenceDescriptor): void;
+    get(kind: string): FenceDescriptor | undefined;
+    list(): FenceDescriptor[];
+}
+declare function createFenceRegistry(descriptors?: FenceDescriptor[]): FenceRegistry;
+
+interface MessageFormatOptions {
+    nativeTools?: boolean;
+    mode?: 'agent' | 'chat';
+    fenceRegistry?: FenceRegistry;
+}
+interface MessageFormatterOptions {
+    fenceRegistry?: FenceRegistry;
+}
+type NativeToolCallingMessage = {
+    role: 'system' | 'user';
+    content: string;
+} | {
+    role: 'assistant';
+    content: string;
+    reasoning_details?: unknown[];
+    provider_empty_replay_field?: true;
+} | {
+    role: 'assistant';
+    content: string | null;
+    tool_calls: unknown[];
+    reasoning_details?: unknown[];
+    provider_empty_replay_field?: true;
+} | {
+    role: 'tool';
+    tool_call_id: string;
+    content: string;
+};
+declare class MessageFormatter {
+    private readonly fenceRegistry?;
+    constructor(options?: MessageFormatterOptions);
+    format(messages: AiMessage[], options: {
+        nativeTools: true;
+        mode?: 'agent' | 'chat';
+    }): NativeToolCallingMessage[];
+    format(messages: AiMessage[], options?: {
+        nativeTools?: false;
+        mode?: 'agent' | 'chat';
+    }): ChatMessage[];
+    private mergeThoughtAndAnswer;
+    private shouldMergeWithNext;
+    private performMerge;
+    private formatSingleMessage;
+}
+declare const messageFormatter: MessageFormatter;
+declare function createMessageFormatter(options?: MessageFormatterOptions): MessageFormatter;
+declare function formatAgentLlmMessages(messages: AiMessage[], options?: Pick<MessageFormatOptions, 'fenceRegistry'>): NativeToolCallingMessage[];
+type LlmMessage = ChatMessage | NativeToolCallingMessage;
+
+interface MustKeepTruncationRule {
+    messageType?: AiMessage['type'] | string;
+    metadataFragmentType?: string;
+    fenceKind?: string;
+    maxBudgetFraction: number;
+    strategyName: string;
+}
+interface MustKeepPolicy {
+    alwaysKeepTypes: Array<AiMessage['type'] | string>;
+    alwaysKeepFenceKinds: string[];
+    truncationRules: MustKeepTruncationRule[];
+}
+declare const DEFAULT_MUST_KEEP_POLICY: MustKeepPolicy;
+declare function findMatchingTruncationRule(message: AiMessage, policy: MustKeepPolicy): MustKeepTruncationRule | undefined;
+
+interface AgentContextBuilderConfigOverrides {
+    DEFAULT_MAX_TOKENS?: number;
+    RESERVED_FOR_RESPONSE?: number;
+    WORKING_MEMORY_BUDGET_PERCENTAGE?: number;
+    SUMMARIZATION_TRIGGER_THRESHOLD?: number;
+    SUMMARY_BUDGET_PERCENTAGE?: number;
+    SUMMARY_OLDEST_MESSAGES_PERCENTAGE?: number;
+    MAX_THOUGHTS_TO_KEEP?: number;
+    TOOL_PAIRING_SEARCH_RANGE?: number;
+    MAX_TOOL_PAIR_TOKENS?: number;
+    MAX_TOOL_OUTPUT_SUMMARY_TOKENS?: number;
+    MIN_TOOL_INTERACTIONS_TO_KEEP?: number;
+    MAX_RECENT_TOOL_INTERACTIONS_TO_KEEP?: number;
+    MAX_TOOL_INTERACTION_GROUPS_TO_KEEP?: number;
+    AVG_CHARS_PER_TOKEN?: number;
+    TOOL_CALL_OVERHEAD_TOKENS?: number;
+    TOKEN_ENCODING_NAME?: string;
+}
+interface AgentSpecPreprocessorOptions {
+    toolHistory?: {
+        strategy?: 'per-pair' | 'per-run' | 'none';
+        keepLatestToolPairs?: number;
+        keepLatestRuns?: number;
+        maxInteractionGroups?: number;
+        overflowStrategy?: 'keep-latest' | 'fail-fast';
+        maxPairTokens?: number;
+        maxOutputSummaryTokens?: number;
+    };
+    providerReplay?: AgentSpecProviderReplayPolicy;
+}
+interface AgentSpecProviderOptions {
+    mustKeep?: MustKeepPolicy;
+    checkpoint?: AgentSpecCheckpointPolicy;
+    summarization?: Pick<AgentSpecSummarizationPolicy, 'agentId' | 'failureBehavior'>;
+    contextTrace?: AgentSpecContextTracePolicy;
+}
+interface AgentSpecExecutionOptions {
+    toolOutput?: AgentSpecToolOutputPolicy;
+}
+interface AgentSpecRuntimeOptions {
+    contextBuilderConfig: AgentContextBuilderConfigOverrides;
+    preprocessorOptions: AgentSpecPreprocessorOptions;
+    providerOptions: AgentSpecProviderOptions;
+    executionOptions: AgentSpecExecutionOptions;
+    systemReminder?: AgentSpecSystemReminderPolicy;
+}
+/**
+ * 把 AgentSpec 的上下文策略转换成 AgentContextManager 能识别的配置覆盖。
+ * 注意：profileId 只用于宿主路由，这里不消费。
+ */
+declare function agentSpecToContextBuilderConfig(spec: AgentSpec): AgentContextBuilderConfigOverrides;
+declare function contextPolicyToContextBuilderConfig(policy: AgentSpecContextPolicy): AgentContextBuilderConfigOverrides;
+/**
+ * 把 contextPolicy.toolHistory 原样转成交给 agent preprocessor registry 的配置。
+ */
+declare function contextPolicyToPreprocessorOptions(policy: AgentSpecContextPolicy | undefined): AgentSpecPreprocessorOptions;
+/**
+ * 提供给后续 provider registry 重建链路使用。
+ * F1.2 只做映射，不在这里创建 provider，避免 shared 层反向依赖 agent profile 实现。
+ */
+declare function contextPolicyToProviderOptions(policy: AgentSpecContextPolicy | undefined): AgentSpecProviderOptions;
+declare function contextPolicyToMustKeepPolicy(policy: AgentSpecContextPolicy | undefined): MustKeepPolicy | undefined;
+declare function contextPolicyToSystemReminderOptions(policy: AgentSpecContextPolicy | undefined): AgentSpecSystemReminderPolicy | undefined;
+declare function contextPolicyToExecutionOptions(policy: AgentSpecContextPolicy | undefined): AgentSpecExecutionOptions;
+declare function agentSpecToRuntimeOptions(spec: AgentSpec): AgentSpecRuntimeOptions;
+declare function contextPolicyToRuntimeOptions(policy: AgentSpecContextPolicy): AgentSpecRuntimeOptions;
+
+interface MergeContextPolicyParams {
+    frameworkDefault?: AgentSpecContextPolicyInput;
+    hostFallback?: AgentSpecContextPolicyInput;
+    agentSpec?: AgentSpecContextPolicyInput;
+}
+/**
+ * 合并三层 contextPolicy。
+ *
+ * 中文备注：
+ * - 优先级：frameworkDefault < hostFallback < agentSpec；
+ * - 按分组做字段级合并；
+ * - 数组字段整体替换，不做 concat，避免 host/agent 的规则顺序变得不可预测。
+ */
+declare function mergeContextPolicy(params: MergeContextPolicyParams): AgentSpecContextPolicy;
+
+interface ToolSummaryProvider {
+    getTool(toolName: string): {
+        getExecutionSummary?: (output: string) => string;
+    } | undefined;
+}
+interface PreprocessorContext$1 {
+    debugMode?: boolean;
+    model?: string;
+    toolSummaryProvider?: ToolSummaryProvider;
+}
+interface PreprocessorResult$1 {
+    messages: AiMessage[];
+    stats: {
+        originalCount: number;
+        processedCount: number;
+        removedCount: number;
+        modifiedCount: number;
+    };
+    appliedStrategies: string[];
+}
+interface IPreprocessor$1 {
+    readonly name: string;
+    readonly description: string;
+    readonly priority: number;
+    process(messages: AiMessage[], context: PreprocessorContext$1): Promise<PreprocessorResult$1>;
+    shouldSkip?(messages: AiMessage[], context: PreprocessorContext$1): boolean;
+}
+declare abstract class BasePreprocessor$1 implements IPreprocessor$1 {
+    abstract readonly name: string;
+    abstract readonly description: string;
+    abstract readonly priority: number;
+    abstract process(messages: AiMessage[], context: PreprocessorContext$1): Promise<PreprocessorResult$1>;
+    shouldSkip?(messages: AiMessage[], context: PreprocessorContext$1): boolean;
+    protected createResult(originalMessages: AiMessage[], processedMessages: AiMessage[], appliedStrategies: string[], modifiedCount?: number): PreprocessorResult$1;
+    protected debug(message: string, data?: Record<string, unknown>, context?: PreprocessorContext$1): void;
+}
+
+interface HistoryPurificationConfig {
+    logPrefix?: string;
+}
+declare class HistoryPurificationPreprocessor extends BasePreprocessor$1 {
+    readonly name = "HistoryPurificationPreprocessor";
+    readonly description = "\u57FA\u4E8E\u6458\u8981ID\u5217\u8868\u7684\u5386\u53F2\u51C0\u5316\u5904\u7406\u5668";
+    readonly priority = 1;
+    private logPrefix;
+    constructor(config?: HistoryPurificationConfig);
+    process(messages: AiMessage[], context: PreprocessorContext$1): Promise<PreprocessorResult$1>;
+    shouldSkip(messages: AiMessage[], context: PreprocessorContext$1): boolean;
+    private findLatestSummary;
+    private cleanHistoryWithSummaryReplacement;
+}
+
+interface FenceLifetimePreprocessorOptions {
+    fenceRegistry: FenceRegistry;
+}
+declare class FenceLifetimePreprocessor extends BasePreprocessor$1 {
+    readonly name = "FenceLifetimePreprocessor";
+    readonly description = "Removes expired turn-only context injection messages from history";
+    readonly priority = 15;
+    private readonly fenceRegistry;
+    constructor(options: FenceLifetimePreprocessorOptions);
+    process(messages: AiMessage[], context: PreprocessorContext$1): Promise<PreprocessorResult$1>;
+}
+
+interface SummarizationConfig {
+    SUMMARIZATION_TRIGGER_THRESHOLD: number;
+    SUMMARY_OLDEST_MESSAGES_PERCENTAGE: number;
+    TOKEN_ENCODING_NAME: string;
+}
+type SummarizationProviderContext = ProviderContext$2<SummarizationConfig>;
+
+/**
+ * @file AISummaryGenerator.ts
+ * @description AI摘要生成器 - 负责与AI模型交互生成摘要
+ */
+
+interface SummarizationOptions {
+    maxSummaryTokens: number;
+    targetCompressionRatio?: number;
+    /**
+     * 执行摘要的已注册 agent/chat ID。
+     *
+     * 中文备注：linnkit 不持有 prompt 正文，也不直接决定模型调用；这里只携带注册引用，
+     * 真正的 prompt 构建与模型策略由 host 的注册表解释。
+     */
+    agentId: string;
+    modelId: string | null;
+    fallbackModelId?: string | null;
+    language: 'zh' | 'en' | 'auto';
+    failureBehavior?: 'fail-fast' | 'continue-if-within-budget';
+    /** 内部调参与测试注入，默认保持生产重试行为。 */
+    maxRetries?: number;
+    /** 内部调参与测试注入，默认 1000ms。 */
+    retryDelayMs?: number;
+}
+declare class AISummaryGenerator {
+    private readonly defaultOptions;
+    private readonly fallbackModelId;
+    private readonly MAX_RETRIES;
+    private readonly RETRY_DELAY_MS;
+    constructor(options: SummarizationOptions);
+    generateHistorySummary(candidates: MessageProcessingState[], context: SummarizationProviderContext, debugFn: (message: string, data: Record<string, unknown>, context: SummarizationProviderContext) => void): Promise<string>;
+    private tryGenerateSummaryWithRetries;
+    private formatMessagesForSummary;
+    private sleep;
+}
+
+declare class SummarizationTrigger {
+    static shouldSkip(states: MessageProcessingState[], availableBudget: number, context: SummarizationProviderContext): boolean;
+    static shouldTriggerSummarization(states: MessageProcessingState[], remainingBudget: number, totalBudget: number, context: SummarizationProviderContext, debugFn: (message: string, data: Record<string, unknown>, context: SummarizationProviderContext) => void): boolean;
+    static calculateUsedTokens(states: MessageProcessingState[]): number;
+}
+
+declare class SummarizationCandidateSelector {
+    static identifySummarizationCandidates(workingMemoryStates: MessageProcessingState[], context: SummarizationProviderContext, options?: {
+        fullStateList?: MessageProcessingState[];
+    }): {
+        allCandidates: MessageProcessingState[];
+        coreCandidates: MessageProcessingState[];
+    };
+    static selectCompleteConversationPairs(candidates: MessageProcessingState[], workingSet: MessageProcessingState[]): MessageProcessingState[];
+}
+
+declare class SummarizationStateUtils {
+    static collectReplacedIds(candidates: MessageProcessingState[]): string[];
+    static generateSummarySeq(allMessages: AiMessage[]): number;
+    static createSummaryMessageState(summary: string, candidates: MessageProcessingState[], context: ProviderContext$2, allMessages: AiMessage[], includedOldSummary?: boolean): {
+        state: MessageProcessingState;
+        event: RuntimeEvent;
+    };
+    static replaceWithSummary(allStates: MessageProcessingState[], candidatesForSummarization: MessageProcessingState[], summaryState: MessageProcessingState): MessageProcessingState[];
+    static calculateOriginalTokens(candidates: MessageProcessingState[]): number;
+}
+
+/**
+ * @file src/agent/context-manager/shared/providers/SummarizationProvider.ts
+ * @description 统一摘要化处理层Provider - Chat 和 Agent 通用
+ */
+
+declare class SummarizationProvider extends BaseContextProvider$2<SummarizationConfig> {
+    readonly name = "SummarizationProvider";
+    readonly description = "\u6458\u8981\u5316\u5904\u7406\u5C42 - \u6838\u5FC3\u5BF9\u8BDD\u538B\u7F29\uFF0C\u805A\u7126\u7528\u6237\u610F\u56FE\u4E0EAI\u56DE\u7B54";
+    readonly priority = 3;
+    private aiGenerator;
+    private readonly failureBehavior;
+    constructor(options: SummarizationOptions);
+    provide(states: MessageProcessingState[], availableBudget: number, context: SummarizationProviderContext): Promise<ProviderResult>;
+    shouldSkip(states: MessageProcessingState[], availableBudget: number, context: SummarizationProviderContext): boolean;
+}
+
+declare class ContextProviderRegistry$2<TConfig = unknown> {
+    private providers;
+    register(provider: IContextProvider$2<TConfig>): void;
+    getAllProviders(): IContextProvider$2<TConfig>[];
+    getProvider(name: string): IContextProvider$2<TConfig> | undefined;
+    clear(): void;
+}
+
+/**
+ * @file src/agent/context-manager/profiles/agent/contracts.ts
+ */
+
+/**
+ * Minimal request contract used by package-neutral agent profile code.
+ * Product-specific invoke requests can extend this shape.
+ */
+interface AgentProfileRequest {
+    query: string;
+    promptKey: string;
+    model_id?: string;
+    modelId?: string;
+    availableTools?: string[];
+    conversationHistory?: AiMessage[];
+    fences?: FenceInjection[];
+}
+
+type contracts_AgentProfileRequest = AgentProfileRequest;
+declare namespace contracts {
+  export type { contracts_AgentProfileRequest as AgentProfileRequest };
+}
+
+declare const AGENT_CONSTANTS: {
+    readonly DEFAULT_MAX_STEPS: 80;
+    readonly DEFAULT_TIMEOUT_MS: 300000;
+    readonly DEFAULT_MAX_RETRIES: 3;
+    readonly DEFAULT_RETRY_DELAY_MS: 1000;
+};
+interface AgentConfig {
+    defaultModelId: string;
+    maxSteps: number;
+    defaultTools: string[];
+    timeoutMs: number;
+    debug: boolean;
+    maxHistoryLength: number;
+    tokenBudget: {
+        maxTokens: number;
+        reservedForResponse: number;
+    };
+    contextProcessingTimeoutMs: number;
+    retry: {
+        maxRetries: number;
+        enableEmptyResponseRetry: boolean;
+        retryDelayMs: number;
+    };
+}
+declare const DEFAULT_AGENT_CONFIG: AgentConfig;
+
+declare const config_AGENT_CONSTANTS: typeof AGENT_CONSTANTS;
+type config_AgentConfig = AgentConfig;
+declare const config_DEFAULT_AGENT_CONFIG: typeof DEFAULT_AGENT_CONFIG;
+declare namespace config {
+  export { config_AGENT_CONSTANTS as AGENT_CONSTANTS, type config_AgentConfig as AgentConfig, config_DEFAULT_AGENT_CONFIG as DEFAULT_AGENT_CONFIG };
+}
+
+/**
+ * 对话会话管理类
+ *
+ * 单一职责：管理当前会话的消息存储和基础CRUD操作
+ * - 存储和检索消息
+ * - 维护对话历史的完整性
+ * - 提供基础的消息查询功能
+ *
+ * 不负责：Token管理、智能截断、优先级分析（这些由WorkingContextManager处理）
+ */
+declare class ConversationSession {
+    private messages;
+    private systemPrompt;
+    /**
+     * 构造函数
+     * @param systemPrompt 系统提示词
+     */
+    constructor(systemPrompt: string);
+    /**
+     * 添加消息到会话
+     * @param role 消息角色
+     * @param content 消息内容
+     */
+    addMessage(role: 'user' | 'assistant', content: string): void;
+    /**
+     * 添加用户消息
+     * @param content 用户消息内容
+     * @param id 可选的消息ID，如果不提供则自动生成
+     */
+    addUserMessage(content: string, id?: string): void;
+    /**
+     * 添加助手消息，可能包含工具调用
+     * @param content 文本内容（可选）
+     * @param type 消息类型
+     * @param metadata 消息元数据（可选）
+     * @param id 可选的消息ID，如果不提供则自动生成
+     */
+    addAssistantMessage(content: string | null, type: AssistantMessage['type'], metadata?: AiMessage['metadata'], id?: string): void;
+    /**
+     * 添加从历史记录加载的工具输出消息
+     * @param content 消息内容
+     * @param metadata 消息元数据
+     */
+    addToolOutputMessage(content: string, metadata: AiMessage['metadata']): void;
+    /**
+     * 添加工具调用的响应结果
+     * @param toolCallId 工具调用的唯一ID
+     * @param content 工具执行返回的结果（通常是字符串格式）
+     * @param toolName 工具名称（可选）
+     * @param id 可选的消息ID，如果不提供则自动生成
+     */
+    addToolResponse(toolCallId: string, content: string, toolName?: string, id?: string): void;
+    /**
+     * 追加一条已构造完成的消息。
+     *
+     * 中文备注：
+     * - 该方法用于回放阶段写入“已是最终形态”的消息，例如 `history_summary`；
+     * - 这样 core 侧只依赖最小写入端口，不需要直接感知 `ConversationSession` 的私有字段结构。
+     */
+    appendMessage(message: AiMessage): void;
+    /**
+     * 获取完整的对话历史记录
+     * @returns 消息数组
+     */
+    getHistory(): AiMessage[];
+    /**
+     * 清空对话历史，只保留系统提示词
+     */
+    clear(): void;
+    /**
+     * 更新系统提示词
+     * @param newSystemPrompt 新的系统提示词
+     */
+    updateSystemPrompt(newSystemPrompt: string): void;
+    /**
+     * 获取当前系统提示词
+     * @returns 系统提示词字符串
+     */
+    getSystemPrompt(): string;
+    /**
+     * 获取消息总数（不包括系统消息）
+     * @returns 消息数量
+     */
+    getMessageCount(): number;
+    /**
+     * 获取最近的n条用户消息
+     * @param n 消息数量
+     * @returns 用户消息数组
+     */
+    getRecentUserMessages(n: number): AiMessage[];
+    /**
+     * 获取最近的n条助手消息
+     * @param n 消息数量
+     * @returns 助手消息数组
+     */
+    getRecentAssistantMessages(n: number): AiMessage[];
+    /**
+     * 检查是否有待处理的工具调用
+     * @returns 是否有未响应的工具调用
+     */
+    hasPendingToolCalls(): boolean;
+    /**
+     * 获取待处理的工具调用
+     * @returns 待处理的工具调用数组
+     */
+    getPendingToolCalls(): Array<{
+        id: string;
+        type: 'function';
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+    /**
+     * 将历史记录序列化为JSON
+     * @returns JSON字符串
+     */
+    serialize(): string;
+    /**
+     * 从JSON反序列化历史记录
+     * @param json JSON字符串
+     * @returns ConversationSession实例
+     */
+    static deserialize(json: string): ConversationSession;
+}
+
+/**
+ * @file src/agent/context/config.ts
+ * @description Agent上下文构建策略配置 - Agent专用三阶段智能填充配置中心
+ *
+ * 🎯 目的: 为Agent的ContextManager提供所有策略参数的可配置中心
+ * 📖 详情: 实现Agent README中描述的3阶段上下文构建策略，专注于工具交互优化
+ * 🔧 特色: P1-P4优先级填充策略，工具调用配对保留机制
+ */
+/**
+ * Agent上下文构建器核心配置
+ *
+ * 🎯 统一管理Agent专用的Token限制、触发条件和策略参数
+ * 🔧 特别针对工具交互场景进行优化
+ */
+declare const AGENT_CONTEXT_BUILDER_CONFIG: {
+    /** 默认最大Token预算上限 */
+    DEFAULT_MAX_TOKENS: number;
+    /** 响应预留Token数 */
+    RESERVED_FOR_RESPONSE: number;
+    /**
+     * 工作记忆填充目标百分比
+     * - **基准**: 可用上下文总预算
+     * - **说明**: Agent工作记忆层会尽力填充到此百分比，为摘要预留空间
+     */
+    WORKING_MEMORY_BUDGET_PERCENTAGE: number;
+    /**
+     * 摘要触发阈值百分比
+     * - **基准**: 可用上下文总预算
+     * - **说明**: 当已用Token总量超过此百分比时，将触发摘要机制
+     */
+    SUMMARIZATION_TRIGGER_THRESHOLD: number;
+    /**
+     * P1优先级：工具交互配对保留
+     * - 工具调用(tool_calls)和工具结果(tool)必须配对保留
+     * - 最高优先级，确保工具交互完整性
+     */
+    P1_TOOL_INTERACTION_PRIORITY: number;
+    /**
+     * P2优先级：纯文本对话
+     * - 不包含工具调用的user和assistant消息
+     * - 按时间倒序填充
+     */
+    P2_TEXT_CONVERSATION_PRIORITY: number;
+    /**
+     * P3优先级：历史工具交互
+     * - 较旧的工具调用记录
+     * - 仍然需要配对保留
+     */
+    P3_HISTORICAL_TOOL_PRIORITY: number;
+    /**
+     * P4优先级：循环填充
+     * - 剩余预算的循环填充策略
+     */
+    P4_CIRCULAR_FILL_PRIORITY: number;
+    /**
+     * P2优先级：工作记忆中保留的最近'thought'消息数量
+     */
+    MAX_THOUGHTS_TO_KEEP: number;
+    /**
+     * 摘要消息长度上限百分比
+     * - **基准**: 可用上下文总预算
+     * - **说明**: AI生成的摘要文本Token长度限制
+     */
+    SUMMARY_BUDGET_PERCENTAGE: number;
+    /**
+     * 选取摘要候选消息的比例
+     * - **基准**: 符合摘要条件的消息数量
+     * - **说明**: 选取最老的多少比例消息进行摘要
+     */
+    SUMMARY_OLDEST_MESSAGES_PERCENTAGE: number;
+    /**
+     * 工具调用配对搜索范围
+     * - 在多少条消息范围内搜索工具调用的配对
+     */
+    TOOL_PAIRING_SEARCH_RANGE: number;
+    /**
+     * 单个工具交互对的最大Token数
+     *
+     * 中文说明：
+     * - 这里是上下文构建期的 token 预算兜底，作用对象是整组 `tool_calls + tool_output`；
+     * - 它不负责工具执行后的原始 observation 落盘预览；
+     * - 执行期落盘阈值在 ToolNode observation governance 中维护，二者不要混成一个配置。
+     */
+    MAX_TOOL_PAIR_TOKENS: number;
+    /**
+     * 工具输出（tool_output）在“工作记忆层截断”时的摘要长度上限（Token）
+     * - 该值用于控制 `ToolOutputSummarizer` 生成摘要的“信息密度”，避免摘要过短导致信息丢失
+     * - 仅影响：超大工具交互对触发截断时（tool_output 会被摘要替换）
+     */
+    MAX_TOOL_OUTPUT_SUMMARY_TOKENS: number;
+    /**
+     * 工具交互保留的最小数量
+     * - 即使预算不足，也要保留最近的几组工具交互
+     */
+    MIN_TOOL_INTERACTIONS_TO_KEEP: number;
+    /**
+     * P1：最近工具交互（原始 tool_calls/tool_output）的最大保留组数
+     * - 目的：只让“最近的行动链”以原始结构进入上下文，避免工具消息膨胀
+     * - 注意：这里只统计“工具交互组”（一组 = 一次 tool_calls ↔ tool_output 配对）
+     */
+    MAX_RECENT_TOOL_INTERACTIONS_TO_KEEP: number;
+    /**
+     * P1+P3：工作记忆层最多保留的工具交互组总数（超过则直接丢弃）
+     * - 目的：对 user 之前的“历史工具交互”做硬上限，避免工具历史过长污染上下文
+     * - 注意：这里的“工具交互组”既包括原始 tool_calls/tool_output 配对，也包括被预处理压缩成
+     *   assistant 文本的“工具执行记录摘要”（metadata.isCompressedToolHistory === true）
+     */
+    MAX_TOOL_INTERACTION_GROUPS_TO_KEEP: number;
+    /** 核心上下文保留层消息类型 - 第一阶段 */
+    CORE_MESSAGE_TYPES: readonly ["system_prompt", "user_input"];
+    /** P1优先级内容类型 - Agent专用 */
+    P1_CONTENT_TYPES: readonly ["tool_calls", "tool_output"];
+    /** P2优先级内容类型 - Agent专用 */
+    P2_CONTENT_TYPES: readonly ["final_answer", "user_input"];
+    /** P3优先级内容类型 - Agent专用 */
+    P3_CONTENT_TYPES: readonly ["historical_tool_calls", "historical_tool_result"];
+    /** 平均每个字符的token估算比例 */
+    AVG_CHARS_PER_TOKEN: number;
+    /** 工具调用的额外Token开销估算 */
+    TOOL_CALL_OVERHEAD_TOKENS: number;
+    /**
+     * Token 精确估算用的“模型标识”（用于映射到 tiktoken encoding）
+     *
+     * 说明：
+     * - 这里只用于 `TokenCalculator.estimateTokensPrecise(...)` 的 encoding 选择，不用于真实 LLM 调用；
+     * - 为避免把某个具体业务模型写死在这里，统一使用 tiktoken 的默认 encoding：cl100k_base。
+     */
+    TOKEN_ENCODING_NAME: string;
+    /** 是否启用详细的构建统计 */
+    ENABLE_BUILD_STATS: boolean;
+    /** 是否启用阶段执行时间统计 */
+    ENABLE_TIMING_STATS: boolean;
+    /** 上下文构建超时阈值 (毫秒) */
+    PROCESSING_TIMEOUT_MS: number;
+    /** 工具交互配对失败警告阈值 */
+    TOOL_PAIRING_FAILURE_WARNING_THRESHOLD: number;
+};
+/**
+ * Agent上下文构建策略配置的类型定义
+ */
+interface AgentContextBuilderConfig {
+    DEFAULT_MAX_TOKENS: number;
+    RESERVED_FOR_RESPONSE: number;
+    WORKING_MEMORY_BUDGET_PERCENTAGE: number;
+    SUMMARIZATION_TRIGGER_THRESHOLD: number;
+    P1_TOOL_INTERACTION_PRIORITY: number;
+    P2_TEXT_CONVERSATION_PRIORITY: number;
+    P3_HISTORICAL_TOOL_PRIORITY: number;
+    P4_CIRCULAR_FILL_PRIORITY: number;
+    MAX_THOUGHTS_TO_KEEP: number;
+    SUMMARY_BUDGET_PERCENTAGE: number;
+    SUMMARY_OLDEST_MESSAGES_PERCENTAGE: number;
+    TOOL_PAIRING_SEARCH_RANGE: number;
+    MAX_TOOL_PAIR_TOKENS: number;
+    MAX_TOOL_OUTPUT_SUMMARY_TOKENS: number;
+    MIN_TOOL_INTERACTIONS_TO_KEEP: number;
+    MAX_RECENT_TOOL_INTERACTIONS_TO_KEEP: number;
+    MAX_TOOL_INTERACTION_GROUPS_TO_KEEP: number;
+    CORE_MESSAGE_TYPES: readonly string[];
+    P1_CONTENT_TYPES: readonly string[];
+    P2_CONTENT_TYPES: readonly string[];
+    P3_CONTENT_TYPES: readonly string[];
+    AVG_CHARS_PER_TOKEN: number;
+    TOOL_CALL_OVERHEAD_TOKENS: number;
+    TOKEN_ENCODING_NAME: string;
+    ENABLE_BUILD_STATS: boolean;
+    ENABLE_TIMING_STATS: boolean;
+    PROCESSING_TIMEOUT_MS: number;
+    TOOL_PAIRING_FAILURE_WARNING_THRESHOLD: number;
+}
+/**
+ * Agent专用阶段执行优先级枚举
+ */
+declare enum AgentBuildPhase {
+    /** 阶段1: 核心上下文保留层 */
+    CORE_CONTEXT = 1,
+    /** 阶段2: 工作记忆填充层 (P1-P4优先级) */
+    WORKING_MEMORY = 2,
+    /** 阶段3: 历史摘要触发层 */
+    SUMMARIZATION = 3
+}
+/**
+ * Agent专用消息优先级枚举
+ */
+declare enum AgentMessagePriority {
+    /** P1: 工具交互 - 最高优先级 */
+    TOOL_INTERACTION = 1,
+    /** P2: 纯文本对话 - 高优先级 */
+    TEXT_CONVERSATION = 2,
+    /** P3: 历史工具交互 - 中优先级 */
+    HISTORICAL_TOOL = 3,
+    /** P4: 循环填充 - 低优先级 */
+    CIRCULAR_FILL = 4
+}
+/**
+ * Agent上下文构建统计接口
+ */
+interface AgentContextBuildStats {
+    /** 构建开始时间 */
+    startTime: number;
+    /** 各阶段执行时间 */
+    phaseTiming: Record<AgentBuildPhase, number>;
+    /** 各阶段token使用情况 */
+    phaseTokenUsage: Record<AgentBuildPhase, {
+        used: number;
+        percentage: number;
+    }>;
+    /** 消息数量统计 */
+    messageStats: {
+        original: number;
+        afterCoreContext: number;
+        afterWorkingMemory: number;
+        afterSummarization: number;
+    };
+    /** 优先级处理统计 */
+    priorityStats: {
+        p1ToolInteractions: number;
+        p2TextConversations: number;
+        p3HistoricalTools: number;
+        p4CircularFill: number;
+    };
+    /** 工具交互统计 */
+    toolStats: {
+        totalToolCalls: number;
+        pairedToolCalls: number;
+        unpairedToolCalls: number;
+        toolPairingSuccessRate: number;
+    };
+    /** 是否触发了摘要机制 */
+    summarizationTriggered: boolean;
+    /** 被摘要的消息数量 */
+    summarizedCount?: number;
+    /** 文档片段是否被截断 */
+    documentTruncated: boolean;
+    /** 总构建时间 */
+    totalTime: number;
+}
+/**
+ * 创建自定义Agent上下文构建配置的辅助函数
+ */
+declare function createAgentContextBuilderConfig(overrides: Partial<AgentContextBuilderConfig>): AgentContextBuilderConfig;
+/**
+ * 验证Agent配置有效性的辅助函数
+ */
+declare function validateAgentConfig(config: AgentContextBuilderConfig): boolean;
+
+type ProviderContext$1 = ProviderContext$2<AgentContextBuilderConfig>;
+interface IContextProvider$1 extends IContextProvider$2<AgentContextBuilderConfig> {
+}
+declare abstract class BaseContextProvider$1 extends BaseContextProvider$2<AgentContextBuilderConfig> implements IContextProvider$1 {
+}
+
+/**
+ * @file src/agent/context/providers/AgentCoreContextProvider.ts
+ * @description Agent专用核心上下文保留层Provider - 第一阶段上下文构建
+ *
+ * 🎯 职责: 识别并保留必须保留的核心消息（Agent专用逻辑）
+ * 📖 规则: 系统提示词、工具描述、最新用户输入、注入的上下文始终无条件保留
+ * ✨ Agent特性: 支持宿主通过 MustKeepPolicy 声明必保留 fence，确保工具调用上下文的完整性
+ * 🔧 工具优先: 优先保留工具调用相关的核心消息
+ *
+ * 🏗️ 架构优化: 工具描述现在由 AgentContextManager 统一管理，而不是在 MessageFormatter 中特殊处理
+ * 这确保了架构的一致性和调试的透明性
+ */
+
+interface AgentCoreContextProviderOptions {
+    mustKeepPolicy?: MustKeepPolicy;
+}
+/**
+ * Agent专用核心上下文保留层Provider
+ *
+ * 实现Agent README中描述的第一阶段：核心上下文保留层 (Must-Keep)
+ * 内容包括：系统提示词、用户当前请求、宿主显式声明的必保留 fence。
+ */
+declare class AgentCoreContextProvider extends BaseContextProvider$1 {
+    readonly name = "AgentCoreContextProvider";
+    readonly description = "Agent\u6838\u5FC3\u4E0A\u4E0B\u6587\u4FDD\u7559\u5C42 - \u8BC6\u522B\u5E76\u4FDD\u7559\u7CFB\u7EDF\u63D0\u793A\u8BCD\u3001\u6700\u65B0\u7528\u6237\u8F93\u5165\u548C\u6CE8\u5165\u7684\u4E0A\u4E0B\u6587";
+    readonly priority = 1;
+    private readonly mustKeepPolicy;
+    constructor(options?: AgentCoreContextProviderOptions);
+    provide(states: MessageProcessingState[], availableBudget: number, context: ProviderContext$1): Promise<ProviderResult>;
+    /**
+     * 判断是否为核心消息 - Agent专用逻辑
+     *
+     * 🎯 Agent核心上下文保留规则：
+     * 1. 保留 system_prompt（系统级消息）
+     * 2. 保留最新的 user 消息 (current_user_request)
+     * 3. 保留 MustKeepPolicy 指定的 fence
+     * 4. 对命中的 MustKeepPolicy.truncationRules 做 Token 截断
+     */
+    private isCoreMessage;
+    /**
+     * 内容截断 - 保持完整词汇
+     * 复用ContextManager中的逻辑
+     */
+    private truncateContent;
+}
+
+/**
+ * @file src/agent/context/providers/AgentWorkingMemoryProvider.ts
+ * @description Agent专用工作记忆填充层Provider - 第二阶段上下文构建
+ *
+ * 🎯 职责: 实现Agent的P1-P4优先级填充策略
+ * 📖 策略: P1(工具交互) > P2(纯文本对话) > P3(历史工具交互) > P4(循环填充)
+ * ✨ Agent特性: 工具调用优先级、配对保留策略
+ * 🔧 核心逻辑: 保留工具调用时，必须确保其对应的另一半也被保留
+ */
+
+/**
+ * Agent专用工作记忆填充层Provider
+ *
+ * 实现Agent README中描述的第二阶段：工作记忆填充层 (Working Memory)
+ * 工具调用为最高优先级，确保工具交互的完整性
+ */
+declare class AgentWorkingMemoryProvider extends BaseContextProvider$1 {
+    readonly name = "AgentWorkingMemoryProvider";
+    readonly description = "Agent\u5DE5\u4F5C\u8BB0\u5FC6\u586B\u5145\u5C42 - \u5DE5\u5177\u4F18\u5148\u7684\u53CD\u5411\u586B\u5145\u7B56\u7565\uFF0C\u652F\u6301\u914D\u5BF9\u4FDD\u7559";
+    readonly priority = 2;
+    private readonly matcher;
+    private readonly truncator;
+    private readonly tagger;
+    private readonly config;
+    constructor(customConfig?: Partial<AgentContextBuilderConfig>);
+    /**
+     * 类型守卫：用于安全读取 ProviderContext 上的"扩展字段"
+     * 注意：ProviderContext 本身是稳定契约，扩展字段来自编排层（不应污染接口定义）。
+     */
+    private isRecord;
+    /**
+     * 读取当前上下文阶段（如果编排层提供了 currentPhase）
+     * - 禁止 any 类型断言：这里用 Record 逐层收窄。
+     */
+    private readCurrentPhase;
+    /**
+     * 创建调试函数
+     */
+    private createDebugFn;
+    provide(states: MessageProcessingState[], availableBudget: number, context: ProviderContext$1): Promise<ProviderResult>;
+    /**
+     * 计算当前已使用的Token数
+     */
+    private calculateUsedTokens;
+}
+
+/**
+ * @file src/agent/context-manager/profiles/agent/context/providers/CheckpointSummarizationProvider.ts
+ * @description 上下文检查点 Provider（根因级语义修正版）：
+ *
+ * ✅ checkpoint 是一个“正常工具调用”，必须以 tool_calls → tool_output 的形式按顺序保留在历史中，
+ * 也必须按顺序进入发送给 LLM 的 messages（而不是被替换成 system history_summary 顶置到最前）。
+ *
+ * 🎯 checkpoint 的职责是“清理 checkpoint 之前的旧历史”，而不是“把 checkpoint 本身变成摘要”：
+ * - 保留：Must-Keep（system_prompt / 最新 user_input / 必保留 fence 等）、checkpoint 工具对、
+ *        以及 checkpoint 之前最近 N 对工具交互（默认 N=2）。
+ * - 清理：checkpoint 之前更旧的工具对 / final_answer / thought / 旧 history_summary 等。
+ *
+ * ✅ 设计原则：
+ * - checkpoint 只影响“本轮发给 LLM 的 messages 选择”，不生成任何 system 摘要事件；
+ * - 数据库仍然落全量事实历史：裁剪不会影响持久化/回放，只影响本轮 LLM 输入。
+ */
+
+interface CheckpointSummarizationProviderOptions {
+    /** checkpoint 之前保留的最近工具交互轮数。 */
+    keepPairsBefore?: number;
+    /** 触发 checkpoint 裁剪的工具名。默认 context_checkpoint。 */
+    triggerToolName?: string;
+}
+declare class CheckpointSummarizationProvider extends BaseContextProvider$1 {
+    readonly name = "CheckpointSummarizationProvider";
+    readonly description = "\u4E0A\u4E0B\u6587\u68C0\u67E5\u70B9 - \u4FDD\u7559 checkpoint \u5DE5\u5177\u5BF9\uFF0C\u88C1\u526A\u5176\u4E4B\u524D\u65E7\u5386\u53F2";
+    readonly priority = 2.5;
+    private readonly keepPairsBefore;
+    private readonly triggerToolName;
+    constructor(options?: CheckpointSummarizationProviderOptions);
+    provide(states: MessageProcessingState[], availableBudget: number, context: ProviderContext$1): Promise<ProviderResult>;
+    /**
+     * 在 states 中查找 context_checkpoint 工具的 observation
+     * 返回 { summary, checkpointStateIndex } 或 null
+     */
+    private findCheckpoint;
+    /**
+     * 找到 checkpoint 之前最近 N 轮工具交互 indices
+     * - 仅扫描 checkpoint tool_calls 之前的历史段
+     */
+    private findRecentToolPairIndicesBeforeCheckpoint;
+    private extractCheckpointSummaryFromGroup;
+}
+
+/**
+ * @file src/agent/context-manager/profiles/agent/context/providers/index.ts
+ * @description Agent profile provider 协议与实现导出
+ */
+
+declare class ContextProviderRegistry$1 extends ContextProviderRegistry$2<AgentContextBuilderConfig> {
+}
+
+type LogPayload = Record<string, unknown> | undefined;
+declare class Logger {
+    private readonly moduleName;
+    constructor(moduleName: string);
+    debug(message: string, data?: LogPayload): void;
+    info(message: string, data?: LogPayload): void;
+    warn(message: string, data?: LogPayload): void;
+    error(message: string, data?: LogPayload): void;
+    private log;
+}
+
+interface ContextPipelineStats<TPhase extends PropertyKey> {
+    phaseTiming: Record<TPhase, number>;
+    phaseTokenUsage: Record<TPhase, {
+        used: number;
+        percentage: number;
+    }>;
+    messageStats: {
+        original: number;
+        afterCoreContext: number;
+        afterWorkingMemory: number;
+        afterSummarization: number;
+    };
+}
+interface RunContextPipelineResult {
+    finalMessages: AiMessage[];
+    finalTokens: number;
+    strategiesApplied: string[];
+    events: RuntimeEvent[];
+    states: MessageProcessingState[];
+}
+
+interface ContextManagerBaseConfig {
+    AVG_CHARS_PER_TOKEN: number;
+    TOOL_CALL_OVERHEAD_TOKENS?: number;
+    TOKEN_ENCODING_NAME?: string;
+}
+interface ContextManagerBaseOptions<TConfig, TRegistry> {
+    debugMode?: boolean;
+    customConfig?: Partial<TConfig>;
+    providerRegistry?: TRegistry;
+    tokenizer?: TokenizerPort;
+    tokenizerModelId?: string;
+}
+interface ContextManagerBaseInit<TConfig, TRegistry> {
+    defaultConfig: TConfig;
+    validateConfig: (config: TConfig) => boolean;
+    createRegistry: () => TRegistry;
+    loggerName: string;
+    invalidConfigMessage: string;
+}
+declare abstract class ContextManagerBase<TConfig extends ContextManagerBaseConfig, TRegistry extends ContextProviderRegistry$2<TConfig>> {
+    protected config: TConfig;
+    protected debugMode: boolean;
+    protected providerRegistry: TRegistry;
+    protected logger: Logger;
+    protected tokenizer: TokenizerPort;
+    protected tokenizerModelId?: string;
+    private readonly validateConfigFn;
+    private readonly invalidConfigMessage;
+    private readonly hasCustomTokenizer;
+    protected constructor(options: ContextManagerBaseOptions<TConfig, TRegistry>, init: ContextManagerBaseInit<TConfig, TRegistry>);
+    private createDefaultTokenizer;
+    protected estimateTokens(message: AiMessage): number;
+    protected debug(message: string, data?: Record<string, unknown>): void;
+    protected runPipeline<TContext extends ProviderContext$2<TConfig>, TPhase extends PropertyKey, TStats extends ContextPipelineStats<TPhase>>(options: {
+        messages: AiMessage[];
+        totalBudget: number;
+        buildStats: TStats;
+        providerContext: TContext;
+        getPhaseByProviderName: (providerName: string) => TPhase | null;
+        contextTrace?: ContextTraceCollector;
+    }): Promise<RunContextPipelineResult>;
+    getConfig(): TConfig;
+    updateConfig(newConfig: Partial<TConfig>): void;
+    /**
+     * 更新传给 TokenizerPort 的模型 ID。
+     *
+     * 中文备注：同一个 context manager 被复用到不同模型时，host 必须同步更新这里；
+     * AgentMessageOrchestrator 会按 request 自动处理，直接使用 ContextManager 的高级接入方才需要手动调用。
+     */
+    updateTokenizerModelId(modelId: string | undefined): void;
+}
+
+/**
+ * 上下文构建结果接口
+ */
+interface ContextBuildResult$1 {
+    /** 构建后的消息列表 */
+    messages: AiMessage[];
+    /** Token使用情况 */
+    tokenUsage: {
+        used: number;
+        remaining: number;
+    };
+    /** 处理统计信息 */
+    processingStats: {
+        originalCount: number;
+        keptCount: number;
+        truncatedCount: number;
+        tokenDistribution: Record<string, number>;
+        strategiesApplied: string[];
+        recommendations: string[];
+        buildStats?: AgentContextBuildStats;
+    };
+    /** 是否进行了截断 */
+    truncated: boolean;
+    /** 截断的消息数量 */
+    truncatedCount?: number;
+    /** 应用的策略列表 */
+    strategies: {
+        applied: string[];
+        recommendations: string[];
+    };
+    /** 🔥 新增：Provider生成的运行时事件（如摘要事件） */
+    events?: RuntimeEvent[];
+    /** ContextTrace：解释本次上下文构建如何保留/裁剪消息。 */
+    contextTrace?: ContextTrace;
+}
+/**
+ * Agent专用智能上下文管理器
+ *
+ * 🎯 核心职责:
+ * 1. 编排Provider执行，构建优化的上下文
+ * 2. 保证工具调用的完整性和配对保留
+ * 3. 使用统一配置，不感知对话阶段
+ *
+ * 🏗️ 架构特性:
+ * - Provider策略模式: 实现高内聚、低耦合
+ * - 责任链模式: 按优先级编排Provider
+ * - 专注于Provider编排，不负责消息构建
+ */
+declare class AgentContextManager extends ContextManagerBase<AgentContextBuilderConfig, ContextProviderRegistry$1> {
+    constructor(options?: {
+        debugMode?: boolean;
+        customConfig?: Partial<AgentContextBuilderConfig>;
+        providerRegistry?: ContextProviderRegistry$1;
+        tokenizer?: TokenizerPort;
+        tokenizerModelId?: string;
+    });
+    /**
+     * 主入口：为Agent构建智能上下文
+     * 专门处理预处理过的消息，专注于上下文优化
+     */
+    buildContextFromPreprocessedMessages(request: AgentProfileRequest, conversationSession: ConversationSession, preprocessedMessages: AiMessage[], totalBudget: number, callbacks?: SummarizationCallbacks, phaseOverride?: AgentBuildPhase, // 保留参数兼容性，但不再使用
+    generate?: (request: GenerateRequest) => Promise<GenerateResponse>, traceOptions?: {
+        policy?: AgentSpecContextTracePolicy;
+        effectiveContextPolicy?: AgentSpecContextPolicy;
+    }): Promise<ContextBuildResult$1>;
+    /**
+     * 根据Provider名称获取对应的阶段名称
+     */
+    private getPhaseByProviderName;
+    private initializeBuildStats;
+    private buildFinalResult;
+    /**
+     * 生成优化建议
+     */
+    private generateRecommendations;
+}
+
+declare const index$5_AGENT_CONTEXT_BUILDER_CONFIG: typeof AGENT_CONTEXT_BUILDER_CONFIG;
+type index$5_AgentBuildPhase = AgentBuildPhase;
+declare const index$5_AgentBuildPhase: typeof AgentBuildPhase;
+type index$5_AgentContextBuildStats = AgentContextBuildStats;
+type index$5_AgentContextBuilderConfig = AgentContextBuilderConfig;
+type index$5_AgentContextManager = AgentContextManager;
+declare const index$5_AgentContextManager: typeof AgentContextManager;
+type index$5_AgentCoreContextProvider = AgentCoreContextProvider;
+declare const index$5_AgentCoreContextProvider: typeof AgentCoreContextProvider;
+type index$5_AgentMessagePriority = AgentMessagePriority;
+declare const index$5_AgentMessagePriority: typeof AgentMessagePriority;
+type index$5_AgentWorkingMemoryProvider = AgentWorkingMemoryProvider;
+declare const index$5_AgentWorkingMemoryProvider: typeof AgentWorkingMemoryProvider;
+type index$5_CheckpointSummarizationProvider = CheckpointSummarizationProvider;
+declare const index$5_CheckpointSummarizationProvider: typeof CheckpointSummarizationProvider;
+type index$5_ConversationSession = ConversationSession;
+declare const index$5_ConversationSession: typeof ConversationSession;
+declare const index$5_MessageProcessingState: typeof MessageProcessingState;
+declare const index$5_ProviderResult: typeof ProviderResult;
+declare const index$5_SummarizationCallbacks: typeof SummarizationCallbacks;
+type index$5_SummarizationProvider = SummarizationProvider;
+declare const index$5_SummarizationProvider: typeof SummarizationProvider;
+declare const index$5_createAgentContextBuilderConfig: typeof createAgentContextBuilderConfig;
+declare const index$5_validateAgentConfig: typeof validateAgentConfig;
+declare namespace index$5 {
+  export { index$5_AGENT_CONTEXT_BUILDER_CONFIG as AGENT_CONTEXT_BUILDER_CONFIG, index$5_AgentBuildPhase as AgentBuildPhase, type index$5_AgentContextBuildStats as AgentContextBuildStats, type index$5_AgentContextBuilderConfig as AgentContextBuilderConfig, index$5_AgentContextManager as AgentContextManager, index$5_AgentCoreContextProvider as AgentCoreContextProvider, index$5_AgentMessagePriority as AgentMessagePriority, index$5_AgentWorkingMemoryProvider as AgentWorkingMemoryProvider, BaseContextProvider$1 as BaseContextProvider, index$5_CheckpointSummarizationProvider as CheckpointSummarizationProvider, type ContextBuildResult$1 as ContextBuildResult, ContextProviderRegistry$1 as ContextProviderRegistry, index$5_ConversationSession as ConversationSession, type IContextProvider$1 as IContextProvider, index$5_MessageProcessingState as MessageProcessingState, type ProviderContext$1 as ProviderContext, index$5_ProviderResult as ProviderResult, index$5_SummarizationCallbacks as SummarizationCallbacks, index$5_SummarizationProvider as SummarizationProvider, index$5_createAgentContextBuilderConfig as createAgentContextBuilderConfig, index$5_validateAgentConfig as validateAgentConfig };
+}
+
+type MissingSidecarBehavior = 'allow' | 'degrade_to_text' | 'provider_empty_replay_field';
+interface ToolReplayProtocolPolicy {
+    provider?: string;
+    requiresReasoningDetailsForToolReplay?: boolean;
+    missingSidecarBehavior?: MissingSidecarBehavior;
+}
+/**
+ * Preprocessor context object
+ */
+interface PreprocessorContext {
+    debugMode?: boolean;
+    model?: string;
+    toolReplayProtocolPolicy?: ToolReplayProtocolPolicy;
+    toolSummaryProvider?: ToolSummaryProvider;
+}
+/**
+ * Result of a preprocessor run
+ */
+interface PreprocessorResult {
+    /** 预处理后的消息列表 */
+    messages: AiMessage[];
+    /** 预处理统计信息 */
+    stats: {
+        /** 原始消息数量 */
+        originalCount: number;
+        /** 处理后消息数量 */
+        processedCount: number;
+        /** 被移除的消息数量 */
+        removedCount: number;
+        /** 被修改的消息数量 */
+        modifiedCount: number;
+    };
+    /** 应用的策略列表 */
+    appliedStrategies: string[];
+}
+/**
+ * 预处理器接口 - 管道模式的核心契约
+ */
+interface IPreprocessor {
+    /** 预处理器名称 */
+    readonly name: string;
+    /** 预处理器描述 */
+    readonly description: string;
+    /** 执行顺序优先级 (数字越小越先执行) */
+    readonly priority: number;
+    /**
+     * 预处理方法 - 管道模式的核心方法
+     *
+     * @param messages 输入的消息列表
+     * @param context 预处理上下文
+     * @returns 预处理结果
+     */
+    process(messages: AiMessage[], context: PreprocessorContext): Promise<PreprocessorResult>;
+    /**
+     * 可选：判断是否应该跳过此预处理器
+     *
+     * @param messages 输入的消息列表
+     * @param context 预处理上下文
+     * @returns true表示跳过，false表示执行
+     */
+    shouldSkip?(messages: AiMessage[], context: PreprocessorContext): boolean;
+}
+/**
+ * 预处理器基类 - 提供通用功能实现
+ */
+declare abstract class BasePreprocessor implements IPreprocessor {
+    abstract readonly name: string;
+    abstract readonly description: string;
+    abstract readonly priority: number;
+    abstract process(messages: AiMessage[], context: PreprocessorContext): Promise<PreprocessorResult>;
+    /**
+     * 默认的跳过逻辑 - 子类可以覆盖
+     */
+    shouldSkip?(messages: AiMessage[], context: PreprocessorContext): boolean;
+    /**
+     * 创建预处理结果的辅助方法
+     */
+    protected createResult(originalMessages: AiMessage[], processedMessages: AiMessage[], appliedStrategies: string[], modifiedCount?: number): PreprocessorResult;
+    /**
+     * 调试日志辅助方法
+     */
+    protected debug(message: string, data?: Record<string, unknown>, context?: PreprocessorContext): void;
+}
+
+type ToolHistoryCompressionStrategy = 'per-pair' | 'per-run' | 'none';
+type ToolHistoryOverflowStrategy = 'keep-latest' | 'fail-fast';
+interface ToolHistoryCompressorOptions {
+    strategy?: ToolHistoryCompressionStrategy;
+    keepLatestToolPairs?: number;
+    keepLatestRuns?: number;
+    maxInteractionGroups?: number;
+    overflowStrategy?: ToolHistoryOverflowStrategy;
+    maxPairTokens?: number;
+    maxOutputSummaryTokens?: number;
+}
+/**
+ * 工具历史压缩预处理器。
+ *
+ * 三种策略边界：
+ * - per-pair：旧行为，按全局最近 N 组完整工具交互保留，其余压成自然语言记录。
+ * - per-run：按 user_input 划分 run，完整保留最近 K 个历史 run 内的工具组，避免腰斩同一轮工具链。
+ * - none：不做常规压缩，仅在 maxInteractionGroups 显式触发时执行安全阀。
+ *
+ * 注意：单个 tool_output 的 token 截断不在这里做，那是 WorkingMemory 阶段
+ * 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 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 selectGroupsToKeep;
+    private enforceMaxInteractionGroups;
+    private compressToolInteractionGroup;
+}
+
+interface ToolReplayProtocolGuardOptions {
+    policy?: ToolReplayProtocolPolicy;
+    priority?: number;
+}
+declare function resolveToolReplayProtocolPolicy(context: PreprocessorContext, explicitPolicy?: ToolReplayProtocolPolicy): ToolReplayProtocolPolicy;
+/**
+ * Agent 工具回放协议守卫。
+ *
+ * 中文说明：
+ * - 正向链路必须优先保证真实 provider sidecar 不丢；
+ * - 这里仅处理“已经进入历史轮次”的旧工具组，避免它们继续伪装成结构化 replay；
+ * - 当前轮次的工具组不在这里降级，否则会掩盖新链路丢 sidecar 的根因。
+ */
+declare class ToolReplayProtocolGuardPreprocessor extends BasePreprocessor {
+    readonly name = "ToolReplayProtocolGuardPreprocessor";
+    readonly description = "\u5DE5\u5177\u56DE\u653E\u534F\u8BAE\u5B88\u536B - \u5BF9\u8981\u6C42 provider sidecar \u7684\u5386\u53F2\u5DE5\u5177\u7EC4\u6267\u884C\u7ED3\u6784\u5316\u56DE\u653E\u6CBB\u7406";
+    readonly priority: number;
+    private readonly explicitPolicy?;
+    constructor(options?: ToolReplayProtocolGuardOptions);
+    shouldSkip(messages: AiMessage[], context: PreprocessorContext): boolean;
+    process(messages: AiMessage[], context: PreprocessorContext): Promise<PreprocessorResult>;
+}
+
+interface DefaultAgentPreprocessorRegistryOptions {
+    fenceRegistry?: FenceRegistry;
+    toolHistory?: ToolHistoryCompressorOptions;
+    providerReplay?: ToolReplayProtocolPolicy;
+}
+/**
+ * 预处理器注册表 - 管理所有预处理器及其执行顺序
+ */
+declare class PreprocessorRegistry {
+    private preprocessors;
+    /**
+     * 注册预处理器
+     */
+    register(preprocessor: IPreprocessor): void;
+    /**
+     * 获取指定名称的预处理器
+     */
+    getPreprocessor(name: string): IPreprocessor | undefined;
+    /**
+     * 获取所有预处理器，按优先级排序
+     */
+    getAllPreprocessors(): IPreprocessor[];
+    /**
+     * 获取已注册的预处理器名称列表
+     */
+    getRegisteredNames(): string[];
+    /**
+     * 检查是否已注册指定预处理器
+     */
+    isRegistered(name: string): boolean;
+    /**
+     * 获取注册的预处理器数量
+     */
+    getCount(): number;
+}
+/**
+ * 预处理管道 - 按顺序执行所有预处理器
+ */
+declare class PreprocessorPipeline {
+    private registry;
+    private context;
+    constructor(registry: PreprocessorRegistry, context?: PreprocessorContext);
+    /**
+     * 执行完整的预处理管道
+     *
+     * @param messages 输入消息列表
+     * @returns 预处理管道的汇总结果
+     */
+    process(messages: AiMessage[]): Promise<PreprocessorPipelineResult>;
+    /**
+     * 更新预处理上下文
+     */
+    updateContext(newContext: Partial<PreprocessorContext>): void;
+    /**
+     * 获取当前上下文
+     */
+    getContext(): PreprocessorContext;
+    /**
+     * 调试日志
+     */
+    private debug;
+}
+/**
+ * 预处理管道结果接口
+ */
+interface PreprocessorPipelineResult {
+    /** 预处理后的消息列表 */
+    messages: AiMessage[];
+    /** 管道级别的统计信息 */
+    pipelineStats: {
+        originalCount: number;
+        finalCount: number;
+        totalRemovedCount: number;
+        processingTime: number;
+        preprocessorsExecuted: number;
+        appliedStrategies: string[];
+    };
+    /** 各个预处理器的详细结果 */
+    individualResults: Array<{
+        preprocessor: string;
+        result: PreprocessorResult;
+    }>;
+}
+/**
+ * 创建默认的Agent预处理器注册表
+ *
+ * 🔥 这里定义了Agent预处理管道的默认配置：
+ * 1. ToolHistoryCompressorPreprocessor (priority: 0) - 工具历史压缩，最先执行
+ * 2. ToolReplayProtocolGuardPreprocessor (priority: 0.5) - 工具回放协议守卫，仅治理历史轮次
+ * 3. HistoryPurificationPreprocessor (priority: 1) - Agent历史净化，在压缩后执行
+ *
+ * 💡 未来可扩展:
+ * 3. AgentToolCallValidationPreprocessor (priority: 2) - 工具调用验证
+ * 4. AgentContextOptimizationPreprocessor (priority: 3) - 上下文优化
+ */
+declare function createDefaultAgentPreprocessorRegistry(options?: DefaultAgentPreprocessorRegistryOptions): PreprocessorRegistry;
+/**
+ * 创建默认的Agent预处理管道
+ *
+ * @param context 预处理上下文配置
+ * @returns 配置好的Agent预处理管道实例
+ */
+declare function createDefaultAgentPreprocessorPipeline(context?: PreprocessorContext, options?: DefaultAgentPreprocessorRegistryOptions): PreprocessorPipeline;
+
+type index$4_BasePreprocessor = BasePreprocessor;
+declare const index$4_BasePreprocessor: typeof BasePreprocessor;
+type index$4_DefaultAgentPreprocessorRegistryOptions = DefaultAgentPreprocessorRegistryOptions;
+type index$4_FenceLifetimePreprocessor = FenceLifetimePreprocessor;
+declare const index$4_FenceLifetimePreprocessor: typeof FenceLifetimePreprocessor;
+type index$4_HistoryPurificationPreprocessor = HistoryPurificationPreprocessor;
+declare const index$4_HistoryPurificationPreprocessor: typeof HistoryPurificationPreprocessor;
+type index$4_IPreprocessor = IPreprocessor;
+type index$4_MissingSidecarBehavior = MissingSidecarBehavior;
+type index$4_PreprocessorContext = PreprocessorContext;
+type index$4_PreprocessorPipeline = PreprocessorPipeline;
+declare const index$4_PreprocessorPipeline: typeof PreprocessorPipeline;
+type index$4_PreprocessorPipelineResult = PreprocessorPipelineResult;
+type index$4_PreprocessorRegistry = PreprocessorRegistry;
+declare const index$4_PreprocessorRegistry: typeof PreprocessorRegistry;
+type index$4_PreprocessorResult = PreprocessorResult;
+type index$4_ToolHistoryCompressionStrategy = ToolHistoryCompressionStrategy;
+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_ToolReplayProtocolGuardOptions = ToolReplayProtocolGuardOptions;
+type index$4_ToolReplayProtocolGuardPreprocessor = ToolReplayProtocolGuardPreprocessor;
+declare const index$4_ToolReplayProtocolGuardPreprocessor: typeof ToolReplayProtocolGuardPreprocessor;
+type index$4_ToolReplayProtocolPolicy = ToolReplayProtocolPolicy;
+declare const index$4_createDefaultAgentPreprocessorPipeline: typeof createDefaultAgentPreprocessorPipeline;
+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 };
+}
+
+interface ToolManagerRegistry extends ToolSummaryProvider {
+    getAvailableToolNames(toolNames?: string[]): string[];
+    validateToolCall(toolName: string, args: ToolArgs): {
+        success: boolean;
+        error?: string;
+    };
+}
+interface DynamicToolContext {
+    request: AgentProfileRequest;
+}
+declare class ToolManager {
+    private readonly registry;
+    constructor(registry: ToolManagerRegistry);
+    getAvailableToolNames(context: DynamicToolContext): string[];
+    validateToolCall(toolName: string, args: ToolArgs, context: DynamicToolContext): {
+        success: boolean;
+        error?: string;
+    };
+    getSummaryProvider(): ToolSummaryProvider;
+}
+
+interface IAgentTask {
+    readonly name: string;
+    buildMessages(request: AgentProfileRequest, history: AiMessage[]): AiMessage[];
+    processResponse(rawResponse: string): string;
+    processStreamChunk(chunk: string): string;
+    getPreferredModelCapability?(): string;
+}
+type AgentTaskResolver = (promptKey: string) => IAgentTask;
+interface IAgentTaskRegistry {
+    register(promptKey: string, task: IAgentTask): void;
+    getTask(promptKey: string): IAgentTask | null;
+    getAllTaskKeys(): string[];
+}
+
+interface AgentOrchestratorOptions {
+    tokenBudget: {
+        maxTokens: number;
+        reservedForResponse: number;
+    };
+    processing: {
+        debugMode?: boolean;
+        preserveMetadata?: boolean;
+    };
+    model?: string;
+    resolveToolReplayProtocolPolicy?: (params: {
+        request: AgentProfileRequest;
+        modelId: string;
+    }) => ToolReplayProtocolPolicy | undefined;
+    resolveContextPolicy?: (request: AgentProfileRequest) => AgentSpecContextPolicy | undefined;
+    createProviderRegistry?: (params: {
+        request: AgentProfileRequest;
+        contextPolicy: AgentSpecContextPolicy | undefined;
+        contextBuilderConfig: Partial<AgentContextBuilderConfig>;
+    }) => ContextProviderRegistry$1;
+    taskResolver: AgentTaskResolver;
+    providerRegistry: ContextProviderRegistry$1;
+    fenceRegistry?: FenceRegistry;
+    tokenizer?: TokenizerPort;
+}
+interface AgentProcessingResult {
+    messages: AiMessage[];
+    contextBuildResult: ContextBuildResult$1;
+    metadata: {
+        originalCount: number;
+        processedCount: number;
+        tokenUsage: {
+            estimated: number;
+            budget: number;
+            remaining: number;
+        };
+        processingStats: ContextBuildResult$1['processingStats'];
+        truncated: boolean;
+        truncatedCount?: number;
+    };
+}
+declare class AgentMessageOrchestrator {
+    private agentContextManager;
+    private options;
+    private readonly taskResolver;
+    private baseContextConfig;
+    constructor(options: AgentOrchestratorOptions);
+    private buildPreprocessorPipelineForRequest;
+    private resolvePreprocessorModel;
+    private resolveContextPolicy;
+    private applyContextPolicy;
+    processAgentConversation(request: AgentProfileRequest, history: RuntimeEvent[], toolManager: ToolManager, callbacks?: SummarizationCallbacks, extraOptions?: {
+        generate?: (request: GenerateRequest) => Promise<GenerateResponse>;
+    }): Promise<AgentProcessingResult>;
+    private buildCompleteMessageList;
+    private runPreprocessorPipeline;
+    private buildContextFromPreprocessedMessages;
+    private debug;
+    updateOptions(newOptions: Partial<AgentOrchestratorOptions>): void;
+    getContextManager(): AgentContextManager;
+    getContextInfo(): {
+        config: AgentContextBuilderConfig;
+    };
+}
+
+type index$3_AgentMessageOrchestrator = AgentMessageOrchestrator;
+declare const index$3_AgentMessageOrchestrator: typeof AgentMessageOrchestrator;
+type index$3_AgentOrchestratorOptions = AgentOrchestratorOptions;
+type index$3_AgentProcessingResult = AgentProcessingResult;
+declare namespace index$3 {
+  export { index$3_AgentMessageOrchestrator as AgentMessageOrchestrator, type index$3_AgentOrchestratorOptions as AgentOrchestratorOptions, type index$3_AgentProcessingResult as AgentProcessingResult };
+}
+
+/**
+ * @file src/agent/context-manager/profiles/agent/tasks/BaseAgentTask.ts
+ * @description Agent任务的抽象基类 - 处理Agent通用逻辑
+ *
+ * 🔥 重构：借鉴 BaseConversationalTask 的轻量级设计
+ * 专注于核心消息构建，将复杂的上下文管理交给 AgentContextManager
+ */
+
+interface BaseAgentTaskOptions {
+    fenceRegistry?: FenceRegistry;
+}
+/**
+ * Agent任务的抽象基类
+ *
+ * @abstract
+ * @description
+ * 现在只负责构建 Agent 任务的核心消息骨架：
+ * - system prompt
+ * - host-provided context injection messages
+ * - 当前 user query
+ * - 按时序附加 history
+ */
+declare abstract class BaseAgentTask implements IAgentTask {
+    abstract readonly name: string;
+    private readonly fenceRegistry?;
+    constructor(options?: BaseAgentTaskOptions);
+    protected abstract getSystemPrompt(request: AgentProfileRequest): string;
+    getSystemPromptForRequest(request: AgentProfileRequest): string;
+    buildMessages(request: AgentProfileRequest, history: AiMessage[]): AiMessage[];
+    private createFenceMessages;
+    private createFenceMessage;
+    private insertAfterLastToolResult;
+    processResponse(rawResponse: string): string;
+    processStreamChunk(chunk: string): string;
+}
+
+type index$2_AgentTaskResolver = AgentTaskResolver;
+type index$2_BaseAgentTask = BaseAgentTask;
+declare const index$2_BaseAgentTask: typeof BaseAgentTask;
+type index$2_IAgentTask = IAgentTask;
+type index$2_IAgentTaskRegistry = IAgentTaskRegistry;
+declare namespace index$2 {
+  export { type index$2_AgentTaskResolver as AgentTaskResolver, index$2_BaseAgentTask as BaseAgentTask, type index$2_IAgentTask as IAgentTask, type index$2_IAgentTaskRegistry as IAgentTaskRegistry };
+}
+
+type index$1_DynamicToolContext = DynamicToolContext;
+type index$1_ToolManager = ToolManager;
+declare const index$1_ToolManager: typeof ToolManager;
+type index$1_ToolManagerRegistry = ToolManagerRegistry;
+declare namespace index$1 {
+  export { type index$1_DynamicToolContext as DynamicToolContext, index$1_ToolManager as ToolManager, type index$1_ToolManagerRegistry as ToolManagerRegistry };
+}
+
+declare function convertEventToAiMessage(event: RuntimeEvent): AiMessage;
+declare function convertEventsToAiMessages(events: RuntimeEvent[]): AiMessage[];
+declare function convertAiMessageToEvent(message: AiMessage, overrides?: Partial<RuntimeEvent>): RuntimeEvent;
+
+type ToolCallRecord = {
+    id: string;
+    type?: string;
+    function?: {
+        name?: string;
+        arguments?: string;
+    };
+};
+interface ToolInteractionGroupBuildOptions {
+    /**
+     * 工具调用与工具结果允许相隔的最大消息数。
+     *
+     * 中文备注：超过窗口的 tool_output 不再配对，避免很旧的 tool_calls 被远处结果误粘连。
+     */
+    maxPairingDistance?: number;
+    /** 识别 checkpoint 工具组的工具名。默认保持 0.5.x 的 context_checkpoint。 */
+    checkpointToolName?: string;
+}
+interface ToolInteractionGroupItem<T> {
+    toolCallId: string;
+    toolName: string;
+    toolArgs: Record<string, unknown>;
+    toolCall: ToolCallRecord;
+    toolOutputs: T[];
+    toolOutputMessages: AiMessage[];
+    rawOutputs: string[];
+}
+interface ToolInteractionGroup<T> {
+    anchorId: string;
+    /** 工具组所属的用户轮次序号：0 表示第一条 user_input 之前，之后每遇到一条 user_input 递增。 */
+    runOrdinal: number;
+    assistantState: T;
+    assistantMessage: AiMessage;
+    assistantIndex: number;
+    toolOutputs: T[];
+    toolOutputMessages: AiMessage[];
+    toolOutputIndexes: number[];
+    toolCallIds: string[];
+    toolNames: string[];
+    sourceMessageIds: string[];
+    messageIndexes: number[];
+    startIndex: number;
+    endIndex: number;
+    isCheckpointGroup: boolean;
+    isComplete: boolean;
+    isCompressed: boolean;
+    items: ToolInteractionGroupItem<T>[];
+    messages: T[];
+}
+declare function collectToolInteractionGroups<T extends MessageProcessingState>(states: T[]): ToolInteractionGroup<T>[];
+declare function buildToolInteractionGroupsFromMessages(messages: AiMessage[], options?: {
+    startIndex?: number;
+    endIndexExclusive?: number;
+}): ToolInteractionGroup<AiMessage>[];
+declare function buildToolInteractionGroupsFromStates(states: MessageProcessingState[], options?: ToolInteractionGroupBuildOptions): ToolInteractionGroup<MessageProcessingState>[];
+declare function findCurrentRunStartIndex(messages: AiMessage[]): number;
+/** @deprecated 使用 findCurrentRunStartIndex。旧名保留一个 sprint，避免下游 deep import 立刻断裂。 */
+declare const findCurrentRoundStartIndex: typeof findCurrentRunStartIndex;
+declare function findLastUserInputOriginalIndex(states: MessageProcessingState[]): number | null;
+
+type UnknownRecord = Record<string, unknown>;
+interface SummarizerConfig {
+    fullContentThreshold: number;
+    textPreviewLength: number;
+    arrayPreviewCount: number;
+    objectPreviewFieldCount: number;
+}
+declare const DEFAULT_SUMMARIZER_CONFIG: SummarizerConfig;
+declare class ToolOutputSummarizer {
+    private config;
+    constructor(config?: Partial<SummarizerConfig>);
+    getSummary(toolName: string, output: string, toolSummaryProvider?: ToolSummaryProvider, toolArgs?: UnknownRecord): string;
+    formatToolArgs(args: UnknownRecord): string;
+    private tryToolSpecificSummary;
+    private createGenericSummary;
+    private summarizeArray;
+    private summarizeObject;
+    private summarizeText;
+}
+declare const createDefaultToolOutputSummarizer: (config?: Partial<SummarizerConfig>) => ToolOutputSummarizer;
+declare const summarizeToolOutput: (toolName: string, output: string, toolSummaryProvider?: ToolSummaryProvider, toolArgs?: UnknownRecord, config?: Partial<SummarizerConfig>) => string;
+
+declare const index_DEFAULT_SUMMARIZER_CONFIG: typeof DEFAULT_SUMMARIZER_CONFIG;
+type index_SummarizerConfig = SummarizerConfig;
+type index_ToolInteractionGroup<T> = ToolInteractionGroup<T>;
+type index_ToolInteractionGroupItem<T> = ToolInteractionGroupItem<T>;
+type index_ToolOutputSummarizer = ToolOutputSummarizer;
+declare const index_ToolOutputSummarizer: typeof ToolOutputSummarizer;
+declare const index_buildToolInteractionGroupsFromMessages: typeof buildToolInteractionGroupsFromMessages;
+declare const index_buildToolInteractionGroupsFromStates: typeof buildToolInteractionGroupsFromStates;
+declare const index_collectToolInteractionGroups: typeof collectToolInteractionGroups;
+declare const index_convertAiMessageToEvent: typeof convertAiMessageToEvent;
+declare const index_convertEventToAiMessage: typeof convertEventToAiMessage;
+declare const index_convertEventsToAiMessages: typeof convertEventsToAiMessages;
+declare const index_createDefaultToolOutputSummarizer: typeof createDefaultToolOutputSummarizer;
+declare const index_findCurrentRoundStartIndex: typeof findCurrentRoundStartIndex;
+declare const index_findCurrentRunStartIndex: typeof findCurrentRunStartIndex;
+declare const index_findLastUserInputOriginalIndex: typeof findLastUserInputOriginalIndex;
+declare const index_summarizeToolOutput: typeof summarizeToolOutput;
+declare namespace index {
+  export { index_DEFAULT_SUMMARIZER_CONFIG as DEFAULT_SUMMARIZER_CONFIG, type index_SummarizerConfig as SummarizerConfig, type index_ToolInteractionGroup as ToolInteractionGroup, type index_ToolInteractionGroupItem as ToolInteractionGroupItem, index_ToolOutputSummarizer as ToolOutputSummarizer, index_buildToolInteractionGroupsFromMessages as buildToolInteractionGroupsFromMessages, index_buildToolInteractionGroupsFromStates as buildToolInteractionGroupsFromStates, index_collectToolInteractionGroups as collectToolInteractionGroups, index_convertAiMessageToEvent as convertAiMessageToEvent, index_convertEventToAiMessage as convertEventToAiMessage, index_convertEventsToAiMessages as convertEventsToAiMessages, index_createDefaultToolOutputSummarizer as createDefaultToolOutputSummarizer, index_findCurrentRoundStartIndex as findCurrentRoundStartIndex, index_findCurrentRunStartIndex as findCurrentRunStartIndex, index_findLastUserInputOriginalIndex as findLastUserInputOriginalIndex, index_summarizeToolOutput as summarizeToolOutput };
+}
+
+/**
+ * 上下文构建策略配置的类型定义
+ * 使用通用类型（如 number）而不是字面量类型，以增加灵活性
+ */
+type ContextBuilderConfig = {
+    readonly DEFAULT_MAX_TOKENS: number;
+    readonly RESERVED_FOR_RESPONSE: number;
+    readonly SUMMARIZATION_TRIGGER_THRESHOLD: number;
+    readonly SUMMARY_BUDGET_PERCENTAGE: number;
+    readonly SUMMARY_OLDEST_MESSAGES_PERCENTAGE: number;
+    readonly DOCUMENT_FRAGMENT_MAX_PERCENTAGE: number;
+    readonly THINKING_RECALL_COUNT: number;
+    readonly CORE_MESSAGE_TYPES: readonly ('system_prompt' | 'user_input' | 'document_fragment')[];
+    readonly PRIORITY_CONTENT_TYPES: readonly ('final_answer' | 'task_completion' | 'user_input')[];
+    readonly SECONDARY_CONTENT_TYPES: readonly ('thought')[];
+    readonly AVG_CHARS_PER_TOKEN: number;
+    readonly TOKEN_ENCODING_NAME: string;
+    readonly ENABLE_BUILD_STATS: boolean;
+    readonly ENABLE_TIMING_STATS: boolean;
+    readonly PROCESSING_TIMEOUT_MS: number;
+    readonly LARGE_SUMMARIZATION_WARNING_THRESHOLD: number;
+};
+/**
+ * 阶段执行优先级枚举
+ * 用于标识和排序3个构建阶段
+ */
+declare enum BuildPhase {
+    /** 阶段1: 核心上下文保留层 */
+    CORE_CONTEXT = 1,
+    /** 阶段2: 工作记忆填充层 */
+    WORKING_MEMORY = 2,
+    /** 阶段3: 历史摘要触发层 */
+    SUMMARIZATION = 3
+}
+/**
+ * 上下文构建统计接口
+ */
+interface ContextBuildStats {
+    /** 构建开始时间 */
+    startTime: number;
+    /** 各阶段执行时间 */
+    phaseTiming: Record<BuildPhase, number>;
+    /** 各阶段token使用情况 */
+    phaseTokenUsage: Record<BuildPhase, {
+        used: number;
+        percentage: number;
+    }>;
+    /** 消息数量统计 */
+    messageStats: {
+        original: number;
+        afterCoreContext: number;
+        afterWorkingMemory: number;
+        afterSummarization: number;
+    };
+    /** 是否触发了摘要机制 */
+    summarizationTriggered: boolean;
+    /** 被摘要的消息数量 */
+    summarizedCount?: number;
+    /** 文档片段是否被截断 */
+    documentTruncated: boolean;
+    /** 总构建时间 */
+    totalTime: number;
+}
+/**
+ * 获取默认Token配置的辅助函数
+ * @returns Token预算配置对象
+ */
+declare function getDefaultTokenConfig(): {
+    maxTokens: number;
+    reservedForResponse: number;
+    availableForContext: number;
+};
+
+type ProviderContext = ProviderContext$2<ContextBuilderConfig>;
+interface IContextProvider extends IContextProvider$2<ContextBuilderConfig> {
+}
+declare abstract class BaseContextProvider extends BaseContextProvider$2<ContextBuilderConfig> implements IContextProvider {
+}
+
+/**
+ * @file src/chat/context/providers/CoreContextProvider.ts
+ * @description 核心上下文保留层Provider - 第一阶段上下文构建
+ *
+ * 🎯 职责: 识别并保留必须保留的核心消息
+ * 📖 规则: 系统提示词、最新用户输入、文档片段始终无条件保留
+ * ✨ 特性: 支持文档片段智能截断，确保核心请求的完整性
+ */
+
+/**
+ * 核心上下文保留层Provider
+ *
+ * 实现README中描述的第一阶段：核心上下文保留层 (Must-Keep)
+ * 内容包括：系统提示词、用户意图块(最新用户输入+相关上下文信息)
+ */
+declare class CoreContextProvider extends BaseContextProvider {
+    readonly name = "CoreContextProvider";
+    readonly description = "\u6838\u5FC3\u4E0A\u4E0B\u6587\u4FDD\u7559\u5C42 - \u8BC6\u522B\u5E76\u4FDD\u7559\u7CFB\u7EDF\u63D0\u793A\u8BCD\u3001\u6700\u65B0\u7528\u6237\u8F93\u5165\u548C\u6587\u6863\u7247\u6BB5";
+    readonly priority = 1;
+    provide(states: MessageProcessingState[], availableBudget: number, context: ProviderContext): Promise<ProviderResult>;
+    /**
+     * 判断是否为核心消息
+     * 🔥 关键设计：只保留真正的核心消息
+     */
+    private isCoreMessage;
+    /**
+     * 内容截断 - 保持完整词汇
+     * 复用ContextManager中的逻辑
+     */
+    private truncateContent;
+}
+
+/**
+ * @file src/chat/context/providers/WorkingMemoryProvider.ts
+ * @description 工作记忆填充层Provider - 第二阶段上下文构建
+ *
+ * 🎯 职责: 使用剩余预算，从最近的历史消息开始反向逐条填充
+ * 📖 策略: P1优先级(最终回答) + P2优先级(思维链回补)
+ * ✨ 特性: 智能内容提取，最大化保留对话的"事实"和"结论"
+ *
+ * 🧩 说明（Chat 与工具消息）：
+ * - Chat 模式下，来自 Agent 历史的 `tool_calls/tool_output` 默认会被 `ToolHistoryFilterPreprocessor` 过滤掉，
+ *   因此本 Provider 不承担“工具交互优先级/配对保留”等职责（这些属于 AgentWorkingMemoryProvider）。
+ */
+
+/**
+ * 工作记忆填充层Provider
+ *
+ * 实现README中描述的第二阶段：工作记忆填充层 (Working Memory)
+ * 使用剩余预算反向填充，优先保留最终回答，其次回补思维链
+ */
+declare class WorkingMemoryProvider extends BaseContextProvider {
+    readonly name = "WorkingMemoryProvider";
+    readonly description = "\u5DE5\u4F5C\u8BB0\u5FC6\u586B\u5145\u5C42 - \u53CD\u5411\u586B\u5145\u6700\u7EC8\u56DE\u7B54\u548C\u601D\u7EF4\u94FE\uFF0C\u6700\u5927\u5316\u4FDD\u7559\u5BF9\u8BDD\u4E8B\u5B9E";
+    readonly priority = 2;
+    provide(states: MessageProcessingState[], availableBudget: number, context: ProviderContext): Promise<ProviderResult>;
+    /**
+     * P1优先级处理：反向填充最终回答部分
+     */
+    private processP1Priority;
+    /**
+     * P2优先级处理：回补思维链 + 历史摘要
+     *
+     * 💬 处理顺序（参考 AgentWorkingMemoryProvider）：
+     * 1. 首先处理 history_summary（如果有）
+     * 2. 然后回补思维链
+     */
+    private processP2Priority;
+    /**
+     * 计算当前已使用的Token数
+     */
+    private calculateUsedTokens;
+    /**
+     * 提取AI消息的最终回答部分（移除<think>标签内容）
+     */
+    private extractFinalAnswerContent;
+}
+
+/**
+ * @file src/agent/context-manager/profiles/chat/context/providers/index.ts
+ * @description Chat profile provider 协议与实现导出
+ */
+
+declare class ContextProviderRegistry extends ContextProviderRegistry$2<ContextBuilderConfig> {
+}
+
+/**
+ * 上下文构建结果接口 - 与TokenBudgetManager保持兼容
+ */
+interface ContextBuildResult {
+    /** 构建后的消息列表 */
+    messages: AiMessage[];
+    /** Token使用情况 */
+    tokenUsage: {
+        used: number;
+        remaining: number;
+    };
+    /** 处理统计信息 - 兼容TokenBudgetManager格式 */
+    processingStats: {
+        originalCount: number;
+        keptCount: number;
+        truncatedCount: number;
+        tokenDistribution: Record<string, number>;
+        strategiesApplied: string[];
+        recommendations: string[];
+        buildStats?: ContextBuildStats;
+    };
+    /** 是否进行了截断 */
+    truncated: boolean;
+    /** 截断的消息数量 */
+    truncatedCount?: number;
+    /** 应用的策略列表 */
+    strategies: {
+        applied: string[];
+        recommendations: string[];
+    };
+    /** 🔥 新增：Provider生成的运行时事件（如摘要事件） */
+    events?: RuntimeEvent[];
+}
+/**
+ * 智能上下文管理器 - Provider编排器
+ *
+ * 🎯 职责: 编排各个ContextProvider，协调3阶段上下文构建流程
+ * 🏗️ 架构: 策略模式 + 责任链模式，实现高内聚、低耦合
+ */
+declare class ContextManager extends ContextManagerBase<ContextBuilderConfig, ContextProviderRegistry> {
+    constructor(options?: {
+        debugMode?: boolean;
+        customConfig?: Partial<ContextBuilderConfig>;
+        providerRegistry?: ContextProviderRegistry;
+        tokenizer?: TokenizerPort;
+        tokenizerModelId?: string;
+    });
+    /**
+     * 主入口：构建智能上下文 - Provider编排模式
+     */
+    buildContext(messages: AiMessage[], totalBudget: number, callbacks?: SummarizationCallbacks, generate?: (request: GenerateRequest) => Promise<GenerateResponse>): Promise<ContextBuildResult>;
+    /**
+     * 根据Provider名称获取对应的阶段名称
+     */
+    private getPhaseByProviderName;
+    private initializeBuildStats;
+    private buildFinalResult;
+    /**
+     * 生成优化建议
+     */
+    private generateRecommendations;
+    /**
+     * 获取Provider注册表（用于测试或调试）
+     */
+    getProviderRegistry(): ContextProviderRegistry;
+    /**
+     * 注册新的Provider
+     */
+    registerProvider(provider: IContextProvider): void;
+}
+
+/**
+ * @file src/agent/context-manager/profiles/chat/tasks/base.ts
+ *
+ * @brief 定义所有聊天任务处理器必须遵守的接口。
+ *
+ * @description
+ * 每个业务场景（如自动补全、批注、标准聊天）都应实现此接口。
+ * 这确保了 ChatService 可以用统一的方式调用它们。
+ */
+
+interface IChatTask {
+    /**
+     * 根据前端请求构建发送给大模型的完整消息数组。
+     *
+     * @param request 前端发来的生成请求
+     * @returns 格式化后的 ChatMessage 数组
+     */
+    buildMessages(request: GenerateRequest): ChatMessage[];
+    /**
+     * (可选) 声明此任务是否应走“短链路”处理，
+     * 即绕过复杂的上下文管理，直接将 buildMessages 的结果发送给 AI。
+     * @default false
+     */
+    useSimpleProcessing?: boolean;
+    /**
+     * [新增] 声明此任务偏好使用的模型能力。
+     * 如果设置了此项，并且用户没有在请求中明确指定 modelId，
+     * ChatService会优先查找并使用具备该能力的模型。
+     * @example 'fast_assistant'
+     */
+    preferredModelCapability?: string;
+    /**
+     * 对LLM返回的完整响应进行后处理。
+     * @param rawResponse LLM返回的原始字符串
+     * @returns 经过处理后的、适合返回给前端的文本
+     *
+     * @description
+     * 不同的任务场景对响应内容有不同的处理需求：
+     * - 聊天/批注：保留 <think>...</think> 标签，让用户看到思考过程
+     * - 自动补全：过滤掉所有思考内容，只返回干净的补全文本
+     */
+    processResponse(rawResponse: string): string;
+    /**
+     * 对流式生成的单个内容块进行处理。
+     *
+     * @param chunk 流式生成的单个内容块
+     * @returns 处理后的内容块，如果应该跳过则返回空字符串
+     *
+     * @description
+     * 用于流式生成场景，让每个任务决定是否要过滤某些流式块：
+     * - 聊天/批注：直接返回原块，保留所有内容
+     * - 自动补全：过滤掉包含 <think> 标签的块
+     */
+    processStreamChunk(chunk: string): string;
+}
+type ChatTaskResolver = (promptKey?: string) => IChatTask;
+
+/**
+ * 编排器配置选项
+ */
+interface OrchestratorOptions {
+    /** Token预算配置 (现在由ContextManager内部管理，但保留API以兼容旧用法) */
+    tokenBudget: {
+        maxTokens: number;
+        reservedForResponse: number;
+    };
+    /** 处理选项 */
+    processing: {
+        enableMerge?: boolean;
+        enableBatch?: boolean;
+        debugMode?: boolean;
+        preserveMetadata?: boolean;
+    };
+    /** 系统提示词 */
+    systemPrompt?: string;
+    /** 模型名称 (用于精确Token计算) */
+    model?: string;
+    /** 任务解析器 */
+    taskResolver: ChatTaskResolver;
+    providerRegistry: ContextProviderRegistry;
+    tokenizer?: TokenizerPort;
+}
+/**
+ * 处理结果接口
+ */
+interface ProcessingResult {
+    /** 处理后的消息 (AI引擎格式) */
+    messages: ChatMessage[];
+    /** 完整的上下文构建结果，包含详细统计信息 */
+    contextBuildResult: ContextBuildResult;
+    /** 处理元信息 */
+    metadata: {
+        originalCount: number;
+        processedCount: number;
+        tokenUsage: {
+            estimated: number;
+            budget: number;
+            remaining: number;
+        };
+        processingStats: ContextBuildResult['processingStats'];
+        truncated: boolean;
+        truncatedCount?: number;
+    };
+}
+/**
+ * 消息处理编排器
+ *
+ * 实现完整的处理流程：解析 → 分发 → 上下文构建 → 注入系统提示词 → 转换
+ */
+declare class MessageOrchestrator {
+    private contextManager;
+    private preprocessorPipeline;
+    private options;
+    private readonly taskResolver;
+    constructor(options: OrchestratorOptions);
+    /**
+     * 🔥 新增：与 AgentOrchestrator 对称的主方法
+     * 负责从 AgentProfileRequest 构建完整的初始消息列表，然后进行处理
+     */
+    processChatConversation(request: AgentProfileRequest, callbacks?: SummarizationCallbacks, generate?: (request: GenerateRequest) => Promise<GenerateResponse>): Promise<ProcessingResult>;
+    /**
+     * 核心编排方法 - 处理一个预构建好的对话历史
+     */
+    processConversation(messages: AiMessage[], callbacks?: SummarizationCallbacks, generate?: (request: GenerateRequest) => Promise<GenerateResponse>): Promise<ProcessingResult>;
+    /**
+     * 封装了 buildContext 和 convertToChatMessages 的逻辑
+     */
+    private buildAndFinalizeContext;
+    /**
+     * 1. 解析和验证消息 - 直接使用原始消息，不进行格式转换
+     */
+    private parseAndValidateMessages;
+    /**
+     * 🔥 2. [预处理管道] - 运行所有注册的预处理器
+     */
+    private runPreprocessorPipeline;
+    private resolveTokenizerModelId;
+    /**
+     * 3. [上下文构建] - 调用ContextManager进行智能Token预算和消息构建
+     */
+    private buildContext;
+    /**
+     * 4. [最终格式化] - 将内部AiMessage格式转换为外部API的ChatMessage格式
+     */
+    private convertToChatMessages;
+    /**
+     * 调试日志
+     */
+    private debug;
+    /**
+     * 更新配置
+     */
+    updateOptions(newOptions: Partial<OrchestratorOptions>): void;
+    /**
+     * 获取预算管理器 (用于高级配置) - 已更新为上下文管理器
+     */
+    getContextManager(): ContextManager;
+    /**
+     * 获取预算管理状态 - 已更新为上下文管理状态
+     */
+    getContextInfo(): {
+        config: ContextBuilderConfig;
+    };
+}
+
+/**
+ * @file src/agent/context-manager/profiles/chat/tasks/BaseConversationalTask.ts
+ *
+ * @brief 对话型任务的抽象基类 - 处理多轮对话场景的通用逻辑
+ *
+ * @description
+ * BaseConversationalTask 是所有需要处理对话历史的任务的抽象基类。
+ *
+ * 🔥 设计理念（参考 BaseAgentTask）：
+ * - Task层：构建核心的、必须的消息（系统提示词 + 文档上下文 + 当前用户输入）
+ * - ContextManager层：处理复杂的上下文管理、历史编排、Token优化
+ *
+ * 它封装了对话型任务的标准流程：
+ * 1. 添加系统提示词（由子类实现）
+ * 2. 添加文档上下文（如果提供）
+ * 3. 添加当前用户输入（如果历史中没有用户消息）
+ * 4. 附加完整的对话历史（不做任何过滤，保留所有消息包括 history_summary）
+ *
+ * 与工具型任务的区别：
+ * - 工具型任务：使用 useSimpleProcessing=true，不处理对话历史，专注于单次请求
+ * - 对话型任务：处理完整的对话上下文，支持多轮对话
+ */
+
+/**
+ * 对话型任务的抽象基类
+ *
+ * @abstract
+ * @description
+ * 🔥 参考 BaseAgentTask 的轻量级设计，专注于核心消息构建
+ *
+ * 所有需要处理对话历史的任务都应该继承此类。
+ * 该基类实现了标准的对话上下文构建流程，子类只需要实现系统提示词的获取。
+ *
+ * 重要特性：
+ * - 不过滤任何历史消息，完整保留对话历史（包括 history_summary）
+ * - 复杂的上下文管理由 ContextManager 层处理
+ */
+declare abstract class BaseConversationalTask implements IChatTask {
+    /**
+     * 对话型任务默认使用完整处理链路（MessageOrchestrator）
+     */
+    readonly useSimpleProcessing = false;
+    /**
+     * 抽象方法：子类必须实现此方法来提供特定的系统提示词
+     *
+     * @abstract
+     * @returns 系统提示词字符串
+     */
+    protected abstract getSystemPrompt(request: GenerateRequest): string;
+    /**
+     * 构建对话消息的标准流程
+     *
+     * @description
+     * 🔥 参考 BaseAgentTask 的实现，实现了所有对话型任务都需要的标准流程：
+     * 1. 添加系统提示词 - Task层拥有对系统指令的完全控制权
+     * 2. 添加文档片段（如果有）
+     * 3. 添加当前用户输入（仅当历史中没有用户消息时）
+     * 4. 附加完整的对话历史（不做任何过滤，保留所有消息包括 history_summary）
+     *
+     * @param request 生成请求
+     * @returns 构建好的消息数组
+     */
+    buildMessages(request: GenerateRequest): ChatMessage[];
+    /**
+     * 默认的响应处理 - 保留完整内容包括思考过程
+     *
+     * @description
+     * 对话型任务通常保留完整的响应内容，包括 <think> 标签，
+     * 让用户看到AI的思考过程。子类可以覆盖此方法来实现特定的处理逻辑。
+     *
+     * @param rawResponse LLM返回的原始响应
+     * @returns 处理后的响应文本
+     */
+    processResponse(rawResponse: string): string;
+    /**
+     * 默认的流式块处理 - 直接返回原块
+     *
+     * @description
+     * 对话型任务通常直接返回原始流式块，保留所有内容包括思考过程。
+     * 子类可以覆盖此方法来实现特定的处理逻辑。
+     *
+     * @param chunk 流式内容块
+     * @returns 处理后的内容块
+     */
+    processStreamChunk(chunk: string): string;
+}
+
+/**
+ * 将 RuntimeEvent 转换为 ChatMessage
+ * (供 HistoryBuilder 使用，用于 Chat 模式的历史构建)
+ */
+declare function convertEventToChatMessage(event: RuntimeEvent): ChatMessage | null;
+/**
+ * 批量转换 RuntimeEvent 数组为 ChatMessage 数组
+ * (用于 Chat 模式的历史构建)
+ */
+declare function convertEventsToChatMessages(events: RuntimeEvent[]): ChatMessage[];
+
+declare function aiMessageToChatMessage(aiMessage: AiMessage): ChatMessage;
+declare function chatMessageToAiMessage(chatMessage: ChatMessage, options?: {
+    id?: string;
+    timestamp?: number;
+}): AiMessage;
+
+interface ChatGenerateRequestAdapterInput extends AgentProfileRequest {
+    context_before?: string;
+    context_after?: string;
+    current_paragraph?: string;
+    document_fragment?: string;
+    document_title?: string;
+    project_metadata?: {
+        id?: string;
+        name?: string;
+        description?: string;
+    };
+    document_metadata?: {
+        id?: string;
+        title?: string;
+    };
+    user_quote?: {
+        text: string;
+        source?: Record<string, unknown>;
+        display_label?: string;
+    };
+    completionLengthHint?: string;
+    recentRejections?: GenerateRequest['recentRejections'];
+}
+/**
+ * Product request adapter:
+ * - keeps AgentInvokeRequest -> GenerateRequest conversion out of orchestrator core
+ * - makes the remaining app-specific request shape explicit and replaceable
+ */
+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 };