import { APIResource } from "../../core/resource.mjs";
import { APIPromise } from "../../core/api-promise.mjs";
import { CursorIDPage, type CursorIDPageParams, PagePromise } from "../../core/pagination.mjs";
import { type Uploadable } from "../../core/uploads.mjs";
import { RequestOptions } from "../../internal/request-options.mjs";
export declare class Files extends APIResource {
    /**
     * Paginated list of files in a dataset
     */
    list(id: string, query?: FileListParams | null | undefined, options?: RequestOptions): PagePromise<FileListResponsesCursorIDPage, FileListResponse>;
    /**
     * Remove a file from a dataset
     */
    delete(fileID: string, params: FileDeleteParams, options?: RequestOptions): APIPromise<void>;
    /**
     * Upload a new file to a dataset
     */
    upload(id: string, body: FileUploadParams, options?: RequestOptions): APIPromise<void>;
}
export type FileListResponsesCursorIDPage = CursorIDPage<FileListResponse>;
/**
 * File stored in a dataset
 */
export interface FileListResponse {
    /**
     * Unique identifier for the file
     */
    id: string;
    /**
     * Timestamp when the file was created
     */
    created_at: string;
    /**
     * Original filename
     */
    filename: string;
    /**
     * Size of the file in bytes
     */
    size: number;
}
export interface FileListParams extends CursorIDPageParams {
    /**
     * The number of files to return per page, ranging between 1 and 100.
     */
    limit?: number | null;
}
export interface FileDeleteParams {
    /**
     * ID of the dataset containing the file
     */
    id: string;
}
export interface FileUploadParams {
    file?: Uploadable;
    /**
     * Purpose of the file (e.g., fine_tune)
     */
    purpose?: string;
}
export declare namespace Files {
    export { type FileListResponse as FileListResponse, type FileListResponsesCursorIDPage as FileListResponsesCursorIDPage, type FileListParams as FileListParams, type FileDeleteParams as FileDeleteParams, type FileUploadParams as FileUploadParams, };
}
//# sourceMappingURL=files.d.mts.map