import { APIResource } from "../../../core/resource.js";
import * as SandboxesAPI from "./sandboxes.js";
import { APIPromise } from "../../../core/api-promise.js";
import { RequestOptions } from "../../../internal/request-options.js";
/**
 * Run heavy work in Village-managed compute sandboxes.
 */
export declare class Files extends APIResource {
    /**
     * List sandbox files
     */
    list(sandboxID: string, query: FileListParams, options?: RequestOptions): APIPromise<FileListResponse>;
    /**
     * Create a sandbox directory
     */
    mkdir(sandboxID: string, body: FileMkdirParams, options?: RequestOptions): APIPromise<void>;
    /**
     * Read a sandbox file
     */
    read(sandboxID: string, body: FileReadParams, options?: RequestOptions): APIPromise<FileReadResponse>;
    /**
     * Remove a sandbox file or directory
     */
    remove(sandboxID: string, body: FileRemoveParams, options?: RequestOptions): APIPromise<void>;
    /**
     * Write a sandbox file
     */
    write(sandboxID: string, body: FileWriteParams, options?: RequestOptions): APIPromise<void>;
}
export type FileListResponse = Array<SandboxesAPI.SandboxFileEntry>;
export interface FileReadResponse {
    /**
     * Base64-encoded binary content.
     */
    data_base64?: string | null;
    /**
     * UTF-8 text content.
     */
    text?: string | null;
}
export interface FileListParams {
    /**
     * Directory path inside the sandbox.
     */
    path: string;
}
export interface FileMkdirParams {
    /**
     * Absolute path inside the sandbox.
     */
    path: string;
    /**
     * Create missing parent directories.
     */
    parents?: boolean;
}
export interface FileReadParams {
    /**
     * Absolute path inside the sandbox.
     */
    path: string;
    /**
     * Return text or base64-encoded bytes.
     */
    encoding?: 'utf-8' | 'base64';
}
export interface FileRemoveParams {
    /**
     * Absolute path inside the sandbox.
     */
    path: string;
    /**
     * Remove directories recursively.
     */
    recursive?: boolean;
}
export interface FileWriteParams {
    /**
     * Absolute path inside the sandbox.
     */
    path: string;
    /**
     * Base64-encoded bytes to write.
     */
    data_base64?: string | null;
    /**
     * UTF-8 text to write.
     */
    text?: string | null;
}
export declare namespace Files {
    export { type FileListResponse as FileListResponse, type FileReadResponse as FileReadResponse, type FileListParams as FileListParams, type FileMkdirParams as FileMkdirParams, type FileReadParams as FileReadParams, type FileRemoveParams as FileRemoveParams, type FileWriteParams as FileWriteParams, };
}
//# sourceMappingURL=files.d.ts.map