import type { DB } from '../../data/db/index.js';
export interface CopyOnErrorResult {
    /** Rows newly inserted into `trace_retained` (rows already retained excluded). */
    readonly traces: number;
    /** Rows newly inserted into `trace_step_retained`. */
    readonly steps: number;
}
/**
 * Copy an errored trace and its parent spine into the cold retained tables.
 *
 * `traceId` is the trace that ended badly. Its ancestry is walked through
 * `parent_id` to the root; every trace on that spine, plus all of their steps,
 * is inserted into `trace_retained` / `trace_step_retained`. Returns the count
 * of rows actually inserted — zero for both when everything was already
 * retained, or when `traceId` does not exist.
 */
export declare function copyTraceOnError(db: DB, traceId: string): Promise<CopyOnErrorResult>;
//# sourceMappingURL=copy-on-error.d.ts.map