Skip to main content

DESCRIPTION

Constant DESCRIPTION 

Source
const DESCRIPTION: &str = "\
Hand the reader a document from this session's working tree, or from one of \
the project's document roots, opened in their own viewer. This tool is for \
documents - Markdown, PDF, plain text; a visual artifact - an HTML mockup, \
a PNG - goes to the browser instead: navigate to it and hand off that tab \
with `browser_hand_off`, never this tool. Use it when a \
document is the thing the reader should see - a plan, a report, a spec - \
rather than part of the conversation; a document the reader is meant to \
review goes here with `reviewable: true`, never as a path or link in \
chat. `path` is relative to the working directory, or absolute under \
one of the project's `document_roots` in `forge.toml`. Set `reviewable` \
when you want review comments back: the reader opens it, comments on \
lines and answers, and their review then arrives filed under the \
document's own scope. A PDF always opens read-only. **The answer is \
approve or send feedback**: feedback means revise the document, hand it \
off again, and keep handing it off until the reader approves; approval \
is the one signal to proceed, and neither may be read as the other; the \
one feedback box reaches you with either \
answer, though approve may leave it empty and send feedback may not. \
The reader is asked to open it or not, and **this call waits for them**: \
it answers when they approve, send feedback or say not now.";
Expand description

What the model reads about the tool before calling it: what it hands over, when reviewable earns its place, and which moment this answers.