import { parseMediaUri, tryParseMediaUri } from './uri.js';
import type { MediaBucket } from './types.js';
export type ResolvedMediaReference = {
    bucket: MediaBucket;
    id: string;
    uri: string;
    path: string;
};
/** Resolve a `media://` URI to an absolute filesystem path. */
export declare function resolveMediaReference(uri: string): Promise<ResolvedMediaReference>;
/** Read bytes for a media URI. */
export declare function readMediaReference(uri: string, maxBytes?: number): Promise<{
    buffer: Buffer;
    path: string;
    contentType?: string;
}>;
/** Load file as base64 for LLM boundaries. */
export declare function readMediaReferenceBase64(uri: string, maxBytes?: number): Promise<{
    data: string;
    mimeType: string;
    path: string;
}>;
export { tryParseMediaUri, parseMediaUri };