/**
 * Sandbox client SDK for ephemeral compute environments.
 *
 * Implements the bash-tool Sandbox interface for seamless integration
 * with AI agent tool loops.
 *
 * @module
 */
import { LazySandbox, type LazySandboxOptions } from "./lazy-sandbox.js";
import type { BackgroundCommand, BackgroundCommandOutput, ExecOptions, ExecResult, ExecStreamEvent, SandboxAttachment, SandboxListOptions, SandboxListResult, SandboxOptions } from "./types.js";
export { resolveSandboxApiUrl, resolveSandboxAuthToken } from "./config.js";
export type { BackgroundCommand, BackgroundCommandHeartbeatStatus, BackgroundCommandOutput, BackgroundCommandStatus, ExecOptions, ExecResult, ExecStreamEvent, SandboxAttachment, SandboxListOptions, SandboxListResult, SandboxOptions, SandboxSession, } from "./types.js";
/** Client for isolated ephemeral compute environments with command execution and file I/O. */
export declare class Sandbox {
    private endpoint;
    private sessionId;
    private authToken;
    private apiUrl;
    private constructor();
    private static resolveApiUrl;
    private static resolveAuthToken;
    /** Create a new sandbox session. Claims a warm pod or creates a new one. */
    static create(options?: SandboxOptions): Promise<Sandbox>;
    /** Reconnect to an existing sandbox session. */
    static get(id: string, options?: SandboxOptions): Promise<Sandbox>;
    /** Attach to an already-known sandbox session and endpoint without a reconnect lookup. */
    static attach(attachment: SandboxAttachment): Sandbox;
    /** List sandbox sessions with optional pagination. */
    static list(options?: SandboxListOptions): Promise<SandboxListResult>;
    private static waitForReady;
    /** Create a lazily-provisioned sandbox session with automatic heartbeats. */
    static createLazy(options?: LazySandboxOptions): LazySandbox;
    /** Execute a bash command in the sandbox and return buffered result. */
    executeCommand(command: string, options?: ExecOptions): Promise<ExecResult>;
    /** Execute a bash command with streaming output (NDJSON). */
    executeStream(command: string, options?: ExecOptions): AsyncGenerator<ExecStreamEvent>;
    /** Read a file from the sandbox workspace. */
    readFile(path: string): Promise<string>;
    /** Write files to the sandbox workspace. */
    writeFiles(files: Array<{
        path: string;
        content: string;
    }>): Promise<void>;
    /** Start an async background command in the sandbox. */
    startBackgroundCommand(command: string, options?: ExecOptions): Promise<BackgroundCommand>;
    /** Get the status of an async background command. */
    getBackgroundCommand(commandId: string): Promise<BackgroundCommand>;
    /** Get the output of an async background command. */
    getBackgroundCommandOutput(commandId: string): Promise<BackgroundCommandOutput>;
    /** List all background commands in the sandbox. */
    listBackgroundCommands(): Promise<BackgroundCommand[]>;
    /** Cancel an async background command. */
    cancelBackgroundCommand(commandId: string): Promise<BackgroundCommand>;
    private static mapBackgroundCommand;
    /** Send a heartbeat to prevent idle timeout. */
    heartbeat(): Promise<void>;
    /** Close the sandbox session and mark for deletion. */
    close(): Promise<void>;
    /** Get the session ID. */
    get id(): string;
    /** Get the sandbox endpoint URL. */
    get url(): string;
}
export declare function waitForSandboxReady(input: {
    apiUrl: string;
    id: string;
    authToken: string;
    maxWaitMs?: number;
    pollIntervalMs?: number;
}): Promise<void>;
//# sourceMappingURL=sandbox.d.ts.map