import type { ConfigFileSnapshot } from "./types.openclaw.js";
export type ObserveRecoveryDeps = {
    fs: {
        promises: {
            stat(path: string): Promise<{
                mtimeMs?: number;
                ctimeMs?: number;
                dev?: number | bigint;
                ino?: number | bigint;
                mode?: number;
                nlink?: number;
                uid?: number;
                gid?: number;
            } | null>;
            readFile(path: string, encoding: BufferEncoding): Promise<string>;
            writeFile(path: string, data: string, options?: {
                encoding?: BufferEncoding;
                mode?: number;
                flag?: string;
            }): Promise<unknown>;
            copyFile(src: string, dest: string): Promise<unknown>;
            chmod?(path: string, mode: number): Promise<unknown>;
            mkdir(path: string, options?: {
                recursive?: boolean;
                mode?: number;
            }): Promise<unknown>;
            appendFile(path: string, data: string, options?: {
                encoding?: BufferEncoding;
                mode?: number;
            }): Promise<unknown>;
        };
        statSync(path: string, options?: {
            throwIfNoEntry?: boolean;
        }): {
            mtimeMs?: number;
            ctimeMs?: number;
            dev?: number | bigint;
            ino?: number | bigint;
            mode?: number;
            nlink?: number;
            uid?: number;
            gid?: number;
        } | null;
        readFileSync(path: string, encoding: BufferEncoding): string;
        writeFileSync(path: string, data: string, options?: {
            encoding?: BufferEncoding;
            mode?: number;
            flag?: string;
        }): unknown;
        copyFileSync(src: string, dest: string): unknown;
        chmodSync?(path: string, mode: number): unknown;
        mkdirSync(path: string, options?: {
            recursive?: boolean;
            mode?: number;
        }): unknown;
        appendFileSync(path: string, data: string, options?: {
            encoding?: BufferEncoding;
            mode?: number;
        }): unknown;
    };
    json5: {
        parse(value: string): unknown;
    };
    env: NodeJS.ProcessEnv;
    homedir: () => string;
    logger: Pick<typeof console, "warn">;
};
type ObserveSnapshot = {
    path: string;
    exists: boolean;
    valid: boolean;
    raw: string | null;
    hash?: string;
    parsed: unknown;
    resolved?: unknown;
};
export declare function resolveLastKnownGoodConfigPath(configPath: string): string;
export declare function maybeRecoverSuspiciousConfigRead(params: {
    deps: ObserveRecoveryDeps;
    configPath: string;
    raw: string;
    parsed: unknown;
}): Promise<{
    raw: string;
    parsed: unknown;
}>;
export declare function maybeRecoverSuspiciousConfigReadSync(params: {
    deps: ObserveRecoveryDeps;
    configPath: string;
    raw: string;
    parsed: unknown;
}): {
    raw: string;
    parsed: unknown;
};
export declare function observeConfigSnapshot(deps: ObserveRecoveryDeps, snapshot: ObserveSnapshot): Promise<void>;
export declare function observeConfigSnapshotSync(deps: ObserveRecoveryDeps, snapshot: ObserveSnapshot): void;
export declare function promoteConfigSnapshotToLastKnownGood(params: {
    deps: ObserveRecoveryDeps;
    snapshot: ConfigFileSnapshot;
    logger?: Pick<typeof console, "warn">;
}): Promise<boolean>;
export declare function recoverConfigFromLastKnownGood(params: {
    deps: ObserveRecoveryDeps;
    snapshot: ConfigFileSnapshot;
    reason: string;
}): Promise<boolean>;
export {};