export type AutoCheckpointConfig = {
    enabled: boolean;
    beforeCommands: string[];
    stashWhenDirty: boolean;
};
export declare function readAutoCheckpointConfig(effective: Record<string, unknown> | undefined): AutoCheckpointConfig;
/**
 * When kit.autoCheckpoint.enabled, persist a head or stash checkpoint before selected commands.
 * Fail-closed on errors (operator opted in).
 */
export declare function tryAutoCheckpointBeforeRun(opts: {
    workspacePath: string;
    effectiveConfig: Record<string, unknown>;
    subcommand: string;
    actor: string | null;
}): Promise<{
    ok: true;
    checkpointId?: string;
    skippedReason?: string;
} | {
    ok: false;
    code: string;
    message: string;
}>;
