import type { SandboxProbeOptions, SandboxProvider, SandboxProviderStatus } from "./types.js";
export declare const SANDBOX_EXECUTION_NOTICE = "Happy runs agent code inside the selected sandbox provider, isolated from the Happy server process.";
export interface SandboxProviderDiscovery {
    executionNotice: string;
    providers: SandboxProviderStatus[];
    recommendedProviderId?: string;
}
/** Immutable provider lookup and discovery boundary; durable selection remains owned by setup actions. */
export declare class SandboxProviderCatalog {
    private readonly byId;
    constructor(providers: readonly SandboxProvider[]);
    get(id: string): SandboxProvider | undefined;
    discover(options?: SandboxProbeOptions): Promise<SandboxProviderDiscovery>;
}
//# sourceMappingURL=catalog.d.ts.map