interface TraceEntry {
    ts: string;
    sessionId?: string;
    event?: string;
    payload?: unknown;
}
export declare function appendTraceEntry(cwd: string, sessionId: string, entry: Omit<TraceEntry, "ts" | "sessionId">): void;
/** Last `limit` entries of a session (default 50; most recent session if omitted). */
export declare function traceTimeline(cwd: string, sessionId?: string, limit?: number): {
    sessionId?: string;
    entries: TraceEntry[];
};
/** Event-name counts for a session. */
export declare function traceSummary(cwd: string, sessionId?: string): {
    sessionId?: string;
    total: number;
    counts: Record<string, number>;
};
export {};