import type { SandboxCapabilities, SandboxEnv, SandboxExecOptions, SandboxFactoryOptions, SandboxSnapshot, FileStat } from './sandbox.js';
import type { ShellResult } from './types.js';
/**
 * Virtual sandbox backend powered by [just-bash](https://github.com/vercel-labs/just-bash).
 *
 * Provides an in-memory filesystem and a bash subset (`grep`, `glob`,
 * `cat`, `read`, `mkdir`, `rm`, `ls`, `echo`, etc.) without shelling out
 * to the host. The backend is fast, cheap, safe, and high-concurrency.
 *
 * Selected automatically by the bare `@fabric-harness/sdk` import when the
 * caller doesn't pass `sandbox`. Override with `'local'`, `'docker'`, a
 * `SandboxFactory`, or a `SandboxEnv` when you need real shell access.
 */
export declare class VirtualSandboxEnv implements SandboxEnv {
    readonly cwd: string;
    readonly capabilities: SandboxCapabilities;
    private readonly fs;
    private readonly bash;
    constructor(options?: {
        cwd?: string;
        initialFiles?: Record<string, string | Uint8Array>;
    });
    resolvePath(filePath: string): string;
    exec(command: string, options?: SandboxExecOptions): Promise<ShellResult>;
    readFile(filePath: string): Promise<string>;
    readFileBuffer(filePath: string): Promise<Uint8Array>;
    writeFile(filePath: string, content: string | Uint8Array): Promise<void>;
    stat(filePath: string): Promise<FileStat>;
    readdir(dirPath: string): Promise<string[]>;
    exists(filePath: string): Promise<boolean>;
    mkdir(dirPath: string, options?: {
        recursive?: boolean;
    }): Promise<void>;
    rm(filePath: string, options?: {
        recursive?: boolean;
        force?: boolean;
    }): Promise<void>;
    snapshot(): Promise<SandboxSnapshot>;
    restore(_snapshot: SandboxSnapshot): Promise<void>;
    cleanup(): Promise<void>;
}
export declare function createVirtualSandboxEnv(options?: SandboxFactoryOptions & {
    initialFiles?: Record<string, string | Uint8Array>;
}): VirtualSandboxEnv;
//# sourceMappingURL=virtual-sandbox.d.ts.map