import type { JSONSerializable, Serialized } from './json.js';
/**
 * Citation types for document citation content blocks.
 *
 * Citations are returned by models when document citations are enabled.
 * They are output-only blocks that appear in conversation history.
 */
/**
 * Discriminated union of citation location types.
 * Each variant uses a `type` field to identify the location kind.
 */
export type CitationLocation = {
    /**
     * Location referencing character positions within a document.
     */
    type: 'documentChar';
    /**
     * Index of the source document.
     */
    documentIndex: number;
    /**
     * Start character position.
     */
    start: number;
    /**
     * End character position.
     */
    end: number;
} | {
    /**
     * Location referencing page positions within a document.
     */
    type: 'documentPage';
    /**
     * Index of the source document.
     */
    documentIndex: number;
    /**
     * Start page number.
     */
    start: number;
    /**
     * End page number.
     */
    end: number;
} | {
    /**
     * Location referencing chunk positions within a document.
     */
    type: 'documentChunk';
    /**
     * Index of the source document.
     */
    documentIndex: number;
    /**
     * Start chunk index.
     */
    start: number;
    /**
     * End chunk index.
     */
    end: number;
} | {
    /**
     * Location referencing a search result.
     */
    type: 'searchResult';
    /**
     * Index of the search result.
     */
    searchResultIndex: number;
    /**
     * Start position within the search result.
     */
    start: number;
    /**
     * End position within the search result.
     */
    end: number;
} | {
    /**
     * Location referencing a web URL.
     */
    type: 'web';
    /**
     * The URL of the web source.
     */
    url: string;
    /**
     * The domain of the web source.
     */
    domain?: string;
};
/**
 * Source content referenced by a citation.
 * Modeled as a union type for future extensibility.
 */
export type CitationSourceContent = {
    text: string;
};
/**
 * Generated content associated with a citation.
 * Modeled as a union type for future extensibility.
 */
export type CitationGeneratedContent = {
    text: string;
};
/**
 * A single citation linking generated content to a source location.
 */
export interface Citation {
    /**
     * The location of the cited source.
     */
    location: CitationLocation;
    /**
     * The source identifier string.
     */
    source: string;
    /**
     * The source content referenced by this citation.
     */
    sourceContent: CitationSourceContent[];
    /**
     * Title of the cited source.
     */
    title: string;
}
/**
 * Data for a citations content block.
 */
export interface CitationsBlockData {
    /**
     * Array of citations linking generated content to source locations.
     */
    citations: Citation[];
    /**
     * The generated content associated with these citations.
     */
    content: CitationGeneratedContent[];
}
/**
 * Citations content block within a message.
 * Returned by models when document citations are enabled.
 * This is an output-only block — users do not construct these directly.
 */
export declare class CitationsBlock implements CitationsBlockData, JSONSerializable<{
    citations: Serialized<CitationsBlockData>;
}> {
    /**
     * Discriminator for citations content.
     */
    readonly type: "citationsBlock";
    /**
     * Array of citations linking generated content to source locations.
     */
    readonly citations: Citation[];
    /**
     * The generated content associated with these citations.
     */
    readonly content: CitationGeneratedContent[];
    constructor(data: CitationsBlockData);
    /**
     * Serializes the CitationsBlock to a JSON-compatible ContentBlockData object.
     * Called automatically by JSON.stringify().
     */
    toJSON(): {
        citations: Serialized<CitationsBlockData>;
    };
    /**
     * Creates a CitationsBlock instance from its wrapped data format.
     *
     * @param data - Wrapped CitationsBlockData to deserialize
     * @returns CitationsBlock instance
     */
    static fromJSON(data: {
        citations: Serialized<CitationsBlockData>;
    }): CitationsBlock;
}
//# sourceMappingURL=citations.d.ts.map