import { APIResource } from "../core/resource.js";
import { APIPromise } from "../core/api-promise.js";
import { CursorPage, type CursorPageParams, PagePromise } from "../core/pagination.js";
import { RequestOptions } from "../internal/request-options.js";
export declare class Documents extends APIResource {
    /**
     * Create a new knowledge document. Documents can be attached to avatars to provide
     * additional context during conversations.
     *
     * @example
     * ```ts
     * const document = await client.documents.create({
     *   content:
     *     '# Product FAQ\n\n## What is your return policy?\n\nWe offer a 30-day return policy...',
     *   name: 'Product FAQ',
     * });
     * ```
     */
    create(body: DocumentCreateParams, options?: RequestOptions): APIPromise<DocumentCreateResponse>;
    /**
     * Get details of a specific knowledge document.
     *
     * @example
     * ```ts
     * const document = await client.documents.retrieve(
     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
     * );
     * ```
     */
    retrieve(id: string, options?: RequestOptions): APIPromise<DocumentRetrieveResponse>;
    /**
     * Update a knowledge document. At least one of `name` or `content` must be
     * provided.
     *
     * @example
     * ```ts
     * await client.documents.update(
     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
     * );
     * ```
     */
    update(id: string, body?: DocumentUpdateParams | null | undefined, options?: RequestOptions): APIPromise<void>;
    /**
     * List knowledge documents for the authenticated user with cursor-based
     * pagination.
     *
     * @example
     * ```ts
     * // Automatically fetches more pages as needed.
     * for await (const documentListResponse of client.documents.list(
     *   {
     *     limit: 1,
     *     order: 'asc',
     *     sort: 'createdAt',
     *   },
     * )) {
     *   // ...
     * }
     * ```
     */
    list(query: DocumentListParams, options?: RequestOptions): PagePromise<DocumentListResponsesCursorPage, DocumentListResponse>;
    /**
     * Delete a knowledge document. This also removes it from all avatars it was
     * attached to.
     *
     * @example
     * ```ts
     * await client.documents.delete(
     *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
     * );
     * ```
     */
    delete(id: string, options?: RequestOptions): APIPromise<void>;
}
export type DocumentListResponsesCursorPage = CursorPage<DocumentListResponse>;
export interface DocumentCreateResponse {
    /**
     * The unique identifier of the document.
     */
    id: string;
    /**
     * The full content of the document.
     */
    content: string;
    /**
     * When the document was created.
     */
    createdAt: string;
    /**
     * The name of the document.
     */
    name: string;
    /**
     * The type of document.
     */
    type: 'text' | 'file';
    /**
     * When the document was last updated.
     */
    updatedAt: string;
    /**
     * Avatars that use this document. Always empty for newly created documents.
     */
    usedBy: Array<DocumentCreateResponse.UsedBy>;
}
export declare namespace DocumentCreateResponse {
    interface UsedBy {
        /**
         * The avatar ID.
         */
        id: string;
        /**
         * URL to the avatar image, or null if not yet processed.
         */
        imageUrl: string | null;
        /**
         * The avatar name.
         */
        name: string;
    }
}
export interface DocumentRetrieveResponse {
    /**
     * The unique identifier of the document.
     */
    id: string;
    /**
     * The full content of the document.
     */
    content: string;
    /**
     * When the document was created.
     */
    createdAt: string;
    /**
     * The name of the document.
     */
    name: string;
    /**
     * The type of document.
     */
    type: 'text' | 'file';
    /**
     * When the document was last updated.
     */
    updatedAt: string;
    /**
     * Avatars that use this document.
     */
    usedBy: Array<DocumentRetrieveResponse.UsedBy>;
}
export declare namespace DocumentRetrieveResponse {
    interface UsedBy {
        /**
         * The avatar ID.
         */
        id: string;
        /**
         * URL to the avatar image, or null if not yet processed.
         */
        imageUrl: string | null;
        /**
         * The avatar name.
         */
        name: string;
    }
}
export interface DocumentListResponse {
    /**
     * The unique identifier of the document.
     */
    id: string;
    /**
     * When the document was created.
     */
    createdAt: string;
    /**
     * The name of the document.
     */
    name: string;
    /**
     * The type of document.
     */
    type: 'text' | 'file';
    /**
     * When the document was last updated.
     */
    updatedAt: string;
    /**
     * Avatars that use this document.
     */
    usedBy: Array<DocumentListResponse.UsedBy>;
}
export declare namespace DocumentListResponse {
    interface UsedBy {
        /**
         * The avatar ID.
         */
        id: string;
        /**
         * URL to the avatar image, or null if not yet processed.
         */
        imageUrl: string | null;
        /**
         * The avatar name.
         */
        name: string;
    }
}
export interface DocumentCreateParams {
    /**
     * The markdown or plain text content of the document.
     */
    content: string;
    /**
     * A descriptive name for the document.
     */
    name: string;
}
export interface DocumentUpdateParams {
    /**
     * New markdown or plain text content for the document.
     */
    content?: string;
    /**
     * A new name for the document.
     */
    name?: string;
}
export interface DocumentListParams extends CursorPageParams {
    /**
     * Sort direction.
     */
    order: 'asc' | 'desc';
    /**
     * Field to sort results by.
     */
    sort: 'createdAt' | 'updatedAt';
}
export declare namespace Documents {
    export { type DocumentCreateResponse as DocumentCreateResponse, type DocumentRetrieveResponse as DocumentRetrieveResponse, type DocumentListResponse as DocumentListResponse, type DocumentListResponsesCursorPage as DocumentListResponsesCursorPage, type DocumentCreateParams as DocumentCreateParams, type DocumentUpdateParams as DocumentUpdateParams, type DocumentListParams as DocumentListParams, };
}
//# sourceMappingURL=documents.d.ts.map