export declare const MAX_INLINE_PREVIEW_BYTES: number;
export type PreviewKind = "text" | "image" | "resource" | "unsupported";
export type PreviewReason = "metadata_only" | "included" | "file_too_large" | "unsupported_media_type";
export type PreviewReadFile = (path: string) => Promise<Buffer>;
export interface PreviewContentRequest {
    tool: "fc_preview_file";
    arguments: {
        path: string;
        include_content: true;
    };
}
export interface PreviewStructuredContent {
    [key: string]: unknown;
    path: string;
    uri: string;
    mime_type: string;
    size_bytes: number;
    preview_kind: PreviewKind;
    content_requested: boolean;
    content_included: boolean;
    max_inline_bytes: number;
    reason: PreviewReason;
    content_request: PreviewContentRequest | null;
}
export type PreviewContentBlock = {
    type: "text";
    text: string;
    annotations: {
        audience: Array<"user" | "assistant">;
        priority: number;
    };
} | {
    type: "image";
    data: string;
    mimeType: string;
    annotations: {
        audience: Array<"user" | "assistant">;
        priority: number;
    };
} | {
    type: "resource";
    resource: {
        uri: string;
        mimeType: string;
        blob: string;
    };
    annotations: {
        audience: Array<"user" | "assistant">;
        priority: number;
    };
};
export interface PreviewFileResult {
    structuredContent: PreviewStructuredContent;
    contentBlock?: PreviewContentBlock;
}
export interface PreviewFileOptions {
    includeContent?: boolean;
    readFile?: PreviewReadFile;
}
export type PreviewFileErrorCode = "PATH_NOT_FOUND" | "NOT_A_FILE" | "READ_FAILED";
export declare class PreviewFileError extends Error {
    readonly code: PreviewFileErrorCode;
    readonly targetPath: string;
    constructor(code: PreviewFileErrorCode, message: string, targetPath: string);
}
export declare function previewFile(targetPath: string, options?: PreviewFileOptions): Promise<PreviewFileResult>;
//# sourceMappingURL=preview-file.d.ts.map