import type { EnvironmentBackend } from "#environments/backend";
import type { CommandExecutor, CommandResult } from "#environments/executor";
import type { Environment } from "#environments/model";
import { type HostProcessRunner } from "#testing/host";
import type { Magerun2Capability, Magerun2Result } from "#features/magerun2/model";
/** Resolve magerun once for the selected Magento environment without altering the project. */
export declare function discoverMagerun2(environment: Environment, backend: CommandExecutor, cwd: string, record?: (argv: string[], result: CommandResult) => Promise<void>): Promise<Magerun2Capability>;
/** Run a structured argument vector. Local commands are host processes; Warden and SSH use their selected backend. */
export declare function runMagerun2(capability: Magerun2Capability, environment: Environment, backend: EnvironmentBackend, cwd: string, args: string[], stdin?: string, signal?: AbortSignal, host?: HostProcessRunner): Promise<Magerun2Result>;
/** Stable display only: this is never passed to a shell. */
export declare function quotedMagerunPreview(executable: string, args: string[]): string;
/** Install the official PHAR outside the Magento project; verify its release SHA-256 before publishing it. */
export declare function installMagerun2(home: string, _cwd: string, request?: typeof fetch): Promise<string>;