/**
 * Health cascade span helpers.
 *
 * Creates point-in-time spans for each CASCADE_APPLIED event from the
 * health cascade engine. These are not lifecycle spans but event spans —
 * they start and end immediately to record the cascade effect in the trace.
 *
 * Health cascade spans are always root spans (no parent) since they are
 * cross-domain events that may span multiple domain lifecycles.
 */
import type { Span } from '../types.js';
import type { RuntimeTracer } from '../tracer.js';
import type { CascadeAppliedEvent } from '../../health/types.js';
/** Context supplied when recording a health cascade span. */
export interface HealthCascadeSpanContext {
    /** Trace ID for cross-span correlation. */
    readonly traceId: string;
    /** Optional parent span ID if the cascade is causally linked to a specific operation. */
    readonly parentSpanId?: string | undefined;
}
/**
 * Record a health cascade as a point-in-time span.
 *
 * Starts and immediately ends the span since the cascade is an instantaneous
 * event rather than an ongoing lifecycle. The span captures rule, source,
 * target, and effect details.
 *
 * @param tracer - RuntimeTracer instance.
 * @param event - The CASCADE_APPLIED event from the health engine.
 * @param ctx - Optional trace context for correlation.
 */
export declare function recordHealthCascadeSpan(tracer: RuntimeTracer, event: CascadeAppliedEvent, ctx?: HealthCascadeSpanContext): Span;
//# sourceMappingURL=health.d.ts.map