/** Cross-platform sandbox engine: Docker, Apple Container, auto-detect. */
export type SandboxEngineType = "docker" | "apple-container" | "auto";
export interface ContainerRunOptions {
    image: string;
    name: string;
    detach: boolean;
    mounts: Array<{
        host: string;
        container: string;
        readonly: boolean;
    }>;
    env: Record<string, string>;
    network: string;
    user: string;
    capDrop: string[];
    memory?: string;
    cpus?: number;
    pidsLimit?: number;
    readOnlyRoot?: boolean;
    ports?: Array<{
        host: number;
        container: number;
    }>;
    dns?: string[];
}
export interface ContainerExecOptions {
    containerId: string;
    command: string;
    workdir?: string;
    env?: Record<string, string>;
    timeoutMs?: number;
    stdin?: string;
}
export interface ContainerExecResult {
    exitCode: number;
    stdout: string;
    stderr: string;
    durationMs: number;
}
export interface EngineInfo {
    type: SandboxEngineType;
    available: boolean;
    version: string;
    platform: string;
    arch: string;
    details: string;
}
export interface ISandboxEngine {
    readonly engineType: SandboxEngineType;
    isAvailable(): boolean;
    getInfo(): EngineInfo;
    runContainer(opts: ContainerRunOptions): Promise<string>;
    execInContainer(opts: ContainerExecOptions): Promise<ContainerExecResult>;
    stopContainer(id: string): Promise<void>;
    removeContainer(id: string): Promise<void>;
    isContainerRunning(id: string): boolean;
    imageExists(image: string): boolean;
    pullImage(image: string): Promise<void>;
    listContainers(prefix: string): string[];
    healthCheck(id: string): Promise<boolean>;
}
export declare class DockerEngine implements ISandboxEngine {
    readonly engineType: SandboxEngineType;
    isAvailable(): boolean;
    getInfo(): EngineInfo;
    runContainer(opts: ContainerRunOptions): Promise<string>;
    execInContainer(opts: ContainerExecOptions): Promise<ContainerExecResult>;
    stopContainer(id: string): Promise<void>;
    removeContainer(id: string): Promise<void>;
    isContainerRunning(id: string): boolean;
    imageExists(image: string): boolean;
    pullImage(image: string): Promise<void>;
    listContainers(prefix: string): string[];
    healthCheck(id: string): Promise<boolean>;
    private getDockerContext;
}
export declare class AppleContainerEngine implements ISandboxEngine {
    readonly engineType: SandboxEngineType;
    isAvailable(): boolean;
    getInfo(): EngineInfo;
    runContainer(opts: ContainerRunOptions): Promise<string>;
    execInContainer(opts: ContainerExecOptions): Promise<ContainerExecResult>;
    stopContainer(id: string): Promise<void>;
    removeContainer(id: string): Promise<void>;
    isContainerRunning(id: string): boolean;
    imageExists(image: string): boolean;
    pullImage(image: string): Promise<void>;
    listContainers(prefix: string): string[];
    healthCheck(id: string): Promise<boolean>;
}
/** Auto-detect: prefer Apple Container on ARM Mac, else Docker. */
export declare function detectBestEngine(): ISandboxEngine;
export declare function createEngine(type: SandboxEngineType): ISandboxEngine;
export declare function getAllEngineInfo(): EngineInfo[];
export declare function getPlatformSetupNotes(): string;
//# sourceMappingURL=sandbox-engine.d.ts.map