Lochless

Answer a question from your own documents (your knowledge base), citing its sources. Reads every matching document across all dates unless from/to narrow it. Returns a short written answer that cites its sources as [1], [2], and the evidence: each cited quote with its document id, metadata and score. Use `search_documents` instead when you want every match rather than an answer. Takes the same from, to, metadata, dry_run and read_limit_usd as `search_documents`; the limit includes the answer fee, and mode (fast reads only the best-matching results; complete reads every match; by default the question decides). coverage says how the answer read and how many documents.

ask_documents

List your own documents (your knowledge base) by date, newest first unless order=asc. No query needed. Each result has its document id, connection id, title, date, metadata and the start of its text. Narrow with from/to (the document's timestamp) and metadata (exact match; a list = any of). Returns results, total_results and next_cursor: pass it back as cursor for the next page. Free: browsing never spends your balance.

browse_documents

Read one whole document from your own documents (your knowledge base), by the document_id and connection_id of a search or browse result. Returns its full text, title, date and metadata. A long document comes in parts: when the result has next_content_offset, call again with content_offset set to it. Free: reading never spends your balance.

read_document

Search your own documents (your knowledge base) and get every match, not just the top few: a quote from each matching document, with its document id, connection id and date. Returns results, total_results (across all pages), tokens_scanned and next_cursor: pass it back as cursor, with the same query, for the next page. Next pages are free. Narrow with from/to (the document's timestamp) and metadata (exact match; a list = any of). dry_run=true returns documents_matched, tokens_to_scan and the price without searching, for free. read_limit_usd caps what one call may spend: over it, the best-matching documents are read first, and coverage says how many were read of all that match. When coverage.complete is false, pass continue_cursor back to read the next ones. A lookup (one fact or answer) reads only the best-matching results, quicker and cheaper; coverage.mode says fast. Set mode=complete to read every match, or mode=fast for a lookup.

search_documents