Add a PDF to the library, or confirm it is already there. Extraction runs in the background and returns a job id immediately; poll document_status until status is 'complete'. A file whose content hash is already known is an instant cache hit and is never reprocessed, so there is no cost to calling this, but also no reason to call it twice.

Full-text search across every processed document. This is the entry point for any question about library content: it returns headings, page numbers and short snippets, never full text. Follow up with get_pages or get_chunk for the passages that look right. Accent-insensitive and works for Greek and English.

Return the Markdown of specific pages of one document, with LaTeX preserved. Ask for the few pages a search pointed at, plus a neighbouring page if context is missing. Requesting a wide range is how you flood your own context; the reply is truncated at the configured token budget.

Return one chunk in full, by the id shown in search results. This is the cheapest way to read a single theorem, proof or definition.

Return every chunk filed under one heading of a document, joined in order. Use when you know the section name; otherwise search first.

Show the original scanned page, or one region of it, as an image. This is the expensive tool and the last resort: an image costs several times what the same page's text costs, and it stays in context for the rest of the conversation. Use it only when the extracted text is evidently corrupted — nonsense words in a formula, an equation that does not parse — and always pass a block number if you can, since cropping to one equation is both cheaper and sharper than the whole page. get_pages lists the block numbers for OCR'd pages.

List every document in the library with its id, page count and processing state. Metadata only, no content.

Processing state and quality report for one document: whether it is complete, which pages are scanned or low quality, how many equations were found, and which pages would benefit from re-extraction. Poll this after import_pdf.

Re-extract selected pages of a document with the high-quality engine (Marker), which produces real LaTeX for equations. Slow and optional: use it for the specific pages whose math came out badly, never for a whole book. Runs as a background job.