import type { BackgroundCommand, BackgroundCommandOutput, ExecOptions } from "./sandbox.js";
import { type LazySandboxOptions } from "./lazy-sandbox.js";
import { type BashToolSandboxLike, type CreateSandboxBashTool, type SandboxShellToolSet } from "./shell-tools.js";
/** Public API contract for agent service sandbox background command client. */
export interface AgentServiceSandboxBackgroundCommandClient {
    startBackgroundCommand(command: string): Promise<BackgroundCommand>;
    getBackgroundCommand(commandId: string): Promise<BackgroundCommand>;
    getBackgroundCommandOutput(commandId: string): Promise<BackgroundCommandOutput>;
    cancelBackgroundCommand(commandId: string): Promise<BackgroundCommand>;
}
/** Public API contract for agent service sandbox client. */
export interface AgentServiceSandboxClient extends BashToolSandboxLike, AgentServiceSandboxBackgroundCommandClient {
    ensure(): Promise<void>;
    close(): Promise<void>;
    readonly isActive: boolean;
    readonly id: string | null;
    readonly url: string | null;
}
/** Options accepted by agent service sandbox client. */
export interface AgentServiceSandboxClientOptions extends LazySandboxOptions {
}
/** Options accepted by agent service sandbox tools. */
export interface AgentServiceSandboxToolsOptions extends AgentServiceSandboxClientOptions {
    /** Sandbox shell tools provider. Kept as createBashTool for caller compatibility. */
    createBashTool: CreateSandboxBashTool;
}
/** Result returned from agent service sandbox tools. */
export interface AgentServiceSandboxToolsResult {
    tools: SandboxShellToolSet;
    sandbox: AgentServiceSandboxClient;
    closeSandbox: () => Promise<void>;
}
/** Unwrap sandbox working directory command. */
export declare function unwrapSandboxWorkingDirectoryCommand(command: string): string;
/** Options accepted by create project-scoped exec. */
export declare function createProjectScopedExecOptions(projectReference: string | null | undefined): ExecOptions;
/** Create agent service sandbox client. */
export declare function createAgentServiceSandboxClient(input?: AgentServiceSandboxClientOptions): AgentServiceSandboxClient;
/** Create agent service sandbox tools. */
export declare function createAgentServiceSandboxTools(input: AgentServiceSandboxToolsOptions): Promise<AgentServiceSandboxToolsResult>;
/** Public API contract for hosted sandbox background command client. */
export type HostedSandboxBackgroundCommandClient = AgentServiceSandboxBackgroundCommandClient;
/** Public API contract for hosted sandbox client. */
export type HostedSandboxClient = AgentServiceSandboxClient;
/** Options accepted by hosted sandbox client. */
export type HostedSandboxClientOptions = AgentServiceSandboxClientOptions;
/** Options accepted by hosted sandbox tools. */
export type HostedSandboxToolsOptions = AgentServiceSandboxToolsOptions;
/** Result returned from hosted sandbox tools. */
export type HostedSandboxToolsResult = AgentServiceSandboxToolsResult;
/** Create hosted sandbox client. */
export declare const createHostedSandboxClient: typeof createAgentServiceSandboxClient;
/** Create hosted sandbox tools. */
export declare const createHostedSandboxTools: typeof createAgentServiceSandboxTools;
//# sourceMappingURL=agent-service-tools.d.ts.map