/**
 * This file was auto-generated by Fern from our API Definition.
 */
import * as environments from "../../../../environments.js";
import * as core from "../../../../core/index.js";
import * as Klavis from "../../../index.js";
export declare namespace Sandbox {
    interface Options {
        environment?: core.Supplier<environments.KlavisEnvironment | string>;
        /** Specify a custom URL to connect the client to. */
        baseUrl?: core.Supplier<string>;
        apiKey?: core.Supplier<core.BearerToken | undefined>;
        /** Additional headers to include in requests. */
        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
        fetcher?: core.FetchFunction;
    }
    interface RequestOptions {
        /** The maximum time to wait for a response in seconds. */
        timeoutInSeconds?: number;
        /** The number of times to retry the request. Defaults to 2. */
        maxRetries?: number;
        /** A hook to abort the request. */
        abortSignal?: AbortSignal;
        /** Additional headers to include in the request. */
        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
    }
}
export declare class Sandbox {
    protected readonly _options: Sandbox.Options;
    constructor(_options?: Sandbox.Options);
    /**
     * Acquire an idle sandbox instance for a specific MCP server. The sandbox will be marked as 'occupied'.
     *
     * @param {Klavis.SandboxMcpServer} serverName - The MCP server name
     * @param {Sandbox.RequestOptions} requestOptions - Request-specific configuration.
     *
     * @throws {@link Klavis.UnprocessableEntityError}
     *
     * @example
     *     await client.sandbox.createSandbox("jira")
     */
    createSandbox(serverName: Klavis.SandboxMcpServer, requestOptions?: Sandbox.RequestOptions): core.HttpResponsePromise<Klavis.CreateSandboxResponse>;
    private __createSandbox;
    /**
     * Retrieve detailed information about a specific sandbox instance.
     *
     * @param {Klavis.SandboxMcpServer} serverName - The MCP server name
     * @param {string} sandboxId - The unique sandbox identifier
     * @param {Sandbox.RequestOptions} requestOptions - Request-specific configuration.
     *
     * @throws {@link Klavis.UnprocessableEntityError}
     *
     * @example
     *     await client.sandbox.getSandbox("jira", "sandbox_id")
     */
    getSandbox(serverName: Klavis.SandboxMcpServer, sandboxId: string, requestOptions?: Sandbox.RequestOptions): core.HttpResponsePromise<Klavis.SandboxInfo>;
    private __getSandbox;
    /**
     * Release an occupied sandbox back to idle state and marks the sandbox as available for reuse.
     *
     * @param {Klavis.SandboxMcpServer} serverName - The MCP server name
     * @param {string} sandboxId - The unique sandbox identifier
     * @param {Sandbox.RequestOptions} requestOptions - Request-specific configuration.
     *
     * @throws {@link Klavis.UnprocessableEntityError}
     *
     * @example
     *     await client.sandbox.deleteSandbox("jira", "sandbox_id")
     */
    deleteSandbox(serverName: Klavis.SandboxMcpServer, sandboxId: string, requestOptions?: Sandbox.RequestOptions): core.HttpResponsePromise<Klavis.ReleaseSandboxResponse>;
    private __deleteSandbox;
    /**
     * Reset the sandbox to its initial empty state, clearing all data while maintaining the sandbox instance.
     *
     * @param {Klavis.SandboxMcpServer} serverName - The MCP server name
     * @param {string} sandboxId - The unique sandbox identifier
     * @param {Sandbox.RequestOptions} requestOptions - Request-specific configuration.
     *
     * @throws {@link Klavis.UnprocessableEntityError}
     *
     * @example
     *     await client.sandbox.resetSandbox("jira", "sandbox_id")
     */
    resetSandbox(serverName: Klavis.SandboxMcpServer, sandboxId: string, requestOptions?: Sandbox.RequestOptions): core.HttpResponsePromise<Klavis.ResetSandboxResponse>;
    private __resetSandbox;
    /**
     * Initialize the sandbox with snowflake-specific data following the defined schema.
     *
     * @param {string} sandboxId - The unique sandbox identifier
     * @param {Klavis.SnowflakeData} request
     * @param {Sandbox.RequestOptions} requestOptions - Request-specific configuration.
     *
     * @throws {@link Klavis.UnprocessableEntityError}
     *
     * @example
     *     await client.sandbox.initializeSandbox("sandbox_id")
     */
    initializeSandbox(sandboxId: string, request?: Klavis.SnowflakeData, requestOptions?: Sandbox.RequestOptions): core.HttpResponsePromise<Klavis.InitializeSandboxResponse>;
    private __initializeSandbox;
    /**
     * Export all data from the sandbox in the same format used for initialization.
     *
     * @param {string} sandboxId - The unique sandbox identifier
     * @param {Sandbox.RequestOptions} requestOptions - Request-specific configuration.
     *
     * @throws {@link Klavis.UnprocessableEntityError}
     *
     * @example
     *     await client.sandbox.dumpSandbox("sandbox_id")
     */
    dumpSandbox(sandboxId: string, requestOptions?: Sandbox.RequestOptions): core.HttpResponsePromise<Klavis.DumpSandboxResponseSnowflakeData>;
    private __dumpSandbox;
    protected _getAuthorizationHeader(): Promise<string | undefined>;
}