Compression

export declare class CompressionManager {
    constructor(config: CompressionManagerConfig);
    /**
     * Set the fallback model (used when config.model is not provided).
     * Called by the Agent with its primary model so compression can work without explicit model config.
     */
    setFallbackModel(model: ModelProvider): void;
    /** Reset per-run state. Call at the start of each agent run. */
    reset(): void;
    /**
     * Process messages before an LLM call. Compresses tool results when thresholds are exceeded.
     * Designed to be called from the LoopHooks.beforeLLMCall hook.
     */
    process(messages: ChatMessage[], modelId?: string): Promise<ChatMessage[] | undefined>;
    /** Track tool result additions to count toward compressAfter threshold. */
    trackToolResult(): void;
}

export interface CompressionManagerConfig {
    /** Model used for compression summaries. Falls back to main model if not set. */
    model?: ModelProvider;
    /** Compress after N uncompressed tool results. Default: 3. */
    compressAfter?: number;
    /** Compress when total context exceeds this token count. Takes priority over compressAfter. */
    tokenLimit?: number;
    /** Custom compression prompt. */
    instructions?: string;
}