/**
 * @param {import('#types').TransportConfig} host
 * @returns {string}
 */
export function sshDestination(host: import("#types").TransportConfig): string;
/**
 * @param {import('#types').TransportConfig} host
 * @param {string} command
 * @param {string} [identityAgent]
 * @returns {string[]}
 */
export function sshArgs(host: import("#types").TransportConfig, command: string, identityAgent?: string): string[];
/**
 * Builds the Rampway-owned verification profile shared by direct deployment
 * SSH and Git's SSH child process.
 *
 * @param {import('#types').TransportConfig} host
 * @returns {string[]}
 */
export function sshHostVerificationArgs(host: import("#types").TransportConfig): string[];
/**
 * @param {import('#types').TransportConfig} host
 * @param {string} [identityAgent]
 * @returns {string}
 */
export function gitSshCommand(host: import("#types").TransportConfig, identityAgent?: string): string;
/**
 * @param {unknown} value
 * @returns {string}
 */
export function shellQuote(value: unknown): string;
/**
 * @param {unknown} key
 * @returns {string}
 */
export function shellEnvKey(key: unknown): string;
/**
 * @param {unknown} key
 * @returns {string}
 */
export function shellEnvName(key: unknown): string;
/**
 * @param {unknown} value
 * @returns {string}
 */
