bdambrosio doc-read
For papers that arrive as a file rather than a URL. A portal that 403s a fetch does not stop the user downloading the PDF themselves, and until this existed that ended the line: the text was on the disk and there was no way to read it.
Same shape as fetch-text on a paper. Call it once with just path to
get the title, abstract and section index; call it again naming a section
to read that section in full. Read the index before deciding what to
read — a survey can run to a hundred pages and the section names tell you
which five you actually want.
When it earns its keep
- The user says "I downloaded it" or gives you a path.
- A fetch was blocked and the user saved the file instead.
- Re-reading one section of something long without pulling all of it.
What it will not do
Only paths under the user's Downloads folder and this repository can be read — it is a document reader, not a way to read arbitrary files on the machine, and a request for anything outside those roots comes back as an error rather than silently.
PDFs only. Anything else says so plainly.
Reading it honestly
The index comes from the document itself, so the title it reports is the document's own — not what a search result said the document probably is. If that title is not what you expected from the user's description, say so before reviewing it. Reviewing a paper the user did not ask about, accurately, is still the wrong answer.
Then act on the mismatch, because noticing it is not concluding anything. The document in front of you is the authority on what it is. A title you remember, or that a search called the closest match, is a guess about it and never evidence — so when the two disagree, the remembered one is what gives way. Do not go looking inside this document for the paper you expected; say plainly that this is a different document and ask, rather than reviewing the one you have as though it were the one you wanted.
Examples
{"thought": "get the structure before choosing what to read", "tool": "doc-read", "path": "53157_Diving_into_Reliable_Sel.pdf"}
{"thought": "the taxonomy is the part that matters here", "tool": "doc-read", "path": "53157_Diving_into_Reliable_Sel.pdf", "section": "Introduction"}