import type { FileUploadResult, FileListResult, FileContent } from './types.js';
/**
 * Provider file management — upload, list, delete, and retrieve files
 * on provider platforms (OpenAI, Anthropic, Google).
 *
 * @example
 * const files = AI.files('openai')
 * const uploaded = await files.upload('./report.pdf', { purpose: 'assistants' })
 * const list = await files.list()
 * await files.delete(uploaded.id)
 */
export declare class FileManager {
    private readonly providerName;
    private constructor();
    static for(providerName: string): FileManager;
    /** Upload a file to the provider */
    upload(filePath: string, options?: {
        purpose?: string | undefined;
    }): Promise<FileUploadResult>;
    /** List all files on the provider */
    list(): Promise<FileListResult>;
    /** Delete a file by ID */
    delete(fileId: string): Promise<void>;
    /** Retrieve file content by ID (not all providers support this) */
    retrieve(fileId: string): Promise<FileContent>;
}
//# sourceMappingURL=files.d.ts.map