export interface MeshEventTraceCtx {
    /** Primary correlation anchor — the mesh task id (meshActiveTaskId / metadataEvent.taskId). */
    taskId?: unknown;
    /** Optional per-event id when the producer assigns one. */
    eventId?: unknown;
    /** Worker session id — the fallback anchor when no task is attached. */
    sessionId?: unknown;
    nodeId?: unknown;
    meshId?: unknown;
    event?: unknown;
}
/**
 * Stable, greppable correlation key. `task=` and `sess=` are ALWAYS rendered (as `-`
 * when absent) so the key shape is uniform across stages and a single grep alternation
 * (`task=<id>\|sess=<id>`) follows the event end-to-end.
 */
export declare function meshEventTraceKey(ctx: MeshEventTraceCtx): string;
/** Lifecycle progress (INFO). One line per stage the event clears. */
export declare function traceMeshEventStage(stage: string, ctx: MeshEventTraceCtx, detail?: string): void;
/** Event did not advance — rejected / held / skipped / deduped (WARN). */
export declare function traceMeshEventDrop(reason: string, ctx: MeshEventTraceCtx, detail?: string): void;
