import { DocumentBlock, ImageBlock, TextBlock, VideoBlock, type ContentBlock } from "@strands-agents/sdk";
export type AttachmentBinaryFallback = {
    path: string;
    encoding: "base64";
    content: string;
    sizeBytes: number;
};
export type AttachmentMediaBlocks = Array<TextBlock | ImageBlock | VideoBlock | DocumentBlock>;
export type AttachmentReadResult = AttachmentMediaBlocks | AttachmentBinaryFallback;
type AttachmentReadOptions = {
    maxBytes?: number;
    includeMetadata?: boolean;
    unsupportedFormat?: "diagnostic" | "base64";
    onError?: "throw" | "diagnostic";
    diagnosticKind?: string;
};
export declare function normalizeAttachmentPaths(input: unknown): string[];
export declare function attachmentDiagnosticBlock(path: string, reason: string, extra?: Record<string, unknown>, kind?: string): TextBlock;
export declare function readAttachmentAsBlocksOrBase64(filePath: string, options?: AttachmentReadOptions): Promise<AttachmentReadResult>;
export declare function attachmentPathsToPromptBlocks(paths: readonly string[], options?: Omit<AttachmentReadOptions, "unsupportedFormat" | "onError"> & {
    maxBytes?: number;
}): Promise<ContentBlock[]>;
export {};