import type { AgentRunTelemetryType } from '../../interfaces'; import { Telemetry } from '../../telemetry'; export type KnowledgeToolCall = 'file_find' | 'file_search' | 'file_read' | 'vector_store_search'; export type KnowledgeToolCallResult = { failed: false; contentChars: number; readFile?: { fileId: string; uploadedAt: string; }; searchDurationMs?: number; emptySearch?: boolean; } | { failed: true; searchDurationMs?: number; errorType?: string; }; export type FinishKnowledgeToolCall = (result: KnowledgeToolCallResult) => void; export interface KnowledgeRunUsage { file_find_count: number; file_search_count: number; file_read_count: number; vector_store_search_count: number; file_content_chars: number; vector_store_content_chars: number; file_failed_count: number; vector_store_failed_count: number; } export declare class AgentKnowledgeUsageTracker { private readonly telemetry; private readonly runs; constructor(telemetry: Telemetry); sendRunUsage(runId: string, run: { agentId: string; runType: AgentRunTelemetryType; userId?: string; }): void; startToolCall(runId: string | undefined, call: KnowledgeToolCall): FinishKnowledgeToolCall; takeRunUsage(runId: string): KnowledgeRunUsage | undefined; private takeRun; private removeStaleRuns; }