import { type RuntimeState } from './config.js';
import type { ShutdownReason } from './local-control.js';
export type StopMode = 'control-plane' | 'legacy-force-kill' | 'control-timeout-force-kill';
export interface StopAgentOptions {
    controlTimeoutMs?: number;
    exitTimeoutMs?: number;
    afterControlAccepted?: () => void | Promise<void>;
    beforeForceKill?: () => void | Promise<void>;
    isAlive?: (pid: number) => boolean;
    forceKill?: (pid: number) => boolean;
    sleep?: (milliseconds: number) => Promise<void>;
    shutdownMetadata?: {
        jobId?: string;
        targetVersion?: string;
    };
}
export declare function stopAgentProcess(state: RuntimeState, reason: ShutdownReason, options?: StopAgentOptions): Promise<StopMode>;