import type { LiveTraceDetails, LiveTraceSink, LiveTraceStatus, LiveTraceSubsystem } from "../../types/locus.types.js";
import type { LiveMapRootMode } from "../../types/livemap.types.js";
/** Locus-local, operation-scoped causation carried from an action to its commit. */
export type LocusCommitCausation = Readonly<{
    sourceTraceId: string;
    requestId?: string;
    attemptId?: string;
    logicalMapId: string;
    incarnationId: string;
    mapMode: LiveMapRootMode;
    origin: string;
    sourceAction: string;
}>;
type LiveTraceDetailsFactory = () => LiveTraceDetails;
type LiveTraceEmission = Readonly<{
    subsystem: LiveTraceSubsystem;
    phase: string;
    status: LiveTraceStatus;
    spanId?: string;
    parentSpanId?: string;
    durationMs?: number;
    details?: LiveTraceDetailsFactory;
}>;
export type LiveTraceSpan = Readonly<{
    spanId: string;
    success: (details?: LiveTraceDetailsFactory) => void;
    failure: (details?: LiveTraceDetailsFactory) => void;
    skip: (details?: LiveTraceDetailsFactory) => void;
}>;
export type LiveTraceContext = Readonly<{
    traceId: string;
    emit: (emission: LiveTraceEmission) => void;
    beginSpan: (subsystem: LiveTraceSubsystem, phase: string, parentSpanId?: string, details?: LiveTraceDetailsFactory) => LiveTraceSpan;
}>;
/** Create one Locus-local causal trace. Sequence numbers begin at one. */
export declare function create_live_trace_context(sink: LiveTraceSink, traceId: string, now?: () => number): LiveTraceContext;
export {};
//# sourceMappingURL=locus.trace.d.ts.map