import type { TraceSession } from './trace-ir.js';
export interface TraceSessionRef {
    traceId?: string;
    traceSessionId?: string;
    sessionId: string;
    sourceTrace?: string;
}
export interface TraceSessionIndex {
    resolve(ref: TraceSessionRef): TraceSession | undefined;
}
export declare function traceSessionRefIdentity(ref: TraceSessionRef): string;
/**
 * Resolve projected segments back to their physical evidence stream.
 *
 * `sourcePath` is not an identity: one Markdown log can contain many sessions.
 * Prefer the globally unique traceId, then source + concrete run id. Single-key
 * fallbacks are only retained when unambiguous.
 */
export declare function createTraceSessionIndex(sessions: TraceSession[]): TraceSessionIndex;