/**
 * Container Manager - Docker container lifecycle management
 *
 * Handles creating, monitoring, and destroying Docker containers for explorations.
 * Uses SafeExecutor.execute (spawn with an argument array, no shell) throughout —
 * container names, images, and especially exploration environment variables
 * (which carry the user-supplied `<task>` text) are never interpolated into a
 * shell command string, so shell metacharacters in any of them cannot inject
 * additional commands.
 */
import type { ContainerStats } from '../types/exploration.types.js';
export interface ContainerConfig {
    command?: string[];
    container_name: string;
    cpu_limit: string;
    environment: Record<string, string>;
    image: string;
    memory_limit: string;
    port?: number;
    shared_volume_path: string;
    worktree_path: string;
}
export interface ContainerInfo {
    container_id: string;
    container_name: string;
    exit_code?: number;
    finished_at?: string;
    started_at?: string;
    status: 'created' | 'dead' | 'exited' | 'paused' | 'running';
}
export declare class ContainerManager {
    private containers;
    constructor();
    /**
     * Create and start a container
     */
    createContainer(config: ContainerConfig): Promise<string>;
    /** Build the `docker run` argument array for createContainer(). Split out to keep that method's complexity down. */
    private buildCreateContainerArgs;
    /**
     * Create multiple containers in parallel
     */
    createMultipleContainers(configs: ContainerConfig[]): Promise<string[]>;
    /**
     * Stop a container
     */
    stopContainer(containerName: string, timeout?: number): Promise<void>;
    /**
     * Stop multiple containers in parallel
     */
    stopMultipleContainers(containerNames: string[], timeout?: number): Promise<void>;
    /**
     * Remove a container
     */
    removeContainer(containerName: string, force?: boolean): Promise<void>;
    /**
     * Remove multiple containers in parallel
     */
    removeMultipleContainers(containerNames: string[], force?: boolean): Promise<void>;
    /**
     * Get container status
     */
    getContainerStatus(containerName: string): Promise<ContainerInfo>;
    /**
     * Get container statistics
     */
    getContainerStats(containerName: string, worktreeIndex: number): Promise<ContainerStats>;
    /**
     * Get statistics for multiple containers
     */
    getMultipleContainerStats(containerNames: string[], worktreeIndices: number[]): Promise<ContainerStats[]>;
    /**
     * Get container logs
     */
    getContainerLogs(containerName: string, tail?: number): Promise<string>;
    /**
     * Execute a command in a running container
     */
    execInContainer(containerName: string, command: string[]): Promise<{
        stderr: string;
        stdout: string;
    }>;
    /**
     * Check if a container exists
     */
    containerExists(containerName: string): Promise<boolean>;
    /**
     * Wait for container to exit
     */
    waitForContainer(containerName: string, timeout?: number): Promise<number>;
    /**
     * Pull Docker image if not present
     */
    pullImageIfNeeded(image: string): Promise<boolean>;
    /**
     * Pause a container
     */
    pauseContainer(containerName: string): Promise<void>;
    /**
     * Unpause a container
     */
    unpauseContainer(containerName: string): Promise<void>;
    /**
     * Kill a container (force stop)
     */
    killContainer(containerName: string, signal?: string): Promise<void>;
    /**
     * Get all tracked containers
     */
    getTrackedContainers(): ContainerInfo[];
    /**
     * Clear tracking for a container
     */
    untrackContainer(containerName: string): void;
    /**
     * Clear all tracking
     */
    clearTracking(): void;
    /**
     * Parse memory string (e.g., "256MiB", "2GiB") to MB
     */
    private parseMemoryString;
    /**
     * Calculate uptime in seconds
     */
    private calculateUptime;
}
//# sourceMappingURL=container-manager.d.ts.map