/**
 * Docker Container Resolution
 *
 * Resolves various identifiers to Docker container IDs.
 * Accepts: execution ID (WORK-XXX), agent name, or container ID.
 */
import { ExecutionStorage } from '../execution/storage.js';
/**
 * Validate and sanitize a container ID to prevent shell injection.
 * Docker container IDs are 64-character hex strings (or 12-char short form).
 * Container names can contain alphanumeric, underscore, hyphen, and period.
 *
 * @throws Error if the ID contains invalid characters
 */
export declare function sanitizeContainerId(id: string): string;
export interface ResolveResult {
    containerId: string | null;
    executionId?: string;
    agentName?: string;
    displayName: string;
    error?: string;
}
/**
 * Resolve a target identifier to a Docker container ID.
 *
 * @param target - Execution ID (WORK-XXX), agent name, or container ID
 * @param executionStorage - ExecutionStorage instance
 * @returns ResolveResult with containerId or error
 */
export declare function resolveContainerId(target: string, executionStorage: ExecutionStorage): ResolveResult;
/**
 * Check if a container is currently running.
 */
export declare function isContainerRunning(containerId: string): boolean;
/**
 * Check if a container exists (running or stopped).
 */
export declare function containerExists(containerId: string): boolean;
