/**
 * Smart trace format and OS detector.
 *
 * Detection is content-based (magic bytes + content scanning), not extension-based.
 * This is important because users may upload HarmonyOS text traces with arbitrary
 * extensions (.trace, .txt, etc.).
 *
 * Two-layer strategy:
 *   Layer 1 — Magic bytes (zero-cost, first 128 bytes)
 *   Layer 2 — Content feature scan (sample first 64KB)
 *
 * Supported formats:
 *   - perfetto_protobuf: standard Perfetto protobuf traces (Android)
 *   - systrace_text: standard Android systrace/atrace text
 *   - atrace_text: HarmonyOS hitrace text output (standard ftrace text with HarmonyOS markers)
 */
export type TraceFormat = 'perfetto_protobuf' | 'systrace_text' | 'atrace_text' | 'unknown';
export type TraceOs = 'android' | 'harmonyos' | 'unknown';
export interface TraceFormatInfo {
    format: TraceFormat;
    os: TraceOs;
    confidence: number;
    detectionMethod: 'magic' | 'content_scan' | 'probe_query';
    /** Human-readable explanation for logging/debugging. */
    reason?: string;
}
/**
 * Detect the format and OS of a trace file by inspecting its content.
 *
 * @param filePath Absolute path to the trace file.
 * @returns TraceFormatInfo with format, os, confidence, and detection method.
 */
export declare function detectTraceFormat(filePath: string): Promise<TraceFormatInfo>;
/**
 * Synchronous version for use in non-async contexts (e.g., factory constructors).
 * Reads only up to SCAN_SIZE bytes.
 */
export declare function detectTraceFormatSync(filePath: string): TraceFormatInfo;
//# sourceMappingURL=traceFormatDetector.d.ts.map