/**
 * Trace operation utilities
 * Single Responsibility: Execute operations with tracing context
 */
import { type LogContext } from '@kitiumai/logger';
/**
 * Trace a test operation with automatic span creation and logging
 */
export declare function traceTest<T>(operationName: string, operation: (spanId: string) => Promise<T> | T, metadata?: Record<string, unknown>, traceContext?: LogContext): Promise<T>;
/**
 * Trace a child operation within a parent span
 */
export declare function traceChild<T>(parentSpanId: string, operationName: string, operation: (childSpanId: string) => Promise<T> | T, metadata?: Record<string, unknown>, traceContext?: LogContext): Promise<T>;
/**
 * Start a new trace context for a test
 */
export declare function startTestTrace(testName: string): LogContext;
/**
 * End the current trace context
 * Note: Context is scoped by withLoggingContext; explicit clearing is unnecessary
 */
export declare function endTestTrace(): void;
/**
 * Run a function within a fresh test trace context
 */
export declare function withTestTrace<T>(testName: string, function_: () => Promise<T> | T, metadata?: Record<string, unknown>): Promise<T> | T;
//# sourceMappingURL=trace-operations.d.ts.map