/**
 * CoreEngine Downcity 模型上下文压缩模块。
 *
 * 压缩基于标准 ModelMessage，保留 system、最新 user 及其后的完整工具事务。
 */
import type { ModelMessage } from "@downcity/type";
/** usage 达到模型上下文窗口 95% 时安排下一 step 压缩。 */
export declare const MODEL_CONTEXT_COMPACTION_TRIGGER_RATIO = 0.95;
/** 压缩后的真实 usage 需要回落到模型上下文窗口 50% 以内。 */
export declare const MODEL_CONTEXT_COMPACTION_TARGET_RATIO = 0.5;
/** 读取 Provider usage 中的实际总 token。 */
export declare function resolve_model_usage_tokens(usage: unknown): number | null;
/** 计算真实 usage 占当前模型上下文窗口的比例。 */
export declare function resolve_model_usage_ratio(usage: unknown, context_window: number | undefined): number | null;
/** 判断一次真实 usage 是否要求下一 step 继续压缩。 */
export declare function should_compact_after_usage(usage_ratio: number | null, validating_compaction: boolean): boolean;
/** 对当前模型消息做一次确定性深度压缩。 */
export declare function deep_compact_model_messages(messages: ModelMessage[], compact_depth?: number): ModelMessage[];
/** 对文本做确定性的 head/tail 折叠。 */
export declare function fold_compacted_text(text: string, max_chars: number): string;
//# sourceMappingURL=CoreEngineContextCompaction.d.ts.map