import { type IControllerStatus, type IReq_ControllerUpgradeLaunch, type IReq_ControllerUpgradePrepareBegin, type IReq_ControllerUpgradeFinalize } from '../dist_ts_interfaces/index.js';
export interface IControllerStatusExpectation {
    packageName: string;
    packageVersion: string;
    protocolVersion?: number;
    upgradeManagementVersion: number;
}
export declare const controllerUpgradePrepareBeginRequestTimeoutMs = 30000;
export declare const assertControllerStatus: (statusArg: unknown, expectationArg: IControllerStatusExpectation) => IControllerStatus;
export declare const requestControllerUpgradePrepareBegin: (portArg: number, tokenArg: string, targetVersionArg: string, gracePeriodMsArg: number) => Promise<IReq_ControllerUpgradePrepareBegin["response"]>;
export declare const requestControllerUpgradeFinalize: (portArg: number, tokenArg: string, modeArg: IReq_ControllerUpgradeFinalize["request"]["mode"], timeoutMsArg?: number) => Promise<IReq_ControllerUpgradeFinalize["response"]>;
export declare const queryControllerStatus: (portArg: number, expectationArg: IControllerStatusExpectation, timeoutMsArg?: number) => Promise<IControllerStatus>;
export declare const tryQueryControllerStatus: (portArg: number, expectationArg: IControllerStatusExpectation) => Promise<IControllerStatus | undefined>;
export declare const isLoopbackPortListening: (portArg: number, timeoutMsArg?: number) => Promise<boolean>;
export declare const requestControllerUpgradeLaunch: (portArg: number, tokenArg: string, timeoutMsArg?: number) => Promise<IReq_ControllerUpgradeLaunch["response"]>;
export declare const waitUntilControllerExited: (optionsArg: {
    pid: number;
    cliPath: string;
    port: number;
    expectedProcessGroupId: number;
    expectedFingerprint: string;
    command: "__serve" | "foreground";
}, timeoutMsArg: number) => Promise<boolean>;
export declare const resolveControllerStopSignal: (statusArg: IControllerStatus, phaseArg: "cooperative" | "hard") => {
    signal: NodeJS.Signals;
    signalProcessGroup: boolean;
};
export declare const stopVerifiedController: (optionsArg: {
    status: IControllerStatus;
    cliPath: string;
    port: number;
}) => Promise<void>;