export function remotePath(value: unknown): string;
export class SshTransport {
    /**
     * @param {import('#types').StageConfig} stage
     * @param {import('../core/reporter.js').Reporter} [reporter]
     * @returns {SshTransport}
     */
    static fromStage(stage: import("#types").StageConfig, reporter?: import("../core/reporter.js").Reporter): SshTransport;
    /**
     * @param {{host: import('#types').TransportConfig, reporter?: import('../core/reporter.js').Reporter, env?: Record<string, string|undefined>, spawnProcess?: typeof spawnOwnedProcess}} opts
     */
    constructor({ host, reporter, env, spawnProcess }: {
        host: import("#types").TransportConfig;
        reporter?: import("../core/reporter.js").Reporter;
        env?: Record<string, string | undefined>;
        spawnProcess?: typeof spawnOwnedProcess;
    });
    /** @type {import('#types').TransportConfig} */
    host: import("#types").TransportConfig;
    /** @type {import('../core/reporter.js').Reporter} */
    reporter: import("../core/reporter.js").Reporter;
    env: Record<string, string | undefined> | undefined;
    spawnProcess: typeof import("node:child_process").spawn;
    /**
     * @param {string} targetPath
     * @returns {Promise<void>}
     */
    mkdirp(targetPath: string): Promise<void>;
    /**
     * @param {string} targetPath
     * @returns {Promise<boolean>}
     */
    exists(targetPath: string): Promise<boolean>;
    /**
     * @param {string} target
     * @param {string} linkPath
     * @returns {Promise<void>}
     */
    symlink(target: string, linkPath: string): Promise<void>;
    /**
     * @param {string} linkPath
     * @returns {Promise<string>}
     */
    readlink(linkPath: string): Promise<string>;
    /**
     * @param {string} targetPath
     * @returns {Promise<string>}
     */
    realpath(targetPath: string): Promise<string>;
    /**
     * @param {string} targetPath
     * @returns {Promise<boolean>}
     */
    isDirectory(targetPath: string): Promise<boolean>;
    /**
     * Returns non-following filesystem metadata for integrity-sensitive walks.
     *
     * @param {string} targetPath
     * @returns {Promise<{isDirectory: () => boolean, isFile: () => boolean, isSymbolicLink: () => boolean}|undefined>}
     */
    stat(targetPath: string): Promise<{
        isDirectory: () => boolean;
        isFile: () => boolean;
        isSymbolicLink: () => boolean;
    } | undefined>;
    /**
     * @param {string} targetPath
     * @returns {Promise<void>}
     */
    rm(targetPath: string): Promise<void>;
    /**
     * @param {string} from
     * @param {string} to
     * @returns {Promise<void>}
     */
    rename(from: string, to: string): Promise<void>;
    /**
     * @param {string} filePath
     * @param {string} content
     * @returns {Promise<void>}
     */
    writeFile(filePath: string, content: string): Promise<void>;
    /**
     * @param {string} filePath
     * @param {string} content
     * @returns {Promise<boolean>}
     */
    writeFileExclusive(filePath: string, content: string): Promise<boolean>;
    /**
     * @param {string} filePath
     * @param {string} expectedContent
     * @returns {Promise<boolean>}
     */
    removeFileIfContent(filePath: string, expectedContent: string): Promise<boolean>;
    /**
     * @param {string} filePath
     * @returns {Promise<string>}
     */
    readFile(filePath: string): Promise<string>;
    /**
     * @param {string} filePath
     * @returns {Promise<Buffer>}
     */
    readFileBuffer(filePath: string): Promise<Buffer>;
    /**
     * @param {string} targetPath
     * @returns {Promise<string[]>}
     */
    list(targetPath: string): Promise<string[]>;
    /**
     * Lists exact entry names for integrity-sensitive directory walks.
     *
     * @param {string} targetPath
     * @returns {Promise<string[]>}
     */
    listDirectory(targetPath: string): Promise<string[]>;
    /**
     * @param {string} from
     * @param {string} to
     * @param {{exclude?: string[]}} [opts]
     * @returns {Promise<void>}
     */
    copyDir(from: string, to: string, opts?: {
        exclude?: string[];
    }): Promise<void>;
    /**
     * @param {string} command
     * @param {{cwd?: string, env?: Record<string, string>, secretEnv?: Record<string, string>}} [opts]
     * @returns {Promise<import('#types').SpawnResult>}
     */
    run(command: string, { cwd, env, secretEnv }?: {
        cwd?: string;
        env?: Record<string, string>;
        secretEnv?: Record<string, string>;
    }): Promise<import("#types").SpawnResult>;
    /**
     * @param {string} targetPath
     * @returns {import('#types').CommandPlan}
     */
    commandPlanForMkdirp(targetPath: string): import("#types").CommandPlan;
    /**
     * @param {string} targetPath
     * @returns {import('#types').CommandPlan}
     */
    commandPlanForExists(targetPath: string): import("#types").CommandPlan;
    /**
     * @param {string} target
     * @param {string} linkPath
     * @returns {import('#types').CommandPlan}
     */
    commandPlanForSymlink(target: string, linkPath: string): import("#types").CommandPlan;
    /**
     * @param {string} linkPath
     * @returns {import('#types').CommandPlan}
     */
    commandPlanForReadlink(linkPath: string): import("#types").CommandPlan;
    /**
     * @param {string} targetPath
     * @returns {import('#types').CommandPlan}
     */
    commandPlanForRealpath(targetPath: string): import("#types").CommandPlan;
    /**
     * @param {string} targetPath
     * @returns {import('#types').CommandPlan}
     */
    commandPlanForIsDirectory(targetPath: string): import("#types").CommandPlan;
    /**
     * @param {string} targetPath
     * @returns {import('#types').CommandPlan}
     */
    commandPlanForStat(targetPath: string): import("#types").CommandPlan;
    /**
     * @param {string} targetPath
     * @returns {import('#types').CommandPlan}
     */
    commandPlanForRm(targetPath: string): import("#types").CommandPlan;
    /**
     * @param {string} from
     * @param {string} to
     * @returns {import('#types').CommandPlan}
     */
    commandPlanForRename(from: string, to: string): import("#types").CommandPlan;
    /**
     * @param {string} filePath
     * @returns {import('#types').CommandPlan}
     */
    commandPlanForWriteFile(filePath: string): import("#types").CommandPlan;
    /**
     * @param {string} filePath
     * @returns {import('#types').CommandPlan}
     */
    commandPlanForWriteFileExclusive(filePath: string): import("#types").CommandPlan;
    /**
     * @param {string} filePath
     * @returns {import('#types').CommandPlan}
     */
    commandPlanForRemoveFileIfContent(filePath: string): import("#types").CommandPlan;
    /**
     * @param {string} filePath
     * @returns {import('#types').CommandPlan}
     */
    commandPlanForReadFile(filePath: string): import("#types").CommandPlan;
    /**
     * @param {string} filePath
     * @returns {import('#types').CommandPlan}
     */
    commandPlanForReadFileBuffer(filePath: string): import("#types").CommandPlan;
    /**
     * @param {string} targetPath
     * @returns {import('#types').CommandPlan}
     */
    commandPlanForList(targetPath: string): import("#types").CommandPlan;
    /**
     * @param {string} targetPath
     * @returns {import('#types').CommandPlan}
     */
    commandPlanForListDirectory(targetPath: string): import("#types").CommandPlan;
    /**
     * @param {string} from
     * @param {string} to
     * @param {{exclude?: string[]}} [opts]
     * @returns {import('#types').CommandPlan}
     */
    commandPlanForCopyDir(from: string, to: string, { exclude }?: {
        exclude?: string[];
    }): import("#types").CommandPlan;
    /**
     * @param {string} command
     * @param {{cwd?: string, env?: Record<string, string>}} [opts]
     * @returns {import('#types').CommandPlan}
     */
    commandPlanForRun(command: string, { cwd, env }?: {
        cwd?: string;
        env?: Record<string, string>;
    }): import("#types").CommandPlan;
    /**
     * @param {string} command
     * @param {{cwd?: string, env?: Record<string, string>, secretEnv: Record<string, string>}} opts
     * @returns {string}
     */
    scriptForSecretRun(command: string, { cwd, env, secretEnv }: {
        cwd?: string;
        env?: Record<string, string>;
        secretEnv: Record<string, string>;
    }): string;
    /**
     * @param {string} command
     * @returns {import('#types').CommandPlan}
     */
    remoteCommandPlan(command: string): import("#types").CommandPlan;
    /**
     * @param {import('#types').CommandPlan} plan
     * @param {{input?: string, stream?: boolean, knownSecrets?: string[]}} [opts]
     * @returns {Promise<import('#types').SpawnResult>}
     */
    runCommandPlan(plan: import("#types").CommandPlan, { input, stream, knownSecrets }?: {
        input?: string;
        stream?: boolean;
        knownSecrets?: string[];
    }): Promise<import("#types").SpawnResult>;
    /**
     * @param {import('#types').CommandPlan} plan
     * @param {{stream?: boolean}} [opts]
     * @returns {Promise<import('#types').SpawnResult>}
     */
    runPipedCommandPlan(plan: import("#types").CommandPlan, { stream }?: {
        stream?: boolean;
    }): Promise<import("#types").SpawnResult>;
}
import { spawnOwnedProcess } from "../core/owned-process-tree.js";
//# sourceMappingURL=ssh-transport.d.ts.map