/**
 * Context Analytics Utility
 *
 * Provides context analytics data for observability/traces.
 * No console logging - just data structures for event emission.
 */
import type { BaseMessage } from '@langchain/core/messages';
import type { TokenCounter } from '@/types/run';
/** Context analytics data for traces */
export interface ContextAnalytics {
    /** Total messages in context */
    messageCount: number;
    /** Total tokens in context */
    totalTokens: number;
    /** Maximum allowed context tokens */
    maxContextTokens?: number;
    /** Instruction/system tokens */
    instructionTokens?: number;
    /** Context utilization percentage (0-100) */
    utilizationPercent?: number;
    /** Breakdown by message type */
    breakdown?: Record<string, {
        tokens: number;
        percent: number;
    }>;
}
/**
 * Build context analytics for traces (no logging).
 *
 * @param messages - Array of BaseMessage (may originate from different @langchain/core installations)
 * @param options  - Token counting and context budget info
 */
export declare function buildContextAnalytics(messages: BaseMessage[], options: {
    tokenCounter?: TokenCounter;
    maxContextTokens?: number;
    instructionTokens?: number;
    indexTokenCountMap?: Record<string, number | undefined>;
}): ContextAnalytics;