Search for books matching a metadata query. If query is not provided, lists all books. Supports pagination by the limit and offset parameters: limit determines how many results to show (default 50), offset sets the starting point for the results (default 0). fields: Optional list of metadata fields to return (e.g. ["title", "rating", "#genre"]). Returns all if not provided. text_field_limit: Optional max length for text fields in the returned metadata.

Get detailed metadata for a book. fields: an optional list of metadata fields to return (e.g. ["title", "rating", "#genre"]). If not provided, returns all fields.

Retrieve text content of a book. limit: Maximum number of characters to return (default 30,000). offset: Character offset to start reading from. sentence_aware: If True, adjusts the limit to the nearest sentence boundary.

Search for text within a book. Returns a list of hits with text snippets. hit_limit: Max number of hits to return (default 10). offset: Offset for pagination of hits.

Full-Text Search for a string. Returns a list of hits that include a book_id and a short snippet of text containing an example of the search string's use in that book.

Get the schema of the library, including standard and custom columns. Useful for understanding available metadata fields for search and update.

Get unique values and their counts for a specific metadata field. Useful for building facets (e.g. list of all tags or authors). field_name: The name of the field. book_ids: Optional list of book IDs to restrict the search to. value_filter: Optional regex to filter values. limit: Max number of values to return (default 50). offset: Offset for pagination.