import { type ExecaError, type ResultPromise } from "execa";
export interface RunOptions {
    cwd?: string;
    env?: NodeJS.ProcessEnv;
    reject?: boolean;
    timeout?: number;
    onStderr?: (chunk: string) => void;
    onStdout?: (chunk: string) => void;
}
type TrackedChild = ResultPromise;
export declare function handleCancellation(_signal?: NodeJS.Signals): Promise<never>;
/** Install SIGINT/SIGTERM handlers (call from CLI main only, not from library imports). */
export declare function installSignalHandlers(): void;
export declare function trackChild<T extends TrackedChild>(child: T): T;
export declare function runCommand(file: string, args: readonly string[], options?: RunOptions): Promise<{
    stdout: string;
    stderr: string;
    exitCode: number;
}>;
export declare function runCommandOrThrow(file: string, args: readonly string[], options?: RunOptions, friendlyName?: string): Promise<{
    stdout: string;
    stderr: string;
}>;
export declare function isExecaError(error: unknown): error is ExecaError;
export declare function getActiveChildCount(): number;
export {};