import type { Context } from "../context.js";
import { Resource } from "../resource.js";
import type { FileCollection } from "./file-collection.js";
import type { FileRef } from "./file-ref.js";
declare module "../alchemy" {
    interface Alchemy {
        /**
         * Creates a reference to a file in the filesystem.
         * Used in template string interpolation to include file contents,
         * commonly for documentation generation.
         *
         * @param path Path to the file
         * @returns Promise resolving to a FileRef
         *
         * @example
         * // Include a file in documentation generation
         * await Document("api-docs", {
         *   prompt: await alchemy`
         *     Generate docs using the contents of:
         *     ${alchemy.file("./README.md")}
         *   `
         * });
         */
        file(path: string): Promise<FileRef>;
        /**
         * Creates a collection of files with their contents.
         * Used in template string interpolation to include multiple file contents,
         * commonly for bulk documentation generation.
         *
         * @param paths Array of file paths to include in collection
         * @returns Promise resolving to a FileCollection
         *
         * @example
         * // Include multiple source files in documentation generation
         * await Document("provider-docs", {
         *   prompt: await alchemy`
         *     Generate comprehensive docs for these files:
         *     ${alchemy.files([
         *       "src/types.ts",
         *       "src/resource.ts",
         *       "src/provider.ts"
         *     ])}
         *   `
         * });
         */
        files(paths: string[]): Promise<FileCollection>;
        files(path: string, ...paths: string[]): Promise<FileCollection>;
        /**
         * Gets all of the files in a directory.
         * @param path Path to the directory
         * @param props Optional properties
         * @returns Promise resolving to a FileCollection
         *
         * @example
         * // Get all files in a directory
         * const files = await alchemy.folder("./docs");
         *
         */
        folder(path: string, props?: {
            /**
             * Whether to recursively get all files in the directory
             * @default false
             */
            recursive?: boolean;
        }): Promise<FileCollection>;
    }
}
/**
 * Base file resource type
 */
export interface File extends Resource<"fs::File"> {
    /**
     * Path to the file
     */
    path: string;
    /**
     * Content of the file
     */
    content: string;
}
/**
 * File Resource
 *
 * Creates and manages files in the filesystem with automatic directory creation
 * and proper cleanup on deletion.
 *
 * @example
 * // Create a simple text file
 * const config = await File("config.txt", {
 *   path: "config.txt",
 *   content: "some configuration data"
 * });
 *
 * @example
 * // Create a file in a nested directory
 * const log = await File("logs/app.log", {
 *   path: "logs/app.log",
 *   content: "application log entry"
 * });
 *
 * @example
 * // Update file content and path
 * let file = await File("config.json", {
 *   path: "config.json",
 *   content: '{ "version": "1.0.0" }'
 * });
 *
 * // Later, update the path and content (old file will be removed)
 * file = await File("config.json", {
 *   path: "config/config.json",
 *   content: '{ "version": "1.0.1" }'
 * });
 */
export declare const File: (((this: any, id: string, props?: {}) => never) & (new (_: never) => never)) | ((this: Context<File>, id: string, props: {
    path: string;
    content: string;
}) => Promise<File>);
//# sourceMappingURL=file.d.ts.map