export type LogLevel = "debug" | "info" | "warn" | "error";
export type ActivityStatus = "ok" | "error" | "denied" | "skipped";
export interface LogEntry {
    timestamp: string;
    level: LogLevel;
    event: string;
    harness: string;
    data?: Record<string, unknown>;
}
export interface ActivityEntry {
    timestamp: string;
    level: "activity";
    event: string;
    harness: string;
    status: ActivityStatus;
    durationMs: number;
    sessionId?: string;
    attributes?: Record<string, unknown>;
}
export type UnifiedLogEntry = LogEntry | ActivityEntry;
export type ActivityEnricher = () => Record<string, unknown> | undefined;
export type ActivitySink = (entry: ActivityEntry) => void;
export declare function redactLogData(value: unknown): unknown;
export declare function activityValueHash(value: string): string;
/** Convert arbitrary strings to correlation-safe summaries for always-on activity. */
export declare function sanitizeActivityAttributes(attributes: Record<string, unknown>): Record<string, unknown>;
export declare class ActiveActivity {
    private readonly logger;
    private readonly event;
    private readonly baseAttributes?;
    private readonly sessionId?;
    private readonly startedAt;
    private readonly timestamp;
    private endedEntry;
    constructor(logger: DebugLogger, event: string, baseAttributes?: Record<string, unknown> | undefined, sessionId?: string | undefined);
    get ended(): boolean;
    end(status: ActivityStatus, attributes?: Record<string, unknown>): ActivityEntry;
}
export declare class DebugLogger {
    static stderrSuppressed: boolean;
    enabled: boolean;
    readonly harness: string;
    readonly logFile: string | null;
    private readonly activityEntries;
    private activityEnricher;
    private activitySink;
    constructor(harness: string, opts?: {
        logFile?: string;
    });
    get isEnabled(): boolean;
    enable(): void;
    disable(): void;
    setActivityEnricher(enricher: ActivityEnricher | null): void;
    setActivitySink(sink: ActivitySink | null): void;
    activities(): ReadonlyArray<ActivityEntry>;
    startActivity(event: string, attributes?: Record<string, unknown>, sessionId?: string): ActiveActivity;
    activity(event: string, status: ActivityStatus, options?: {
        attributes?: Record<string, unknown>;
        durationMs?: number;
        sessionId?: string;
        timestamp?: string;
    }): ActivityEntry;
    log(level: LogLevel, event: string, data?: Record<string, unknown>): void;
    debug(event: string, data?: Record<string, unknown>): void;
    info(event: string, data?: Record<string, unknown>): void;
    warn(event: string, data?: Record<string, unknown>): void;
    error(event: string, data?: Record<string, unknown>): void;
    private writeToStderr;
    private writeToFile;
}
export interface FormattedLogEntryParts {
    time: string;
    event: string;
    marker: string;
    details: string[];
}
export declare function formatLogEntryParts(entry: UnifiedLogEntry): FormattedLogEntryParts;
export declare function formatLogEntry(entry: UnifiedLogEntry): string;
export declare function withQuietStderr<T>(fn: () => Promise<T> | T): Promise<T>;