/** Browser/Host protocol for durable dragged-document references. */
export declare const DOCUMENT_REFERENCE_SOURCE = "croco-document";
export declare const DOCUMENT_EXTENSIONS: readonly [".txt", ".md", ".json", ".pdf"];
export type DocumentExtension = typeof DOCUMENT_EXTENSIONS[number];
/** One staged Workspace document retained on a user message's source metadata. */
export interface DocumentDescriptor {
    readonly id: string;
    readonly name: string;
    readonly extension: DocumentExtension;
    readonly size: number;
    readonly path: string;
    readonly readerTool: string;
}
/** Direct-user source extended with durable document presentation metadata. */
export interface DocumentUserSource {
    readonly kind: "user";
    readonly crocoDocuments: readonly DocumentDescriptor[];
}
/** Resolve the code-dispatch child tool for a supported document type. */
export declare function documentReaderTool(extension: DocumentExtension): string;
/** Serialize one staged batch as a plain opaque UUID marker. */
export declare function serializeDocumentReference(batchId: string): string;
/** Remove every submitted opaque document id from one text block. */
export declare function consumeDocumentReferences(text: string): {
    text: string;
    batchIds: string[];
};
/** Validate durable attachment metadata read from the session wire format. */
export declare function documentDescriptorsFromSource(source: unknown): readonly DocumentDescriptor[] | null;